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.
Étape 3 : Spécifier votre jeu de configuration lorsque vous envoyez un e-mail
Une fois que vous avez créé un jeu de configurations et ajouté une destination d'événement, la dernière étape de la publication d'événements consiste à envoyer vos e-mails.
Pour publier les événements associés à un e-mail, vous devez indiquer le nom du jeu de configurations à associer à l'e-mail. Vous pouvez éventuellement fournir des balises de message pour classer l'e-mail dans une catégorie.
Vous fournissez ces informations à Amazon SES sous forme de paramètres pour l'API d'envoi d'e-mails, d'en-têtes d'e-mail propres à ou d'en-têtes personnalisés dans votre message MIME. La méthode que vous choisissez dépend de l'interface d'envoi d'e-mails que vous utilisez, comme le montre le tableau suivant.
| Interface d'envoi d'e-mails | Méthodes de publication d'événements |
|---|---|
|
|
Paramètres d'API |
|
|
Paramètres d'API |
|
|
Paramètres d'API |
|
|
Paramètres d'API |
|
|
Paramètres d'API, en-têtes d'e-mail propres à Amazon SES ou en-têtes MIME personnalisés ImportantSi vous spécifiez des balises de message en utilisant à la fois des en-têtes de message et des paramètres d'API, Amazon SES utilise uniquement les balises de message fournies par les paramètres d'API. Amazon SES ne joint pas les balises de message spécifiées par les paramètres d'API et les en-têtes. |
|
Interface SMTP |
En-têtes d'e-mail propres à Amazon SES |
Les sections suivantes expliquent comment spécifier le jeu de configurations et les balises de message à l'aide d'en-têtes et de paramètres d'API.
Note
Vous pouvez éventuellement inclure des balises de message dans les en-têtes de vos e-mails. Les balises de messages peuvent inclure les chiffres de 0 à 9, les lettres A-Z (majuscules et minuscules), des tirets (-) et des traits de soulignement (_).
Utilisation des paramètres d'API Amazon SES
Pour utiliser SendEmail, SendTemplatedEmail, SendBulkTemplatedEmail, SendCustomVerificationEmail ou SendRawEmail dans le cadre de la publication d'événements, vous devez spécifier le jeu de configurations et les identifications de message en transmettant les structures de données appelées ConfigurationSet et MessageTag à l'appel d'API.
Pour en savoir plus sur l'utilisation de l'API Amazon SES, consultez le document Amazon Simple Email Service API Reference.
Utilisation d'en-têtes d'e-mail propres à Amazon SES
Lorsque vous utilisez SendRawEmail ou l'interface SMTP, vous pouvez spécifier le jeu de configurations et les balises de message en ajoutant à l'e-mail des en-têtes propres à Amazon SES. Amazon SES supprime les en-têtes avant d'envoyer l'e-mail. Le tableau suivant présente les noms des en-têtes à utiliser.
| Informations de publication d'événements | En-tête |
|---|---|
|
Jeu de configurations |
|
|
Balises de message |
|
L'exemple suivant montre l'aspect des têtes dans un e-mail brut que vous envoyez à Amazon SES.
X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2 X-SES-CONFIGURATION-SET: myConfigurationSet From: sender@example.com To: recipient@example.com Subject: Subject Content-Type: multipart/alternative; boundary="----=_boundary" ------=_boundary Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit body ------=_boundary Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit body ------=_boundary--
Utilisation d'en-têtes d'e-mail personnalisés
Bien que vous soyez tenu de spécifier le nom du jeu de configurations à l'aide de l'en-tête propre à Amazon SES X-SES-CONFIGURATION-SET, vous pouvez spécifier les message des balises en utilisant vos propres en-têtes MIME.
Note
Les noms et les valeurs d'en-tête que vous utilisez pour la publication d'événements Amazon SES doivent être en ASCII. Si vous spécifiez un nom ou une valeur d'en-tête non ASCII pour la publication d'événements Amazon SES, l'appel d'envoi d'e-mails continue d'aboutir, mais les métriques d'événement ne sont pas émises vers Amazon CloudWatch.
