Contenido de las notificaciones para recibir correo electrónico de Amazon SES

Todas las notificaciones de recepción de correo electrónico se publican en temas de Amazon Simple Notification Service (Amazon SNS) en formato de notación de objetos JavaScript (JSON).

Para obtener ejemplos de notificaciones, consulte Ejemplos de notificaciones.

Contenido

• Objeto JSON de nivel superior
• Objeto receipt
  • Objeto action
  • Objeto dkimVerdict
  • Objeto dmarcVerdict
  • Objeto spamVerdict
  • Objeto spfVerdict
  • Objeto virusVerdict
• Objeto mail
  • Objeto commonHeaders

Objeto JSON de nivel superior

Los objetos JSON de nivel superior contienen los siguientes campos.

Nombre del campo	Descripción
notificationType	El tipo de notification. Para este tipo de notificación, el valor siempre es Received.
receipt	Objeto que contiene información sobre la entrega de correo electrónico.
mail	Objeto que contiene información sobre el correo electrónico relacionado con la notificación.
content	Cadena que contiene el correo electrónico sin procesar y sin modificar que normalmente está en formato Multipurpose Internet Mail Extensions (MIME). Para obtener más información acerca del formato MIME, consulte RFC 2045. nota Este campo está presente solo si la notificación la activó una acción SNS. Las notificaciones activadas por las demás acciones no contienen este campo.

Objeto receipt

El objeto receipt tiene los siguientes campos.

Nombre del campo	Descripción
action	Objeto que encapsula información sobre la acción que se ha ejecutado. Para obtener una lista de los posibles valores, consulte Objeto action.
dkimVerdict	Objeto que indica si se ha superado la comprobación de DomainKeys Identified Mail (DKIM). Para obtener una lista de los posibles valores, consulte Objeto dkimVerdict.
dmarcPolicy	Indica la configuración Domain-based Message Authentication, Reporting & Conformance (DMARC) para el dominio de envío. Este campo solo aparece si el mensaje no supera la autenticación DMARC. Los valores posibles para este campo son: none: el propietario del dominio de envío solicita que no se tome ninguna medida específica para los mensajes que no superen la autenticación DMARC. quarantine: el propietario del dominio de envío solicita que los receptores traten como sospechosos los mensajes que no superen la autenticación DMARC. reject: el propietario del dominio de envío solicita que se rechacen los mensajes que no superen la autenticación DMARC.
dmarcVerdict	Objeto que indica si se ha superado la comprobación de Domain-based Message Authentication, Reporting & Conformance (DMARC). Para obtener una lista de los posibles valores, consulte Objeto dmarcVerdict.
processingTimeMillis	Cadena que especifica el periodo, en milisegundos, desde el momento en que Amazon SES recibió el mensaje hasta el momento en que se desencadenó la acción.
recipients	Los destinatarios (específicamente, las direcciones RCPT TO del sobre) que se corresponde con la regla de recepción activa. Las direcciones indicadas aquí pueden ser distintas de las que figuran en el campo destination del Objeto mail.
spamVerdict	Objeto que indica si el mensaje es spam. Para obtener una lista de los posibles valores, consulte Objeto spamVerdict.
spfVerdict	Objeto que indica si se ha superado la comprobación de Sender Policy Framework (SPF). Para obtener una lista de los posibles valores, consulte Objeto spfVerdict.
timestamp	Cadena que especifica la fecha y la hora a la que se desencadenó la acción, en formato ISO 8601.
virusVerdict	Objeto que indica si el mensaje contiene un virus. Para obtener una lista de los posibles valores, consulte Objeto virusVerdict.

Objeto action

El objeto action tiene los siguientes campos.

Nombre del campo	Descripción
type	Cadena que indica el tipo de acción que se ha ejecutado. Los valores posibles son S3, SNS, Bounce, Lambda, Stop y WorkMail.
topicArn	Cadena que contiene el Nombre de recurso de Amazon (ARN) del tema de Amazon SNS en el que se publicó la notificación.
bucketName	Cadena que contiene el nombre del bucket de Amazon S3 en el que se publicó el mensaje. Presente solo para el tipo de acción de S3.
objectKey	Cadena que contiene un nombre que identifica de forma única el correo electrónico en el bucket de Amazon S3. Coincide con el messageId del Objeto mail. Presente solo para el tipo de acción de S3.
smtpReplyCode	Cadena que contiene el código de respuesta de SMTP, tal y como se define en RFC 5321. Presente solo para el tipo de acción de rebote.
statusCode	Cadena que contiene el código de estado mejorado de SMTP, tal y como se define en RFC 3463. Presente solo para el tipo de acción de rebote.
message	Cadena que contiene texto en lenguaje natural para incluir en el mensaje de rebote. Presente solo para el tipo de acción de rebote.
sender	Cadena que contiene la dirección de correo electrónico del remitente del correo electrónico rebotado. Esta es la dirección desde la que se envió el mensaje de rebote. Presente solo para el tipo de acción de rebote.
functionArn	Cadena que contiene el ARN de la función de Lambda que se desencadenó. Presente solo para el tipo de acción Lambda.
invocationType	Cadena que contiene el tipo de invocación de la función de Lambda. Los posibles valores son RequestResponse y Event. Presente solo para el tipo de acción Lambda.
organizationArn	Cadena que contiene el ARN de la organización de Amazon WorkMail. Presente solo para el tipo de acción WorkMail.

