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

Objeto de nivel superior JSON 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 el correo electrónico enviando registros de eventos a Amazon Simple Notification Service en JSON formato.

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 JSON objeto de nivel superior de 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 JSON objeto que contiene información sobre el 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 JSON objeto que contiene información sobre un mail objeto tiene los siguientes campos.

Nombre del campo	Descripción
`timestamp`	La fecha y la hora, en formato ISO86 01 (YYYY-MM DDThh -:MM:SS.SZ), en que se envió el mensaje.
`messageId`	Un identificador único que Amazon SES asignó al mensaje. Amazon te SES devolvió este valor cuando enviaste el mensaje. nota Amazon asignó este identificador de mensajeSES. 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 MAIL FROM dirección del sobre).
`sourceArn`	El nombre del recurso de Amazon (ARN) de la identidad que se utilizó para enviar el correo electrónico. En el caso de la autorización de envío, `sourceArn` es la identidad que el propietario ARN de la identidad autorizó al remitente delegado a utilizar 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 AWS cuenta 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 identificador de mensaje que aparezca en el `headers` campo corresponde al mensaje original que le pasaste a AmazonSES. El identificador de mensaje que Amazon asignó SES posteriormente al mensaje se encuentra en el `messageId` campo del `mail` objeto.
`commonHeaders`	Un mapeo de los encabezados originales del correo electrónico utilizados habitualmente. nota Cualquier identificador de mensaje incluido en el `commonHeaders` campo es el identificador de mensaje que Amazon asignó SES posteriormente al mensaje en el `messageId` campo del `mail` objeto.
`tags`	Una lista de etiquetas asociadas al correo electrónico.

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

Nombre del campo	Descripción
`bounceType`	El tipo de rebote, según lo determine AmazonSES.
`bounceSubType`	El subtipo del rebote, según lo determinado por 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 (YYYY-MM DDThh -:MM:SS.SZ), en las que se envió la notificación de rebote. ISP
`feedbackId`	Un ID único para el rebote.
`reportingMTA`	El valor del campo de. `Reporting-MTA` DSN Este es el valor de la autoridad de transferencia de mensajes (MTA) que intentó realizar la operación de entrega, retransmisión o puerta de enlace descrita en elDSN. nota Este campo solo aparece si se ha adjuntado una notificación del estado de la 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 a DSN está disponible, este es el valor del `Final-Recipient` campo deDSN.

Opcionalmente, si a DSN está asociado al rebote, también pueden estar presentes los siguientes campos.

