Tópicos

Tópicos são categorias de inscrição — "Novidades do produto", "Newsletter", "Promoções" — que dão aos destinatários um controle mais fino do que um único descadastro global.

Cada tópico tem um default_subscription de opt_in ou opt_out, fixado na criação:

• opt_in — todo contato está inscrito, a menos que opte por sair.
• opt_out — contatos só são incluídos depois de optarem explicitamente por entrar.

Como os tópicos se aplicam

• Broadcasts podem mirar um tópico. O fan-out inclui apenas contatos cuja inscrição efetiva naquele tópico é "inscrito" (a escolha explícita deles, se houver; o padrão do tópico caso contrário), e sempre exclui contatos descadastrados globalmente.
• A página de descadastro hospedada lista os tópicos públicos do time, então um destinatário pode sair de uma categoria e continuar inscrito nas outras — ou sair de todo e-mail de marketing. Envios transacionais sem topic_id não são afetados por nenhuma das duas escolhas. A página fala catorze idiomas, escolhido pelo navegador do destinatário (Accept-Language), inglês quando nenhum corresponde; Configurações → Página de descadastro pré-visualiza cada um.

API

POST/GET/DELETE /topics e GET /topics/{id} gerenciam tópicos; as escolhas de um contato são gravadas com PATCH /contacts/{id}/topics, passando um array puro de entradas como { "id": "<topic-id>", "subscription": "opt_in" }, e lidas de volta com GET /contacts/{id}/topics, que lista cada tópico com a subscription efetiva do contato e um campo explicit (false quando é o padrão do tópico). Um envio com topic_id em que todos os destinatários de to optaram por sair é recusado com 422 all_recipients_suppressed. Veja a referência da API.