Agregar encabezados de cancelación de suscripción al correo electrónico mediante Amazon Pinpoint - Amazon Pinpoint

Aviso de fin de soporte: el 30 de octubre de 2026, AWS finalizará el soporte para Amazon Pinpoint. Después del 30 de octubre de 2026, ya no podrá acceder a la consola de Amazon Pinpoint ni a los recursos de Amazon Pinpoint (puntos de conexión, segmentos, campañas, recorridos y análisis). Para obtener más información, consulte Fin de soporte de Amazon Pinpoint. Nota: en lo APIs que respecta a los SMS, este cambio no afecta a los mensajes de voz, a las notificaciones push móviles, a las OTP y a la validación de números de teléfono, y son compatibles con la mensajería para el usuario AWS final.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Agregar encabezados de cancelación de suscripción al correo electrónico mediante Amazon Pinpoint

nota

Antes de poder usar encabezados de correo electrónico, debe configurar un rol de envío de orquestación de correo electrónico si va a enviar correos electrónicos desde una campaña o un recorrido. Para correos electrónicos de envío directo, debe tener permisos para ses:SendEmail y ses:SendRawEmail. Para obtener más información, consulte Creating an email orchestration sending role en la Guía del usuario de Amazon Pinpoint.

Incluir un enlace para cancelar la suscripción en el correo electrónico es una práctica recomendada y, en algunos países, es un requisito legal. Para agregar un enlace para cancelar la suscripción con un solo clic, añada los siguientes encabezados:

  1. Establezca el Nombre del encabezado como List-Unsubscribe y en Valor ingrese el enlace para cancelar la suscripción. El enlace debe admitir solicitudes HTTP POST para procesar la solicitud de cancelación de suscripción de los destinatarios.

  2. Establezca el nombre del encabezado como List-Unsubscribe-Post y el valor en List-Unsubscribe=One-Click.

Puede agregar hasta 15 encabezados a un mensaje de correo electrónico. Para obtener una lista de los encabezados compatibles, consulte Amazon SES header fields en la Guía para desarrolladores de Amazon Simple Email Service.

En el siguiente ejemplo se muestra cómo enviar un mensaje de correo electrónico con encabezados de cancelación de suscripción mediante la AWS Command Line Interface. Para obtener más información sobre cómo configurar la AWS CLI, consulte Configure the AWS CLI en la Guía del usuario de AWS Command Line Interface.

En el siguiente comando, haga esto:

  • Reemplace AppId por el ID de su aplicación.

  • Reemplace richard_roe@example.com por la dirección de correo electrónico del destinatario.

  • Reemplace https://example.com/unsub por el enlace para cancelar la suscripción.

  • Reemplace example123456 por un identificador único para el destinatario.

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"
         }
       ]
     }
   }
 }
}'