Contenido de los datos de eventos que Amazon SES publica en Amazon SNS

Amazon SES publica registros de eventos de envío de correo electrónico en Amazon Simple Notification Service en formato JSON.

Puede encontrar registros de ejemplo para todos estos tipos de notificación en Ejemplos de datos de eventos que Amazon SES publica en Amazon SNS.

Objeto JSON de nivel superior

El objeto JSON de nivel superior en un registro de eventos de envío de correo electrónico contiene los siguientes campos. El tipo de evento determina qué otros objetos están presentes.

Nombre del campo	Descripción
eventType	Una cadena que describe el tipo de evento. Valores posibles: Bounce, Complaint, Delivery, Send, Reject, Open, Click, Rendering Failure, DeliveryDelay o Subscription. Si no configuró la publicación de eventos este campo se denomina notificationType.
mail	Un objeto JSON que contiene información acerca del mensaje de correo electrónico que produjo el evento.
bounce	Este campo solo está presente si eventType es Bounce. Contiene información sobre el rebote.
complaint	Este campo solo está presente si eventType es Complaint. Contiene información sobre la reclamación.
delivery	Este campo solo está presente si eventType es Delivery. Contiene información sobre la entrega.
send	Este campo solo está presente si eventType es Send.
reject	Este campo solo está presente si eventType es Reject. Contiene información sobre el rechazo.
open	Este campo solo está presente si eventType es Open. Contiene información sobre el evento de apertura.
click	Este campo solo está presente si eventType es Click. Contiene información sobre el evento de clic.
failure	Este campo solo está presente si eventType es Rendering Failure. Contiene información sobre el evento de error de presentación.
deliveryDelay	Este campo solo está presente si eventType es DeliveryDelay. Contiene información sobre el retraso en la entrega de un correo electrónico.
subscription	Este campo solo está presente si eventType es Subscription. Contiene información sobre las preferencias de suscripción.

Objeto Mail

Cada registro de evento de envío de correo electrónico contiene información acerca del correo electrónico original en el objeto mail. El objeto JSON que contiene información acerca de un objeto mail tiene los campos siguientes.

Nombre del campo	Descripción
timestamp	La fecha y la hora, en formato ISO86 01 (AAAA-MM DDThh -:MM:SS.SZ), en que se envió el mensaje.
messageId	Un ID exclusivo que Amazon SES asignó al mensaje. Amazon SES le devolvió este valor cuando envió el mensaje. nota Este ID de mensaje lo asignó Amazon SES. Puede encontrar el ID de mensaje del correo electrónico original en los campos headers y commonHeaders del objeto mail.
source	La dirección de correo electrónico desde la que se envió el mensaje (la dirección MAIL FROM del sobre).
sourceArn	El nombre de recurso de Amazon (ARN) de la identidad que se utilizó para enviar el correo electrónico. En el caso de una autorización de envío, el sourceArn es el ARN de la identidad que el propietario de la identidad autorizó utilizar al remitente delegado para enviar el correo electrónico. Para obtener más información acerca de la autorización de envío, consulte Métodos de autenticación del correo electrónico.
sendingAccountId	El identificador de la AWS cuenta que se utilizó para enviar el correo electrónico. En el caso de la autorización de envío, el sendingAccountId es el ID de cuenta del remitente delegado.
destination	Una lista de direcciones de correo electrónico que han sido destinatarios del correo electrónico original.
headersTruncated	Una cadena que especifica si los encabezados están truncados en la notificación, que se produce si los encabezados tienen un tamaño superior a 10 KB. Los posibles valores son true y false.
headers	Una lista de los encabezados originales del correo electrónico. Cada encabezado de la lista tiene un campo name y un campo value. nota Cualquier ID de mensaje dentro del campo headers procede del mensaje original que pasó a Amazon SES. El ID de mensaje que Amazon SES asignó seguidamente al mensaje está en el campo messageId del objeto mail.
commonHeaders	Un mapeo de los encabezados originales del correo electrónico utilizados habitualmente. nota El ID de mensaje dentro del campo commonHeaders es el ID de mensaje que Amazon SES asignó seguidamente al mensaje en el campo messageId del objeto mail.
tags	Una lista de etiquetas asociadas al correo electrónico.

Objeto Bounce

El objeto JSON que contiene información acerca de un evento Bounce tiene los campos siguientes.

Nombre del campo	Descripción
bounceType	El tipo de rebote, tal como determina Amazon SES.
bounceSubType	El subtipo de rebote, tal como determina Amazon SES.
bouncedRecipients	Una lista que contiene información acerca de los destinatarios del mensaje de correo electrónico original que dio lugar a un rebote.
timestamp	La fecha y la hora, en formato ISO86 01 (AAAA-MM DDThh -:MM:ss.sz), en las que el ISP envió la notificación de rebote.
feedbackId	Un ID único para el rebote.
reportingMTA	El valor del campo Reporting-MTA del DSN. Se trata del valor de la autoridad de transferencia de mensajes (MTA) que intentó realizar la operación de entrega, retransmisión o gateway descrita en el DSN. nota Este campo solo aparece si se ha adjuntado una notificación de estado de entrega (DSN) al rebote.

