O cancelamento de subscrição

Uma mensagem de marketing tem de trazer uma forma de cancelar a subscrição, e não basta o link no rodapé.

Os dois cabeçalhos

Escrevemo-los a partir do unsubscribe_url que envias:

List-Unsubscribe: <https://aempresa.pt/cancelar/abc123>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

O primeiro diz ao cliente de email onde fica o cancelamento. O segundo diz que basta um pedido POST para o executar, sem ecrãs pelo meio.

É isso que põe o botão Cancelar subscrição ao lado do remetente no Gmail e no Outlook, antes de a pessoa abrir a mensagem. Desde Fevereiro de 2024 que ambos exigem os dois cabeçalhos a quem envia volume, e uma lista sem eles vê a taxa de entrega cair sem nenhuma mensagem de erro.

O que o teu endpoint tem de fazer

Receber um POST sem corpo útil no URL que indicaste, e cancelar a subscrição da pessoa a quem esse URL pertence.

• O URL tem de identificar a pessoa por si só. Um token opaco por destinatário é o caminho; um link igual para todos não cancela nada.
• Não peças confirmação. O cabeçalho promete um clique, e um ecrã de "tens a certeza?" faz com que o cliente de email reporte a operação como falhada.
• Responde 200 depressa. O que fizeres a seguir é contigo.
• Aceita também GET no mesmo URL, para quem clicar no link do rodapé.

Porque recusamos em vez de corrigir

Uma mensagem de marketing sem unsubscribe_url é recusada com 422 e não sai.

Podíamos gerar um link nosso, e não geramos. O cancelamento tem de acontecer na tua base de dados: se o registássemos só do nosso lado, a pessoa continuaria na tua lista, receberia a campanha seguinte na mesma, e nem tu nem ela perceberiam porquê.

O que fazemos é o passo a seguir: quando alguém cancela, e o evento chega pelo feedback do destinatário, o endereço entra na lista de supressões desta conta e deixa de ser contactado por aqui, mesmo que continue na tua lista por engano.

E o rodapé?

Continua a valer a pena. O botão no topo é o que o cliente de email mostra; o link no rodapé é o que a pessoa procura quando já abriu a mensagem. Podes usar o mesmo URL nos dois.

Transaccional não leva nada disto

Um recibo não tem cancelamento de subscrição, e não deve ter. A pessoa não se subscreveu de nada: comprou, e o recibo faz parte da compra. Pôr lá um botão de cancelar convida alguém a desligar as mensagens de que precisa, e é uma das razões pelas quais as duas streams estão separadas.