Objeto dkimVerdict

El objeto dkimVerdict tiene los siguientes campos.

Nombre del campo

Descripción

status

Cadena que contiene el veredicto de DKIM. Los valores posibles son los siguientes: PASS: el mensaje ha superado la autenticación DKIM. FAIL: el mensaje no ha superado la autenticación DKIM. GRAY: el mensaje no está firmado por DKIM o el dominio de origen y el dominio de firma de DKIM no coinciden. PROCESSING_FAILED: hay un problema que impide que Amazon SES compruebe la firma de DKIM. Por ejemplo, las consultas de DNS devuelven un error o el encabezado de la firma DKIM no tiene el formato correcto.

Objeto dmarcVerdict

El objeto dmarcVerdict tiene los siguientes campos.

Nombre del campo

Descripción

status

Cadena que contiene el veredicto de DMARC. Los valores posibles son los siguientes: PASS: el mensaje ha superado la autenticación DMARC. FAIL: el mensaje no ha superado la autenticación DMARC. GRAY: al menos uno de SPF o DKIM ha superado la autenticación, pero el dominio de envío no tiene una política DMARC o utiliza la política p=none. PROCESSING_FAILED: existe un problema que impide que Amazon SES proporcione un veredicto de DMARC.

Objeto spamVerdict

El objeto spamVerdict tiene los siguientes campos.

Nombre del campo

Descripción

status

Cadena que contiene el resultado del análisis de spam. Los valores posibles son los siguientes: PASS: el análisis de spam ha determinado que es improbable que el mensaje contenga spam. FAIL: el análisis de spam ha determinado que es probable que el mensaje contenga spam. GRAY: Amazon SES ha analizado el correo electrónico, pero no ha podido determinar con confianza si se trata de spam. PROCESSING_FAILED: Amazon SES no ha podido analizar el correo electrónico. Por ejemplo, el correo electrónico no es un mensaje MIME válido.

Objeto spfVerdict

El objeto spfVerdict tiene los siguientes campos.

Nombre del campo	Descripción
status	Cadena que contiene el veredicto de SPF. Los valores posibles son los siguientes: PASS: el mensaje ha superado la autenticación SPF. FAIL: el mensaje no ha superado la autenticación SPF. GRAY: el resultado del SPF es none, softfail o neutral. PROCESSING_FAILED: hay un problema que impide que Amazon SES compruebe el registro SPF. Por ejemplo, las consultas DNS están fallando.

Objeto virusVerdict

El objeto virusVerdict tiene los siguientes campos.

Nombre del campo

Descripción

status

Cadena que contiene el resultado del análisis de virus. Los valores posibles son los siguientes: PASS: el mensaje no contiene un virus. FAIL: el mensaje contiene un virus. GRAY: Amazon SES ha analizado el correo electrónico, pero no ha podido determinar con confianza si contiene un virus. PROCESSING_FAILED: Amazon SES no puede analizar el contenido del correo electrónico. Por ejemplo, el correo electrónico no es un mensaje MIME válido.

Objeto mail

El objeto mail tiene los siguientes campos.

Nombre del campo	Descripción
destination	Lista completa de todas las direcciones de los destinatarios (incluidos en los campos To: y CC:) de los encabezados MIME de los mensajes de correo electrónico entrantes.
messageId	Cadena que contiene un ID único que Amazon SES asigna al correo electrónico. Si el correo electrónico se ha entregado a Amazon S3, el ID de mensaje es también la clave de objeto de Amazon S3 que se utilizó para escribir el mensaje en el bucket de Amazon S3.
source	Cadena que contiene la dirección de correo electrónico (específicamente, la dirección MAIL FROM del sobre) desde la que se envió el correo electrónico.
timestamp	Cadena que contiene la hora en la que se recibió el correo electrónico, en formato ISO8601.
headers	Los encabezados de Amazon SES y sus encabezados personalizados. Cada encabezado tiene los siguientes campos: name y value.
commonHeaders	Los encabezados comunes a todos los correos electrónicos. Cada encabezado tiene los siguientes campos: name y value.
headersTruncated	Cadena que especifica si los encabezados se truncaron en la notificación, lo que ocurre si los encabezados tienen un tamaño superior a 10 KB. Los posibles valores son true y false.

Objeto commonHeaders

El objeto commonHeaders puede tener los campos que se muestran en la tabla siguiente. Los campos presentes en este objeto varían en función de los campos existentes en el correo electrónico entrante.

Nombre del campo	Descripción
messageId	El ID del mensaje original.
date	La fecha y hora en que Amazon SES recibió el mensaje.
to	El encabezado To del correo electrónico.
cc	El encabezado CC del correo electrónico.
bcc	El encabezado BCC del correo electrónico.
from	El encabezado From del correo electrónico.
sender	El encabezado Sender del correo electrónico.
returnPath	El encabezado Return-Path del correo electrónico.
replyTo	El encabezado Reply-To del correo electrónico.
subject	El encabezado Subject del correo electrónico.