Destinatarios con rebote

Un evento de rebote podría pertenecer a un único destinatario o a varios destinatarios. El campo bouncedRecipients incluye una lista de objetos (un objeto por destinatario cuya dirección de correo electrónico produjo un rebote) y contiene el campo siguiente.

Nombre del campo	Descripción
emailAddress	La dirección de correo electrónico del destinatario. Si hay un DSN disponible, se trata del valor del campo Final-Recipient del DSN.

Opcionalmente, si hay un DSN adjunto al rebote, los siguientes campos también podrían estar presentes.

Nombre del campo	Descripción
action	El valor del campo Action del DSN. Esto indica la acción que realiza el MTA de notificación como resultado de su intento de entregar el mensaje a este destinatario.
status	El valor del campo Status del DSN. Se trata del código de estado independiente del transporte por destinatario que indica el estado de entrega del mensaje.
diagnosticCode	El código de estado emitido por la MTA de notificación. Este es el valor del campo Diagnostic-Code del DSN. Este campo puede estar ausente en el DSN (y, por lo tanto, también ausente en el JSON).

Tipos de rebote

Cada evento de rebote es de uno de los tipos que se muestran en la tabla siguiente.

El sistema de publicación de eventos solo publica rechazos permanentes y rebotes temporales que Amazon SES ya no volverá a intentar. Si recibe rebotes marcados como Permanent, debería eliminar las direcciones de correo electrónico correspondientes de su lista de correo, ya que no podrá enviar mensajes a estas en el futuro. Los rebotes Transient se le envían cuando un mensaje ha tenido un rebote temporal varias veces y Amazon SES ha dejado de intentar volver a enviarlo. Es posible que en el futuro pueda volver a enviar correctamente a una dirección que inicialmente ha dado lugar a un rebote Transient.

bounceType	bounceSubType	Descripción
Undetermined	Undetermined	Amazon SES no ha podido determinar un motivo específico de rebote.
Permanent	General	Amazon SES recibió un rechazo permanente general. Si recibe este tipo de rebote, debería eliminar la dirección de correo electrónico del destinatario de su lista de correo.
Permanent	NoEmail	Amazon SES recibió un rechazo permanente porque la dirección de correo electrónico de destino no existe. Si recibe este tipo de rebote, debería eliminar la dirección de correo electrónico del destinatario de su lista de correo.
Permanent	Suppressed	Amazon SES ha suprimido el envío a esta dirección dado que tiene un historial reciente de rebotes como dirección no válida. Para anular la lista de supresión global, consulte Uso de la lista de supresión de nivel de cuenta de Amazon SES.
Permanent	OnAccountSuppressionList	Amazon SES ha suprimido el envío a esta dirección porque está en la lista de supresión de nivel de cuenta. Esto no se toma en cuenta para calcular la métrica de porcentaje de rebotes.
Transient	General	Amazon SES recibió un rebote general. Es posible que pueda enviar correctamente a este destinatario en el futuro.
Transient	MailboxFull	Amazon SES ha recibido un rebote completo de bandeja de entrada. Es posible que pueda enviar correctamente a este destinatario en el futuro.
Transient	MessageTooLarge	Amazon SES recibió un rebote de mensaje demasiado grande. Es posible que pueda enviar correctamente a este destinatario si reduce el tamaño del mensaje.
Transient	CustomTimeoutExceeded	Amazon SES no ha podido entregar correctamente el correo electrónico en el tiempo especificado por el remitente. (El mensaje de rebote especificará el motivo de cualquier posible error en el intento de entrega dentro del TTL definido).
Transient	ContentRejected	Amazon SES ha recibido un rebote de contenido rechazado. Es posible que pueda enviar correctamente a este destinatario si cambia el contenido del mensaje.
Transient	AttachmentRejected	Amazon SES ha recibido un rebote de archivo adjunto rechazado. Es posible que pueda enviar correctamente a este destinatario si elimina o cambia el archivo adjunto.

Objeto Complaint

El objeto JSON que contiene información acerca de un evento Complaint tiene los campos siguientes.

Nombre del campo	Descripción
complainedRecipients	Una lista que contiene información sobre destinatarios que podrían haber enviado la reclamación.
timestamp	La fecha y la hora, en formato ISO86 01 (AAAA-MM-:MM:SS.SZ), en las que el ISP envió la notificación de queja. DDThh
feedbackId	Un ID único para el reclamo.
complaintSubType	El subtipo del reclamo, tal como determina Amazon SES.

