Fase 3: specificazione di un set di configurazione per l'invio di un messaggio di posta elettronica - Amazon Simple Email Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Fase 3: specificazione di un set di configurazione per l'invio di un messaggio di posta elettronica

Dopo aver creato un set di configurazione e aver aggiunto una destinazione degli eventi, l'ultima fase della pubblicazione di eventi consiste nell'inviare le tue e-mail.

Per pubblicare gli eventi associati a un'e-mail, devi fornire il nome del set di configurazione da associare all'e-mail. Opzionalmente puoi fornire tag di messaggio per classificare l'e-mail.

Puoi fornire queste informazioni ad Amazon SES come parametri dell'API di invio di e-mail, intestazioni specifiche di Amazon SES o intestazioni personalizzate nel messaggio MIME. Il metodo scelto dipende da quale interfaccia di invio di e-mail utilizzi, come illustrato nella seguente tabella.

Interfaccia di invio di e-mail Metodi di pubblicazione di eventi

SendEmail

Parametri dell'API

SendTemplatedEmail

Parametri dell'API

SendBulkTemplatedEmail

Parametri dell'API

SendCustomVerificationEmail

Parametri dell'API

SendRawEmail

Parametri dell'API, intestazioni e-mail specifiche di Amazon SES o intestazioni MIME personalizzate

Importante

Se specifichi tag di messaggio utilizzando sia le intestazioni che i parametri dell'API, Amazon SES utilizza solo i tag di messaggio forniti dai parametri dell'API. Amazon SES non unisce i tag di messaggio specificati dai parametri dell'API e dalle intestazioni.

Interfaccia SMTP

Intestazioni e-mail specifiche di Amazon SES

Le sezioni seguenti descrivono come specificare il set di configurazione e i tag di messaggio utilizzando le intestazioni e i parametri dell'API.

Nota

Opzionalmente puoi includere tag di messaggio nelle intestazioni dell'e-mail. I tag di messaggio possono includere numeri da 0 a 9, lettere da A a Z (maiuscole e minuscole), trattini (-) e trattini di sottolineatura (_).

Utilizzo di parametri dell'API Amazon SES

Per utilizzare SendEmail, SendTemplatedEmail, SendBulkTemplatedEmail, SendCustomVerificationEmail o SendRawEmail con la pubblicazione degli eventi, devi specificare il set di configurazione e i tag dei messaggi passando le strutture di dati denominate ConfigurationSetMessageTag alla chiamata API.

Per ulteriori informazioni sull'uso dell'API Amazon SES, consulta Documenti di riferimento per le API di Amazon Simple Email Service.

Utilizzo di intestazioni e-mail specifiche di Amazon SES

Quando usi SendRawEmail o l'interfaccia SMTP, puoi specificare il set di configurazione e i tag di messaggio aggiungendo intestazioni specifiche di Amazon SES all'e-mail. Amazon SES rimuove le intestazioni prima di inviare l'e-mail. La tabella seguente mostra i nomi delle intestazioni da utilizzare.

Informazioni per la pubblicazione di eventi Intestazione

Set di configurazione

X-SES-CONFIGURATION-SET

Tag di messaggio

X-SES-MESSAGE-TAGS

L'esempio seguente mostra il possibile aspetto delle intestazioni in un'e-mail in formato RAW inviata ad 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--

Utilizzo di intestazioni e-mail personalizzate

Anche se devi specificare il nome del set di configurazione utilizzando l'intestazione specifica di Amazon SES X-SES-CONFIGURATION-SET, puoi specificare i tag di messaggio utilizzando le tue intestazioni MIME.

Nota

I nomi e i valori delle intestazioni che usi per la pubblicazione di eventi Amazon SES devono essere in ASCII. Se specifichi un nome o un valore di intestazione non ASCII per la pubblicazione di eventi Amazon SES, la chiamata di invio di e-mail avrà comunque esito positivo, ma i parametri degli eventi non verranno emessi in Amazon CloudWatch.