Tópico = assunto que a pessoa aceita receber. Não é tag (etiqueta) nem segmento (filtro). Tag marca; tópico registra consentimento por tema.
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
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
- Audience → Topics → New, nome, slug estável, descrição, opt-in padrão para novos contatos
- No template de marketing, associe o tópico correto
- No envio ou campanha, o sistema checa: marketing geral e inscrição no tópico
- Gere o link de preferências na ficha do contato (token ~90 dias)
- No e-mail, use
{{preferences_link}}, URL pronta por destinatário
- Templates MARKETING também enviam headers RFC 8058 (one-click). Veja One-click unsubscribe
Slug estável: depois que campanhas dependem dele, evite renomear.
- 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