Además, si se adjunta un informe de retroalimentación a la reclamación, podrían estar presentes los siguientes campos.

Nombre del campo	Descripción
userAgent	El valor del campo User-Agent del informe de retroalimentación. Esto indica el nombre y la versión del sistema que generó el informe.
complaintFeedbackType	El valor del campo Feedback-Type del informe de retroalimentación recibido desde el ISP. Contiene el tipo de retroalimentación.
arrivalDate	El valor del campo Arrival-Date o Received-Date del informe de comentarios en formato 01 (AAAA-MM-:MM:SS.sz). ISO86 DDThh Este campo puede estar ausente en el informe (y, por lo tanto, también ausente en el JSON).

Destinatarios con reclamaciones

El campo complainedRecipients contiene una lista de destinatarios que podrían haber enviado la reclamación.

importante

ISPs La mayoría redacta las direcciones de correo electrónico de los destinatarios que presentan quejas. Por este motivo, el campo complainedRecipients incluye una lista de todos los destinatarios que han enviado el correo electrónico con una dirección en el dominio que emitió la notificación de reclamación.

Los objetos JSON de esta lista contienen el siguiente campo.

Nombre del campo	Descripción
emailAddress	La dirección de correo electrónico del destinatario.

Tipos de reclamación

Es posible que vea los siguientes tipos de reclamación en el campo complaintFeedbackType tal como los ha asignado el ISP que realiza la notificación, de acuerdo con el sitio web de Internet Assigned Numbers Authority:

Nombre del campo	Descripción
abuse	Indica correo electrónico no solicitado o algún otro tipo de abuso de correo electrónico.
auth-failure	Informe de error de autenticación de correo electrónico.
fraud	Indica algún tipo de fraude o actividad de phishing.
not-spam	Indica que la entidad que proporciona el informe no considera el mensaje como spam. Esto se puede utilizar para corregir un mensaje que estaba mal etiquetado o clasificado como spam.
other	Indica cualquier otra retroalimentación que no encaje en otros tipos registrados.
virus	Notifica que se ha encontrado un virus en el mensaje de origen.

Subtipos de reclamaciones

El valor del campo complaintSubType puede ser nulo o OnAccountSuppressionList. Si el valor es OnAccountSuppressionList, Amazon SES aceptó el mensaje, pero no intentó enviarlo porque estaba en la lista de supresión de nivel de cuenta.

Objeto Delivery

El objeto JSON que contiene información acerca de un evento Delivery tiene los campos siguientes.

Nombre del campo	Descripción
timestamp	La fecha y la hora en que Amazon SES entregó el correo electrónico al servidor de correo del destinatario, en formato ISO86 01 (YYYY-MM -:MM:SS.sz). DDThh
processingTimeMillis	El tiempo en milisegundos desde el momento en que Amazon SES aceptó la solicitud del remitente hasta el momento en que Amazon SES transfirió el mensaje al servidor de email del destinatario.
recipients	Una lista de los destinatarios a los que corresponden los eventos de entrega.
smtpResponse	El mensaje de respuesta SMTP del ISP remoto que ha aceptado el correo electrónico desde Amazon SES. Este mensaje variará por email, por receptor de servidor de recepción de email y por ISP de recepción.
reportingMTA	El nombre del anfitrión del servidor de email de Amazon SES que envió el email.

Objeto Send

El objeto JSON que contiene información acerca de un evento send está siempre vacío.

Objeto Reject

El objeto JSON que contiene información acerca de un evento Reject tiene los campos siguientes.

Nombre del campo	Descripción
reason	La razón por la que se rechazó el correo electrónico. El único valor posible es Bad content, lo que significa que Amazon SES detectó que el correo electrónico contenía un virus. Cuando se rechaza un mensaje, Amazon SES detiene el procesamiento y no intenta entregarlo al servidor de correo del destinatario.

Objeto Open

El objeto JSON que contiene información acerca de un evento Open tiene los campos siguientes.

Nombre del campo	Descripción
ipAddress	La dirección IP del destinatario.
timestamp	La fecha y la hora en que se produjo el evento de apertura en formato 01 (AAAA-MM-:MM:SS.SZ). ISO86 DDThh
userAgent	El agente del usuario del dispositivo o cliente de correo electrónico que el destinatario utiliza para abrir el correo electrónico.

Objeto Click

El objeto JSON que contiene información acerca de un evento Click tiene los campos siguientes.

