> ## 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.

# Tópicos de comunicação

> Consentimento por tema: Newsletter, Promoções e link para a pessoa escolher o que quer receber.

<Tip>
  **Tópico** = **assunto** que a pessoa aceita receber. **Não** é tag (etiqueta) nem segmento (filtro). **Tag** marca; **tópico** registra consentimento por tema.
</Tip>

## O que é um tópico?

É um **tema de marketing** no workspace, ex.: **Newsletter**, **Promoções**, **Lançamentos**. A pessoa pode aceitar um e recusar outro.

Analogia: opt-in geral pergunta “posso mandar marketing?”. **Tópico** pergunta **qual vitrine** interessa. Quem cancela só Promoções pode continuar na Newsletter.

## Tópico × tag × segmento

|                   | **Tópico**                                  | **Tag**                       | **Segmento**                             |
| ----------------- | ------------------------------------------- | ----------------------------- | ---------------------------------------- |
| Para quê          | Consentimento por **tema**                  | **Etiqueta** manual na ficha  | **Filtro salvo** (quem entra no público) |
| Exemplo           | “Aceita Newsletter”                         | `VIP`, `Lead`                 | “Tag VIP + inscrito em Promoções”        |
| Usado em campanha | Template **MARKETING** com tópico vinculado | Regra `type: tag` no segmento | Audiência da campanha                    |

## Quando usar?

Funciona muito bem para **vários tipos de conteúdo de marketing** e templates de categoria **MARKETING**. Mensagens **transacionais** (pedido, senha) **não** dependem de tópico da mesma forma.

## Como funciona na prática

1. **Audience → Topics → New**, nome, **slug** estável, descrição, opt-in padrão para novos contatos
2. No **template de marketing**, associe o **tópico** correto
3. No envio ou campanha, o sistema checa: marketing geral **e** inscrição no tópico
4. Gere o **link de preferências** na ficha do contato (token \~90 dias)
5. No e-mail, use **`{{preferences_link}}`**, URL pronta por destinatário
6. Templates **MARKETING** também enviam headers **RFC 8058** (one-click). Veja [One-click unsubscribe](/emails-api/como-funciona/one-click-unsubscribe-rfc-8058)

<Warning>
  **Slug** estável: depois que campanhas dependem dele, evite renomear.
</Warning>

## Relação com `receiveMarketing`

* Em geral o contato precisa **aceitar marketing** no cadastro (`receiveMarketing: true`)
* Template de marketing **com tópico** exige inscrição naquele tema (ou padrão do workspace)
* Quem não passa **não entra** na fila da campanha, sem erro por pessoa

## Na API

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

## Próximos passos

* [Segmentos na audiência](/contacts-api/como-funciona/segmentos-na-audiencia): montar públicos com regra `topic`
* [Campanhas no painel](/contacts-api/como-funciona/campanhas-no-painel): disparo em lote
* [Introdução](/contacts-api/como-funciona/introducao): mapa dos conceitos
* [Escopos](/contacts-api/como-funciona/escopos-da-api-key)