Paso 3: Especifique el conjunto de configuración cuando envía correo electrónico - Amazon Simple Email Service

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.

Paso 3: Especifique el conjunto de configuración cuando envía correo electrónico

Después de crear un conjunto de configuración y añadir un evento de destino, el último paso para la publicación de eventos consiste en enviar sus mensajes de correo electrónico.

Para publicar eventos asociados con un correo electrónico, debe proporcionar el nombre del conjunto de configuración para asociar con el correo electrónico. Opcionalmente, puede proporcionar etiquetas de mensaje para categorizar el correo electrónico.

Debe proporcionar esta información a Amazon SES como parámetros para la API de envío de correo electrónico, encabezados de correo electrónico específicos de Amazon SES o encabezados personalizados en el mensaje MIME. El método que elija depende de la interfaz de envío de correo electrónico que utilice, tal y como se muestra en la siguiente tabla.

Interfaz de envío de correo electrónico Formas de publicar eventos

SendEmail

Parámetros de la API

SendTemplatedEmail

Parámetros de la API

SendBulkTemplatedEmail

Parámetros de la API

SendCustomVerificationEmail

Parámetros de la API

SendRawEmail

Parámetros de la API, encabezados de correo electrónico específicos de Amazon SES o encabezados MIME personalizados

importante

Si especifica etiquetas de mensajes utilizando ambos encabezados y parámetros de la API, Amazon SES utiliza solo las etiquetas de mensajes proporcionadas por los parámetros de la API. Amazon SES no une etiquetas de mensajes especificadas por encabezados y parámetros de la API.

Interfaz de SMTP

Encabezados de correo electrónico específicos de Amazon SES

En las secciones siguientes se describe cómo especificar el conjunto de configuración y las etiquetas de mensajes utilizando encabezados y utilizando parámetros de la API.

nota

También puede incluir etiquetas de mensaje en los encabezados de los correos electrónicos. Las etiquetas de mensaje pueden incluir los números del 0 al 9, las letras de la A a la Z (mayúsculas y minúsculas), guiones (-) y guiones bajos (_).

Uso de parámetros de la API de Amazon SES

Para utilizar SendEmail, SendTemplatedEmail, SendBulkTemplatedEmail, SendCustomVerificationEmail o SendRawEmail con la publicación de eventos, debe especificar el conjunto de configuraciones y las etiquetas de mensajes mediante la transferencia de estructuras de datos denominadas ConfigurationSet y MessageTag a la llamada a la API.

Para obtener más información acerca del uso de la API de Amazon SES, consulte la Referencia de la API de Amazon Simple Email Service.

Uso de encabezados de correo electrónico específicos de Amazon SES

Cuando utilice SendRawEmail o la interfaz de SMTP, para especificar el conjunto de configuración y las etiquetas de mensajes, puede agregar encabezados específicos de Amazon SES al correo electrónico. Amazon SES elimina los encabezados antes de enviar el correo electrónico. En la siguiente tabla se muestran los nombres de los encabezados que utilizar.

Información de publicación de eventos Encabezado

Conjunto de configuración

X-SES-CONFIGURATION-SET

Etiquetas de mensajes

X-SES-MESSAGE-TAGS

En el siguiente ejemplo se muestra el aspecto que podrían tener los encabezados en un correo electrónico sin procesar que envíe a 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--

Uso de encabezados de correo electrónico personalizados

Aunque debe especificar el nombre del conjunto de configuración utilizando el encabezado X-SES-CONFIGURATION-SET específico de Amazon SES, puede especificar las etiquetas de mensajes utilizando sus propios encabezados MIME.

nota

Los nombres y valores de encabezado que utilice para la publicación de eventos de Amazon SES deben estar en ASCII. Si especifica un valor o un nombre de encabezado no ASCII para la publicación de eventos de Amazon SES, la llamada de envío de correo electrónico seguirá realizándose correctamente, pero las métricas del evento no se emitirán a Amazon CloudWatch.