Nombre del campo	Descripción
ipAddress	La dirección IP del destinatario.
timestamp	La fecha y la hora en que se produjo el clic en formato 01 (AAAA-MM-:MM:SS.SZ). ISO86 DDThh
userAgent	El agente del usuario del cliente que el destinatario usó para hacer clic en un enlace en el correo electrónico.
link	La dirección URL del enlace en el que el destinatario hizo clic.
linkTags	Una lista de las etiquetas que se añadieron al enlace utilizando el atributo ses:tags. Para obtener más información sobre la adición de etiquetas a enlaces en sus correos electrónicos, consulte P5. ¿Puedo etiquetar enlaces con identificadores únicos? en la Estadísticas de envío de correo electrónico de Amazon SES FAQs.

Objeto Rendering Failure

El objeto JSON que contiene información acerca de un evento Rendering Failure tiene los campos siguientes.

Nombre del campo	Descripción
templateName	El nombre de la plantilla que se usó para enviar el correo electrónico.
errorMessage	Un mensaje que proporciona más información sobre el error de presentación.

DeliveryDelay objeto

El objeto JSON que contiene información acerca de un evento DeliveryDelay tiene los campos siguientes.

Nombre del campo	Descripción
delayType	El tipo de retraso. Los valores posibles son los siguientes: InternalFailure— Un problema interno de Amazon SES provocó que el mensaje se retrasara. General: se produjo un error genérico durante la conversación SMTP. MailboxFull— El buzón del destinatario está lleno y no puede recibir más mensajes. SpamDetected— El servidor de correo del destinatario ha detectado una gran cantidad de correo electrónico no solicitado de su cuenta. RecipientServerError— Un problema temporal con el servidor de correo electrónico del destinatario impide la entrega del mensaje. IPFailure— La dirección IP que envía el mensaje está siendo bloqueada o restringida por el proveedor de correo electrónico del destinatario. TransientCommunicationFailure— Se produjo un error de comunicación temporal durante la conversación SMTP con el proveedor de correo electrónico del destinatario. BYOIPHostNameLookupUnavailable— Amazon SES no ha podido buscar el nombre de host DNS de sus direcciones IP. Este tipo de retraso únicamente se produce cuando se utiliza Bring Your Own IP. Undetermined: Amazon SES no pudo determinar el motivo del retraso en la entrega. SendingDeferral— Amazon SES ha considerado apropiado aplazar internamente el mensaje.
delayedRecipients	Objeto que contiene información sobre el destinatario del correo electrónico.
expirationTime	La fecha y hora en que Amazon SES dejará de intentar entregar el mensaje. Este valor se muestra en formato ISO 8601.
reportingMTA	La dirección IP del Agente de transferencia de mensajes (MTA) que informó del retraso.
timestamp	Fecha y hora en que se produjo el retraso, que se muestra en formato ISO 8601.

Destinatarios con retraso

El objeto delayedRecipients contiene los siguientes valores.

Nombre del campo	Descripción
emailAddress	La dirección de correo electrónico que provocó el retraso en la entrega del mensaje.
status	El código de estado SMTP asociado al retraso de la entrega.
diagnosticCode	El código de diagnóstico proporcionado por el agente de transferencia de mensajes (MTA) receptor.

Objeto suscripción

El objeto JSON que contiene información acerca de un evento Subscription tiene los campos siguientes.

Nombre del campo	Descripción
contactList	El nombre de la lista de contacto está activado.
timestamp	La fecha y la hora, en formato ISO86 01 (AAAA-MM DDThh -:MM:SS.SZ), en las que el ISP envió la notificación de suscripción.
source	La dirección de correo electrónico desde la que se envió el mensaje (la dirección MAIL FROM del sobre).
newTopicPreferences	Estructura de datos JSON (mapa) que especifica el estado de suscripción de todos los temas de la lista de contactos que indica el estado después de un cambio (contacto suscrito o cancelado).
oldTopicPreferences	Estructura de datos JSON (mapa) que especifica el estado de suscripción de todos los temas de la lista de contactos que indica el estado antes del cambio (contacto suscrito o cancelado).

Preferencias de tema nuevo o antiguo

Los objetos newTopicPreferences y oldTopicPreferences contienen los siguientes valores.

Nombre del campo	Descripción
unsubscribeAll	Especifica si se canceló la suscripción del contacto de todos los temas de la lista de contactos.
topicSubscriptionStatus	Especifica el estado de la suscripción del tema en el campo topicName, lo que indica si actualmente tiene una suscripción para recibir notificaciones de SES sobre el tipo de evento especificado. Los valores posibles son (suscrito) o (cancelado) en el campo. OptInOptOutsubscriptionStatus
topicDefaultSubscriptionStatus	Especifica el estado de suscripción predeterminado del tema en el campo topicName, lo que determina si la suscripción a los nuevos temas que se agreguen al destino del evento se realizará o cancelará de forma predeterminada. Los valores posibles están OptIn(suscrito de forma predeterminada) o OptOut(cancelado de suscripción de forma predeterminada) en el campo. subscriptionStatus