One-click unsubscribe (RFC 8058)

​

Por que usar?

​

Quando usar

• Template MARKETING (e campanhas/automações com ele) → headers RFC 8058 por padrão
• POST /v1/email/messages com contato resolvido pelo e-mail → por padrão
• E-mail transacional (recibo, OTP, reset de senha) → use listUnsubscribe: false
• Destinatário sem contato no workspace → headers não são injetados (não há token)

​

Como funciona na prática

1. No envio, a Notifique gera um token (mesmo tipo do {{preferences_link}}) e grava nos headers MIME:
   • List-Unsubscribe: <https://…/w/list-unsubscribe/:contactId?token=…>
   • List-Unsubscribe-Post: List-Unsubscribe=One-Click
2. Gmail/Yahoo fazem POST nesse URL com corpo List-Unsubscribe=One-Click (sem cookies, sem login), o opt-out acontece só no POST.
3. GET no mesmo URL só valida o token e mostra uma página de confirmação (não altera preferências, evita scanners/prefetch).
4. No POST, a Notifique descadastra na hora:
   • com topic na URL (template com tópico) → tópico UNSUBSCRIBED (tópico inválido → erro, sem fallback global)
   • sem tópico → receiveMarketing = false
5. A página de sucesso pode linkar o preference center para reativar.

​

API direta (POST /v1/email/messages)

{
  "from": "marketing@seudominio.com",
  "to": ["cliente@example.com"],
  "subject": "Novidades da semana",
  "html": "<p>Olá!</p>",
  "listUnsubscribe": true,
  "listUnsubscribeTopicId": "cltopic..."
}

{
  "listUnsubscribe": false
}

​

Próximos passos

• Tópicos de comunicação
• Quick Start de e-mail
• Variáveis de template