Pular para o conteúdo
spacepostdocs

Cancelar inscrição

Todo e-mail de campanha recebe dois mecanismos de cancelamento de inscrição, sem nada para você configurar.

Seção intitulada “O link”

{{{SPACEPOST_UNSUBSCRIBE_URL}}} se expande para uma URL como https://app.spacepost.dev/u/<token>. O token é assinado por contato, então não pode ser adivinhado nem alterado.

  • Abrir o link mostra uma página de confirmação (“Stop receiving emails at j***@example.com?”). Um GET nunca cancela a inscrição de ninguém, então scanners de links e ferramentas de segurança de e-mail não cancelam inscrições por acidente. O endereço aparece mascarado na página.
  • Ao pressionar o botão, é enviado um POST que define o flag unsubscribed do contato como true.

Se o seu HTML não tiver um placeholder de cancelamento de inscrição, um rodapé com um link é anexado para você (e uma linha de texto simples na parte em texto). Coloque o placeholder no seu próprio design para controlar o texto e a posição.

Os cabeçalhos

Seção intitulada “Os cabeçalhos”

O SpacePost adiciona os cabeçalhos que o Gmail e o Yahoo exigem para e-mails em massa:

List-Unsubscribe: <https://app.spacepost.dev/u/<token>>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

Com eles, o Gmail e o Apple Mail mostram um botão nativo de Unsubscribe ao lado do remetente. Um clique faz o cliente de e-mail enviar um POST à URL, o que cancela a inscrição do contato imediatamente, como especifica a RFC 8058. Isso é muito melhor para a sua reputação do que os destinatários usarem o botão de spam.

O que acontece depois

Seção intitulada “O que acontece depois”
  • O contato é ignorado por todas as campanhas futuras para aquele público.
  • No momento, nada é enviado aos seus webhooks em cancelamentos de inscrição; leia o flag unsubscribed em GET /audiences/{id}/contacts/{idOrEmail} ou liste os contatos para sincronizar o seu próprio banco de dados.
  • Para reinscrever alguém que pede isso, use PATCH no contato com { "unsubscribed": false }. Faça isso apenas a pedido explícito.

E-mail transacional

Seção intitulada “E-mail transacional”

Os links de cancelamento de inscrição são para e-mails de marketing. Redefinições de senha, recibos e avisos de segurança não precisam de um. Se você envia conteúdo de marketing por POST /emails, adicione os cabeçalhos por conta própria (veja Cabeçalhos personalizados) e trate os opt-outs do seu lado, ou use campanhas.