# Adicionar Tags

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/adicionar-tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.