> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags na audiência

> Etiquetas reutilizáveis para marcar contatos: Lead, VIP, Cliente — e usar em segmentos e campanhas.

<Tip>
  **Tag** = **etiqueta** colada na ficha do contato. **Não** é tópico (consentimento) nem segmento (filtro). **Tag** marca; **segmento** combina tags com outras regras.
</Tip>

## O que é uma tag?

É um **rótulo reutilizável** no workspace, ex.: `Lead`, `VIP`, `Cliente`, `Black Friday`. Você cria uma vez e aplica em quantos contatos quiser.

Analogia: pense numa **etiqueta colorida** na pasta do cliente. A tag não muda quem a pessoa é — só ajuda você a **achar e agrupar** depois.

## Tag × tópico × segmento

|              | **Tag**                       | **Tópico**                        | **Segmento**                             |
| ------------ | ----------------------------- | --------------------------------- | ---------------------------------------- |
| Para quê     | **Marcar** manualmente        | **Consentimento** por tema        | **Filtro salvo** (quem entra no público) |
| Exemplo      | `VIP`, `Lead quente`          | “Aceita Newsletter”               | “Tag VIP + aceita marketing”             |
| Onde aparece | Ficha do contato, importação  | Template MARKETING + preferências | Audiência de campanha                    |
| Na API       | `tags:*`, `tagIds` no contato | `topics:*`, regra `topic`         | `segments:*`, regra `type: tag`          |

## Quando usar?

Funciona muito bem para **classificar leads**, **marcar clientes ativos**, **separar origem** (`Site`, `Loja`) ou **sinalizar status interno** (`Aguardando retorno`). Para **opt-in legal de marketing por tema**, use [tópicos](/contacts-api/como-funciona/topicos-de-comunicacao).

## Como funciona na prática

1. **Audience → Tags → New**, escolha um nome curto e claro (`VIP`, `Lead`)
2. Na **ficha do contato** ou na importação, associe uma ou mais tags
3. Monte um **segmento** com regra `type: tag` para filtrar quem tem aquela etiqueta
4. Use o segmento como **audiência** de uma campanha

<Note>
  Uma tag **não bloqueia envio** sozinha. Quem tem tag `VIP` ainda precisa passar pelas regras de marketing e supressões na hora do disparo.
</Note>

## Tags em segmentos

Exemplo: contatos com tag VIP que aceitam marketing:

```json theme={null}
{
  "version": 1,
  "match": "all",
  "rules": [
    { "type": "tag", "tagId": "SEU_UUID_TAG_VIP" },
    { "type": "receiveMarketing", "value": true }
  ]
}
```

Combine com `property`, `contactField` ou `topic` — veja [Segmentos na audiência](/contacts-api/como-funciona/segmentos-na-audiencia).

## Na API

Escopos `tags:read`, `tags:create`, `tags:update`, `tags:delete`. Rotas no grupo **Tags** da referência da API.

No contato, envie `tagIds` no create/patch ou use a rota de tags do workspace.

## Erros frequentes

* Confundir **tag** com **tópico** — tag é etiqueta interna; tópico é consentimento por assunto
* Esperar que tag substitua **supressão** — quem pediu para não ser contatado continua na [lista de supressões](/suppressions-api/como-funciona/introducao)
* `tagId` de outro workspace no segmento → erro na validação

## Próximos passos

* [Quick Start — Tags](/contacts-api/como-funciona/tags-quick-start)
* [Segmentos na audiência](/contacts-api/como-funciona/segmentos-na-audiencia): montar públicos com regra `tag`
* [Tópicos de comunicação](/contacts-api/como-funciona/topicos-de-comunicacao): consentimento por tema
* [Campanhas no painel](/contacts-api/como-funciona/campanhas-no-painel): disparo em lote
* [Introdução](/contacts-api/como-funciona/introducao): mapa dos conceitos