Adicionar cabeçalhos de cancelamento de assinatura ao e-mail usando o Amazon Pinpoint - Amazon Pinpoint

Aviso de fim do suporte: em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para obter mais informações, consulte Fim do suporte do Amazon Pinpoint. Observação: APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Adicionar cabeçalhos de cancelamento de assinatura ao e-mail usando o Amazon Pinpoint

nota

Antes de usar cabeçalhos de e-mail, você deve configurar um perfil de envio de orquestração de e-mail se estiver enviando e-mails de uma campanha ou de uma jornada. Para envio direto de e-mail, você deve ter permissões para ses:SendEmail e ses:SendRawEmail. Para obter mais informações, consulte Creating an email orchestration sending role no Guia do usuário do Amazon Pinpoint.

Incluir um link de cancelamento de inscrição no e-mail é uma prática recomendada e, em alguns países, é uma exigência legal. Para adicionar um link de cancelamento de inscrição com um clique, adicione os seguintes cabeçalhos:

  1. Defina o cabeçalho Nome como List-Unsubscribe e defina o Valor como seu link de cancelamento da assinatura. O link deve oferecer suporte a solicitações HTTP POST para processar a solicitação de cancelamento de assinatura do destinatário.

  2. Defina o cabeçalho Nome como List-Unsubscribe-Post e defina o Valor como List-Unsubscribe=One-Click.

Você pode adicionar até 15 cabeçalhos em uma mensagem de e-mail. Para obter uma lista de cabeçalhos compatíveis, consulte os Amazon SES header fields no Guia do desenvolvedor do Amazon Simple Email Service.

O exemplo a seguir mostra como enviar uma mensagem de e-mail com cabeçalhos de cancelamento da assinatura usando o AWS Command Line Interface. Para obter mais informações sobre como configurar a AWS CLI, consulte Configurar a AWS CLI no Guia do usuário da AWS Command Line Interface.

No comando abaixo, faça o seguinte:

  • Substitua AppId pelo ID da sua aplicação

  • Substitua richard_roe@example.com pelo endereço de e-mail do destinatário.

  • Substitua https://example.com/unsub pelo seu link de cancelamento de inscrição.

  • Substitua example123456 por um identificador exclusivo do destinatário.

aws pinpoint send-messages --application-id AppId --message-request '{
 "Addresses": {
   "richard_roe@example.com": {
     "ChannelType": "EMAIL"
   }
 },
 "MessageConfiguration": {
   "EmailMessage": {
     "Substitutions": {
       "url": [
         "https://example.com/unsub"
       ],
        "id1": [
          "/example123456"
        ]
     },
     "SimpleEmail": {
       "TextPart": {
         "Data": "Sample email message with an subscribe header",
         "Charset": "UTF-8"
       },
       "Subject": {
         "Data": "Hello",
         "Charset": "UTF-8"
       },
       "Headers": [
         {
           "Name": "List-Unsubscribe",
           "Value": "{{url}}{{id1}}"
         },
         {
           "Name": "List-Unsubscribe-Post",
           "Value": "List-Unsubscribe=One-Click"
         }
       ]
     }
   }
 }
}'