Tópicos de comunicação: como funcionam e o link pessoal de preferências

Tópicos de comunicação são categorias de marketing dentro do workspace: em vez de um único “liga/desliga” genérico, você separa assuntos—por exemplo Newsletter, Promoções, Novidades do produto. Cada contato pode estar inscrito ou não em cada tópico, além do controle geral de marketing do cadastro.

Isso complementa o campo amplo “aceita marketing” (receiveMarketing). Na prática: o contato precisa aceitar marketing em geral e, quando o template de marketing está vinculado a um tópico, também precisa estar inscrito naquele tópico (ou cair no padrão do workspace se ainda não houver escolha explícita). Transacionais não passam por essa lógica de tópico da mesma forma.

No painel, em Audience & campaigns → Topics, você cria cada tópico com nome, slug estável, descrição opcional e se novos contatos entram já optados naquele tema (default opt-in) ou não. Slug e nome claros ajudam time e suporte a não misturar campanhas.

O melhor uso é combinar poucos tópicos bem nomeados com templates de marketing associados ao tópico certo. Assim, quem desmarca só “Promoções” continua recebendo “Newsletter”, se fizer sentido para o seu negócio. Evite dezenas de tópicos microscópicos que ninguém entende na página pública.

O contato não precisa logar no seu sistema para atualizar preferências. Existe uma página pública por link, assinada com um token de uso limitado. O formato segue a URL base da API do workspace:

https://SUA-API/w/contact-preferences/ID_DO_CONTATO?token=TOKEN

O ID do contato aparece na ficha dele no painel. O token é gerado sob demanda: na tela de detalhes do contato você pode copiar o link completo (o painel chama a API e cola na área de transferência). Tokens costumam valer cerca de 90 dias; depois é preciso gerar outro link.

Em envios em lote ou integrações que montam variáveis por destinatário, use a variável de mesclagem preferences_link quando disponível: o sistema preenche com a URL já tokenizada para aquele contato, ideal para rodapé de e-mail (“gerenciar preferências” ou “cancelar inscrição” de forma mais rica que um STOP único). No editor de template de e-mail também há opção para acrescentar o bloco de link de preferências.

Ao abrir o link, a pessoa vê uma página simples com a marca do workspace, o opt-in geral de marketing e uma caixa para cada tópico configurado. Ao salvar, as assinaturas por tópico e o marketing geral são atualizados. Se o token estiver inválido ou expirado, a página recusa o acesso—por isso guarde fluxos para reenviar um link novo pelo suporte ou por uma mensagem transacional.

Boas práticas: documentar internamente quais templates usam qual tópico; revisar default opt-in ao criar tópico sensível; incluir o link de preferências em campanhas recorrentes; testar com um contato de staging antes de disparar para a base. Assim você reduz reclamação de “não pedi isso” e fica alinhado a uma operação de marketing mais transparente.

Em resumo: tópicos segmentam consentimento por tema, o painel centraliza criação e o link pessoal com token leva o usuário à página onde ele ajusta marketing geral e cada tópico—sem senha, com expiração controlada e integração natural nos envios.