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

Objeto JSON de nivel superior Objeto Mail Objeto Bounce Objeto Complaint Objeto Delivery Objeto Send Objeto Reject Objeto Open Objeto Click Objeto Rendering Failure Objeto DeliveryDelay Objeto suscripción

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.

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.

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 ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), en la 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 ID de cuenta de AWS de la 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.

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 ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), a la 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.

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).

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`	`CustomTimeoutExceeeded`	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.

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 ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), a la que el ISP envió la notificación de reclamación.
`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 retroalimentación en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ). Este campo puede estar ausente en el informe (y, por lo tanto, también ausente en el JSON).

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

importante

La mayoría de los ISP redactan las direcciones de correo electrónico de los destinatarios que envían reclamaciones. 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.

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.

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.

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 ISO8601 (AAAA-MM-DDThh:mm:ss.sZ).
`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.

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

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.

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 la que se produjo el evento de apertura del correo electrónico, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ).
`userAgent`	El agente del usuario del dispositivo o cliente de correo electrónico que el destinatario utiliza para abrir el correo electrónico.

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 la que se produjo el evento de clic, en formato ISO8601 (AAAA-MM-DDThh:mm:ss.sZ).
`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 Preguntas frecuentes sobre métricas de envío de correo electrónico de Amazon SES.

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.

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 mensajes adicionales. SpamDetected: el servidor de correo del destinatario detectó una gran cantidad de correos electrónicos no solicitados de su cuenta. RecipientServerError: un problema temporal con el servidor de correo electrónico del destinatario impide la entrega del mensaje. IPFailure: el proveedor de correo electrónico del destinatario bloquea o limita la dirección IP que envía el mensaje. TransientCommunicationFailure: hubo un error temporal de comunicación durante la conversación SMTP con el proveedor de correo electrónico del destinatario. BYOIPHostNameLookupUnavailable: Amazon SES no pudo buscar el nombre de anfitrión DNS para 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 de forma interna 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.

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.

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 ISO8601 (AAAA-MM-DDThh:mm:ss.sZ), cuando 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).

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 del campo `subscriptionStatus` son OptIn (suscripción realizada) u OptOut (suscripción cancelada).
`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 son OptIn (suscripción realizada de forma predeterminada) u OptOut (suscripción cancelada de forma predeterminada) en el campo `subscriptionStatus`.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Interpretación de datos de eventos desde Amazon SNS

Ejemplos de registros de evento

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

Temas de esta sección:

Objeto JSON de nivel superior

Objeto Mail

nota

nota

nota

Objeto Bounce

nota

Destinatarios con rebote

Tipos de rebote

Objeto Complaint

Destinatarios con reclamaciones

importante

Tipos de reclamación

Subtipos de reclamaciones

Objeto Delivery

Objeto Send

Objeto Reject

Objeto Open

Objeto Click

Objeto Rendering Failure

Objeto DeliveryDelay

Destinatarios con retraso

Objeto suscripción

Preferencias de tema nuevo o antiguo