Ajouter des en-têtes de désabonnement à un e-mail à l'aide d'Amazon Pinpoint - Amazon Pinpoint

Avis de fin de support : le 30 octobre 2026, le support d'Amazon Pinpoint AWS prendra fin. Après le 30 octobre 2026, vous ne pourrez plus accéder à la console Amazon Pinpoint ni aux ressources Amazon Pinpoint (points de terminaison, segments, campagnes, parcours et analytique). Pour plus d’informations, consultez Fin de la prise en charge d’Amazon Pinpoint. Remarque : en ce qui APIs concerne les SMS, la voix, le push mobile, l'OTP et la validation des numéros de téléphone ne sont pas concernés par cette modification et sont pris en charge par AWS la messagerie utilisateur final.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ajouter des en-têtes de désabonnement à un e-mail à l'aide d'Amazon Pinpoint

Note

Avant de pouvoir utiliser les en-têtes d'e-mail, vous devez configurer un rôle d'envoi d'orchestration des e-mails si vous envoyez des e-mails dans le cadre d'une campagne ou d'un parcours. Pour l'envoi direct d'e-mails, vous devez disposer des autorisations pour ses:SendEmail etses:SendRawEmail. Pour plus d'informations, consultez la section Création d'un rôle d'envoi d'orchestration d'e-mails dans le guide de l'utilisateur Amazon Pinpoint.

L’inclusion d’un lien de désabonnement dans votre e-mail est une bonne pratique, et dans certains pays, c’est une obligation légale. Pour ajouter un lien de désabonnement en un clic, ajoutez les en-têtes suivants :

  1. Définissez le nom de l'en-tête sur List-Unsubscribe et définissez la valeur sur votre lien de désinscription. Le lien doit prendre en charge les requêtes HTTP POST pour traiter la demande de désinscription du destinataire.

  2. Définissez le nom de l'en-tête sur List-Unsubscribe-Post et définissez la valeur surList-Unsubscribe=One-Click.

Vous pouvez ajouter jusqu'à 15 en-têtes à un e-mail. Pour obtenir la liste des en-têtes pris en charge, consultez les champs d'en-tête Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

L'exemple suivant montre comment envoyer un e-mail avec des en-têtes de désabonnement à l'aide du AWS Command Line Interface. Pour plus d'informations sur la configuration du AWS CLI, voir Configurer le AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.

Dans la commande suivante, procédez comme suit :

  • Remplacez AppId par l'identifiant de votre application.

  • Remplacez richard_roe@example.com par l'adresse e-mail du destinataire.

  • https://example.com/unsubRemplacez-le par votre lien de désinscription.

  • Remplacez example123456 par un identifiant unique pour le destinataire.

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