Nombre del campo	Descripción
`action`	El valor del `Action` campo deDSN. Indica la acción realizada por el MTA denunciante como resultado de su intento de entregar el mensaje a este destinatario.
`status`	El valor del `Status` campo deDSN. 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 el informeMTA. Este es el valor del `Diagnostic-Code` campo deDSN. Este campo puede estar ausente en el DSN (y, por lo tanto, también ausente en elJSON).

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 los rebotes duros y los rebotes suaves que Amazon ya no vuelve a intentar. SES Cuando recibas rebotes marcadosPermanent, debes eliminar las direcciones de correo electrónico correspondientes de tu lista de correo; no podrás enviarlas en el futuro. TransientLos rebotes se envían cuando un mensaje ha sido rechazado varias veces y Amazon SES ha dejado de intentar volver a entregarlo. 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 no SES ha podido determinar un motivo de rebote específico.
`Permanent`	`General`	Amazon SES recibió un fuerte rebote 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 rebote 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 porque tiene un historial reciente de devoluciones por ser una dirección no válida. Para anular la lista de supresión global, consulte Uso de la lista de supresión a SES nivel de cuenta de Amazon.
`Permanent`	`OnAccountSuppressionList`	Amazon SES ha suprimido el envío a esta dirección porque está en la lista de direcciones suprimidas a 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 recibió un buzón de correo rebotado por completo. Es posible que pueda enviar correctamente a este destinatario en el futuro.
`Transient`	`MessageTooLarge`	Amazon SES ha recibido un mensaje con un rebote demasiado grande. Es posible que pueda enviar correctamente a este destinatario si reduce el tamaño del mensaje.
`Transient`	`CustomTimeoutExceeeded`	Amazon no SES ha podido entregar correctamente el correo electrónico en el tiempo especificado por el remitente del correo electrónico. (El mensaje de rebote especificará el motivo de cualquier posible error en el intento de entrega dentro de lo definido)TTL.
`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 un archivo adjunto rechazado. Es posible que pueda enviar correctamente a este destinatario si elimina o cambia el archivo adjunto.

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

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 (YYYY-MM-:MM:SS.SZ DDThh), en las que se envió la notificación de queja. ISP
`feedbackId`	Un ID único para el reclamo.
`complaintSubType`	El subtipo de la queja, según lo determine AmazonSES.

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 `Feedback-Type` campo del informe de comentarios recibido delISP. Contiene el tipo de retroalimentación.
`arrivalDate`	El valor del `Received-Date` campo `Arrival-Date` o del informe de comentarios en formato ISO86 01 (YYYY-MM DDThh -:MM:SS.SZ). Este campo puede estar ausente en el informe (y, por lo tanto, también en el). JSON

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

importante

La mayoría ISPs 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.

JSONlos objetos de esta lista contienen el siguiente campo.

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

Según el sitio web de la Autoridad de Números Asignados en Internet, puede ver los siguientes tipos de quejas en el complaintFeedbackType campoISP, según lo asignado en el informe:

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 esOnAccountSuppressionList, Amazon SES aceptó el mensaje, pero no intentó enviarlo porque estaba en la lista de supresión a nivel de cuenta.

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

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 DDThh -:MM:SS.SZ).
`processingTimeMillis`	El tiempo en milisegundos transcurrido entre el momento en que Amazon SES aceptó la solicitud del remitente y el momento en que Amazon SES pasó el mensaje al servidor de correo del destinatario.
`recipients`	Una lista de los destinatarios a los que corresponden los eventos de entrega.
`smtpResponse`	El mensaje de SMTP respuesta del mando a distancia ISP que aceptó el correo electrónico de AmazonSES. Este mensaje variará según el correo electrónico, el servidor de correo receptor y el receptorISP.
`reportingMTA`	El nombre de host del servidor de SES correo de Amazon que envió el correo.

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

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

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 deja de procesarlo y no intenta entregarlo al servidor de correo del destinatario.

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

Nombre del campo	Descripción
`ipAddress`	La dirección IP del destinatario.
`timestamp`	La fecha y la hora en que se produjo el evento abierto en formato ISO86 01 (YYYY-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 JSON objeto que contiene información sobre un evento tiene los siguientes campos. Click

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 clic en formato ISO86 01 (YYYY-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`	El enlace en el que hizo clic el destinatario. URL
`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 JSON objeto que contiene información sobre un Rendering Failure evento tiene los siguientes campos.

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 JSON objeto que contiene información sobre un DeliveryDelay evento tiene los siguientes campos.

Nombre del campo	Descripción
`delayType`	El tipo de retraso. Los valores posibles son los siguientes: InternalFailure— Un SES problema interno de Amazon provocó que el mensaje se retrasara. General: se produjo un error genérico durante la SMTP conversación. 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— El proveedor de correo electrónico del destinatario bloquea o limita la dirección IP que envía el mensaje. TransientCommunicationFailure— Se produjo un error temporal de comunicación durante la SMTP conversación con el proveedor de correo electrónico del destinatario. BYOIPHostNameLookupUnavailable— Amazon no SES ha podido buscar el DNS nombre de host de tus direcciones IP. Este tipo de retraso únicamente se produce cuando se utiliza Bring Your Own IP. Indeterminado: Amazon SES no ha podido 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 la hora en SES que Amazon 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`	La fecha y la hora en que se produjo el retraso, mostradas 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 SMTP de estado asociado al retraso en la entrega.
`diagnosticCode`	El código de diagnóstico proporcionado por el agente de transferencia de mensajes receptor (MTA).

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

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 (YYYY-MM-:MM:SS.SZ DDThh), en las que se envió la notificación de suscripción. ISP
`source`	La dirección de correo electrónico desde la que se envió el mensaje (la dirección del sobre). MAIL FROM
`newTopicPreferences`	JSONEstructura de datos (mapa) que especifica el estado de suscripción de todos los temas de la lista de contactos e indica el estado después de un cambio (contacto suscrito o cancelado).
`oldTopicPreferences`	Una JSON estructura de datos (mapa) que especifica el estado de suscripción de todos los temas de la lista de contactos e indica el estado anterior al 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 `topicName` campo que indica si está suscrito actualmente para recibir notificaciones sobre el tipo de evento especificadoSES. Los valores posibles son OptIn(suscrito) o OptOut(cancelado) en el campo. `subscriptionStatus`
`topicDefaultSubscriptionStatus`	Especifica el estado de suscripción predeterminado del tema en el `topicName` campo, lo que determina si los nuevos temas que se agreguen al destino del evento se suscribirán o cancelarán 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`

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 de nivel superior JSON

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

DeliveryDelay objeto

Destinatarios con retraso

Objeto suscripción

Preferencias de tema nuevo o antiguo