Adicionar Tags

Com essa operação, a automação pode atribuir tags ao registro de uma pessoa, ajudando a classificar contatos e criar segmentações estratégicas.

A operação Adicionar Tags permite aplicar uma ou mais etiquetas (tags) a um registro de pessoa. As tags são marcadores flexíveis que ajudam a categorizar, segmentar e filtrar seus contatos com base em interesses, comportamentos, origem ou qualquer outro critério personalizado.

Esta ação é extremamente útil para enriquecer o perfil de um contato de forma dinâmica. Por exemplo, você pode adicionar uma tag "Interesse-Produto-X" quando um lead visita uma página específica, ou "Cliente-Satisfeito" após uma avaliação positiva.

A operação adiciona as novas tags à lista de tags da pessoa, mantendo as que já existiam.

Como Configurar

1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação.

2. No campo "Operação", selecione a opção "Adicionar Tags".

3. No campo "ID da Pessoa" (personId), insira o identificador do contato que receberá as tags.

4. No campo "Tags", selecione ou insira as tags que deseja aplicar.

Parâmetros

Campo	Tipo	Obrigatório?	Descrição
ID da Pessoa	Texto	✅ Sim	O ID único da pessoa (contato) que será tagueada.
Tags	Lista de Tags	✅ Sim	Uma ou mais tags a serem adicionadas ao contato.

Estrutura (Usando JSON)

O corpo da requisição JSON deve conter um array chamado tags com o(s) ID(s) ou nome(s) da(s) tag(s) a ser(em) adicionada(s).

JSON

{
  "tags": [
    "tag_id_ou_nome_1",
    "tag_id_ou_nome_2"
  ]
}

---

🚀 Exemplo de Caso de Uso

Objetivo: Quando um lead baixa um e-book sobre "Marketing Digital", adicionar a tag "Interesse-Marketing" ao seu perfil.

1. Crie um fluxo que começa com um gatilho de Webhook que recebe os dados do formulário de download do e-book (incluindo o e-mail do lead).

2. Use a operação "Buscar Pessoa por E-mail" para encontrar o personId do lead.

3. Se a pessoa for encontrada, adicione o bloco "Pessoas" com a operação "Adicionar Tags".

4. No campo "ID da Pessoa", insira a variável do ID encontrado no passo anterior ({{steps.2.result.id}}).

5. No campo "Tags", selecione a tag "Interesse-Marketing".

Com esta automação, você segmenta seus contatos com base nos seus interesses de forma automática, permitindo o envio de campanhas de nutrição futuras muito mais direcionadas e eficazes.