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. # Monitoreo de la actividad de envío de Amazon SES Amazon SES ofrece métodos para monitorear la actividad de envío mediante eventos, métricas y estadísticas. Un evento es algo que ocurre en relación con la actividad de envío que ha especificado para que se rastree como métrica. Un métrica representa una serie de puntos de datos ordenados por tiempo que representa los valores de un tipo de evento monitoreado que produce estadísticas. Las estadísticas son agregaciones de los datos de las métricas correspondientes a un periodo de tiempo especificado, incluso hasta el presente. Estos métodos de supervisión lo ayudan a realizar un seguimiento de medidas importantes, como, por ejemplo, las tasas de rebotes, reclamos y rechazos de su cuenta. Unas tasas de rebotes y reclamos demasiado altas podrían comprometer su capacidad de enviar correos electrónicos a través de SES. Estos métodos también se pueden utilizar para medir las tasas a las que los clientes interactúan con los correos electrónicos que envía, lo que lo ayuda a identificar las tasas generales de apertura y clics mediante la publicación de eventos y los dominios personalizados asociados con los conjuntos de configuración. Consulte [Configuración de dominios personalizados para gestionar seguimiento de mensajes abiertos y en los que se ha hecho clic](configure-custom-open-click-domains.md). El primer paso para configurar la supervisión es identificar los tipos de eventos de correo electrónico relacionados con la actividad de envío que desea medir y monitorear mediante SES. Puede elegir los siguientes tipos de eventos para monitorear en SES: + **Send** (Envío): la solicitud de envío se realizó de forma correcta y Amazon SES intentará entregar el mensaje al servidor de correo del destinatario. (Si se está utilizando la supresión global o de nivel de cuenta, SES lo seguirá contando como un envío, pero la entrega se suprimirá). + **RenderingFailure**: no se envió el correo electrónico debido a un problema con la presentación de la plantilla. Este tipo de evento se puede producir cuando faltan datos en la plantilla o cuando los parámetros y los datos de la plantilla no coinciden. (Este tipo de evento solo se produce cuando envía correo electrónico con las operaciones de la API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) o [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html)). + **Reject** (Rechazo): Amazon SES aceptó el correo electrónico, pero determinó que contenía un virus y no intentó entregarlo al servidor de correo del destinatario. + **Delivery** (Entregados): Amazon SES entregó correctamente el correo electrónico al servidor de correo del destinatario. + **Rebotar**: una *devolución permanente* que el servidor de correo del destinatario ha rechazado el correo electrónico de forma permanente. (Los *rebotes temporales* solo se incluyen cuando SES ya no vuelve a intentar entregar el correo electrónico. Por lo general, indican un error en la entrega, si bien en algunos casos se puede devolver un rebote temporal aunque el correo haya llegado correctamente a la bandeja de entrada del destinatario. Esto suele ocurrir cuando el destinatario envía una respuesta automática de fuera de la oficina. Puede obtener más información sobre los rebotes temporales en este artículo de [AWS re:Post](https://repost.aws/knowledge-center/ses-understand-soft-bounces).) + **Complaint (Reclamo)**: el correo electrónico se entregó correctamente al servidor de correo del destinatario, pero el destinatario lo marcó como spam. + **DeliveryDelay**: el correo electrónico no se pudo entregar al servidor de correo del destinatario porque se produjo un problema temporal. Pueden producirse retrasos en la entrega, por ejemplo, si la bandeja de entrada del destinatario está llena o el servidor de recepción de email experimenta un problema transitorio. + **Subscriptions** (Suscripciones): el correo electrónico se entregó correctamente, pero el destinatario actualizó las preferencias de suscripción al hacer clic en `List-Unsubscribe` en el encabezado del correo electrónico o el enlace `Unsubscribe` del pie de página. + **Open** (Abiertos): el destinatario recibió el mensaje y lo abrió en su cliente de correos electrónicos. + **Clic**: el destinatario hizo clic en uno o varios enlaces incluidos en el correo electrónico. Puede monitorear los eventos de envío de correo electrónico de varias maneras. El método que elija dependerá del tipo de evento que desee supervisar, la pormenorización y el nivel de detalle con los que quiera supervisarlos, y la ubicación en la que desea que SES publique los datos. Debe utilizar las notificaciones de retroalimentación o la publicación de eventos para realizar un seguimiento de los eventos de rebotes y reclamaciones. También puede optar por utilizar varios métodos de monitorización. Las características de cada método se indican en la siguiente tabla. | Método de monitorización | Eventos que puede monitorizar | Cómo acceder a los datos | Nivel de detalle | Granularity (Grado de detalle) | | --- | --- | --- | --- | --- | | Consola de SES | Estado de la cuenta, correos electrónicos enviados, cuota utilizada, solicitudes de envío satisfactorias, rechazos, rebotes y reclamos *(historial reciente de la reputación actual)* | [Página del panel de la cuenta](monitor-sending-activity-console.md) en la consola de SES | Recuento y porcentaje | En toda la cuenta de AWS | | Consola de SES | Estado de la cuenta, correos electrónicos enviados, rebotes y reclamos *(reputación actual)* | [Página de métricas de reputación](reputation-dashboard-dg.md) en la consola de SES | Solo tarifas calculadas | En toda la cuenta de AWS | | Virtual Deliverability Manager | Estadísticas de cuentas, ISP, identidades de envío, conjuntos de configuración, envíos, entregas, quejas, rebotes transitorios y permanentes, aperturas y clics, capacidad de entrega y reputación. | [Panel Virtual Deliverability Manager](vdm-dashboard.md) en la consola de SES [Asesor de Virtual Deliverability Manager](vdm-advisor.md) en la consola de SES | Recuento y porcentaje | En toda la cuenta de AWS | | API de SES | Entregas, rebotes, reclamaciones y rechazos | [https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html) Operación de la API | Recuento solo | En toda la cuenta de AWS | | Consola de Amazon CloudWatch | Envíos, entregas, aperturas, clics, devoluciones, tasa de devoluciones, reclamaciones, tasa de reclamaciones, rechazos, errores de representación e IP en la lista negra. | Consola de CloudWatch Algunas métricas no aparecen en CloudWatch hasta que se produce el evento asociado. Por ejemplo, las métricas de rebote no aparecen en CloudWatch hasta que envíe rebotes al menos a un correo electrónico o hasta que genere un evento de rebote simulado mediante el [simulador de buzón de correo](send-an-email-from-console.md). | Recuento solo | En toda la cuenta de AWS | | Notificaciones de retroalimentación | Entregas, rebotes y reclamaciones | Notificación de Amazon SNS (entregas, rebotes y reclamos) o correo electrónico (solo rebotes y reclamos). Consulte [Configuración de notificaciones de eventos](monitor-sending-activity-using-notifications.md). | Detalles de cada evento | En toda la cuenta de AWS | | Publicación de eventos | Envíos, entregas, abiertos, clics, rebotes, reclamaciones, rechazos y errores de representación. | Amazon CloudWatch o Amazon Data Firehose o bien mediante una notificación de Amazon SNS; consulte [Supervisar el envío de correo electrónico mediante la publicación de eventos](monitor-using-event-publishing.md). *(Se aplican cargos adicionales; consulte [Price per metric for CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing)).* | Detalles de cada evento | Detallado (basado en características de correo electrónico definibles por el usuario) | | Publicación de eventos mediante dominios personalizados asociados a conjuntos de configuración: [más información](configure-custom-open-click-domains.md) | Abra y haga clic en Tracking (Seguimiento). | Amazon CloudWatch o Amazon Data Firehose o bien mediante una notificación de Amazon SNS. *(Se aplican cargos adicionales; consulte [Price per metric for CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing)).* | Detalles de cada evento. | Detallado (basado en características de correo electrónico definibles por el usuario) | **nota** Las métricas medidas por eventos de envío de correo electrónico pueden no coincidir totalmente con sus cuotas de envío. Esta discrepancia puede estar causada por rebotes y rechazos de correo electrónico o por el uso del simulador de bandeja de correo de SES. Para saber lo cerca que está de sus cuotas de envío, consulte [Monitoreo de las cuotas de envío](manage-sending-quotas-monitor.md). **Topics** + [Monitoreo de sus estadísticas de envío utilizando la consola de Amazon SES](monitor-sending-activity-console.md) + [Monitoreo de sus estadísticas de uso mediante la API de Amazon SES](monitor-sending-activity-api.md) + [Monitoreo del envío de correo electrónico mediante la publicación de eventos de Amazon SES](monitor-using-event-publishing.md) # Monitoreo de sus estadísticas de envío utilizando la consola de Amazon SES Desde las páginas **Panel de la cuenta**, **Métricas de reputación** y **Configuración de SMTP** de la consola de Amazon SES, puede monitorear todos sus envíos de correo electrónico, uso, estadísticas, configuración de SMTP, estado general de la cuenta y métricas de reputación. En las secciones siguientes se describen las métricas y estadísticas que se proporcionan en cada una de estas páginas de la consola. Debe tenerse en cuenta que aunque las páginas de la consola de [Panel de cuenta](#account-dashboard) y [Métricas de reputación](#reputation-metrics) contienen métricas de rebotes y reclamaciones, hay una sutil diferencia entre cada uno de estos dos conjuntos de tasas de rebote y de reclamaciones, como se explica a continuación: + **Página del panel de la cuenta**: en función del intervalo de fechas seleccionado, puede ver cuáles fueron las tasas de rebote y reclamos en el pasado que muestran la progresión de la métrica del cambio previo al presente. + **Página de métricas de reputación**: tasas de rebote y quejas basadas en los últimos datos obtenidos al calcular tu media histórica general a un nivel alto (no debes confundirlo con tu bounce/complaint tasa normal, que corresponde a bounce/complaint eventos precisos a medida que ocurren en tiempo real, como se muestra en la página del **panel de control de la cuenta**). Como ejemplo sencillo para comparar las tasas de rebote o de reclamaciones entre la página de **Métricas de reputación** y la página del **Panel de la cuenta**, digamos que la tasa fue del 2 % ayer y ahora es del 1 %, en la página de **Métricas de reputación**, solo verá la tasa actual del 1 %, pero en la página del **Panel de la cuenta**, los gráficos representarán la progresión trazada que muestra una tasa del 2 % para ayer y del 1 % para hoy. ## Panel de cuenta Puede monitorear el número de correos electrónicos enviados desde la cuenta, así como el porcentaje de la cuota de envío que se ha utilizado, directamente desde la página del **Account dashboard** (Panel de la cuenta) de la consola de SES en el panel *Daily email usage* (Uso diario del correo electrónico). Las tasas de entrega y de rechazo de la cuenta se pueden monitorear en el panel *Envío de estadísticas*, así como otros factores clave relacionados con el envío de correo electrónico en los siguientes paneles: + **Límites de envío**: contiene las siguientes cuotas aplicables al envío de correo electrónico a través de SES: + *Cuota de envío diaria*: el número máximo de correos electrónicos que puede enviar en un periodo de 24 horas. + *Velocidad máxima de envío*: el número máximo de correos electrónicos que se puede enviar desde la cuenta por segundo. + **Estado de la cuenta**: el estado de la cuenta de SES: + `Healthy`: no hay problemas relacionados con la reputación que afecten actualmente a la cuenta. + `Under review`: se han identificado problemas potenciales con la cuenta de SES, la cuenta se está revisando mientras trabaja para corregir los problemas. + `Paused`: la capacidad de la cuenta para enviar correo electrónico actualmente está suspendida debido a un problema con el correo electrónico enviado desde la cuenta. Cuando se haya corregido el problema, puede solicitar que se reanude la capacidad de la cuenta para enviar correo electrónico. + **Uso diario de correo electrónico**: para comprobar el uso diario para asegurarse de que no se acerca a los límites de envío: + *Correos electrónicos enviados*: número total de correos electrónicos enviados en un periodo de 24 horas. + *Envíos restantes*: número total de correos electrónicos restantes disponibles para enviarse en un periodo de 24 horas. + *Cuota de envío utilizada*: porcentaje de la cuota de envío diaria utilizada. + ‎**Estadísticas de envío**: se compone de gráficos que muestran la progresión de cuatro métricas esenciales en un conjunto de puntos de datos ordenados por horas que representan los valores de un tipo de evento supervisado que produce estadísticas para el intervalo de fechas seleccionado mediante un periodo de agregación ‎de *1 hora*. Puede seleccionar un intervalo de datos con valores iniciales desde `Last 1 day` a `Last 14 days` para filtrar los gráficos a continuación: + *Envíos*: la suma de las solicitudes de envío de correo electrónico correctas para el intervalo de fechas seleccionado. + *Rechazos*: tasa media de solicitudes de envío rechazadas por SES en función de `Rejects/Sends * 100` para el intervalo de fechas seleccionado. + *Rebotes*: tasa media derivada de las métricas de reputación del remitente histórico general que muestra la progresión del intervalo de fechas seleccionado. + *Reclamaciones*: tasa media derivada de las métricas de reputación del remitente histórico general que muestra la progresión del intervalo de fechas seleccionado. Cada uno de estos gráficos contiene un CloudWatch botón **Ver en** que se abre la métrica correspondiente en la CloudWatch consola de Amazon, lo que permite ver datos detallados, realizar cálculos métricos personalizados y [crear alarmas CloudWatch](reputationdashboard-cloudwatch-alarm.md). ## Métricas de reputación Además de las tasas de rebote y reclamaciones descritas, la página de **Reputation metrics** (Métricas de reputación) también proporciona otra visibilidad de alto nivel de los factores clave que afectan a la reputación que constan de los siguientes paneles: + **Resumen**: proporciona información general del estado de la reputación. + *Estado*: estado general de la reputación en función de las tasas históricas de rebote y reclamación: + `Healthy`: ambas métricas se encuentran dentro de los niveles normales. + `Under review`: una o ambas métricas han provocado automáticamente que la cuenta se sitúe en revisión. + `At risk`: una o ambas métricas han alcanzado niveles poco saludables y la capacidad de la cuenta para enviar correos electrónicos puede estar en riesgo. + *Correos electrónicos enviados (últimas 24 horas)*: el número total de correos electrónicos enviados en un periodo de 24 horas. + *Envíos restantes*: número total de correos electrónicos restantes disponibles para enviarse en un periodo de 24 horas. + *Cuota de envío utilizada*: porcentaje de la cuota de envío diaria utilizada. + **Contenido de la pestaña de nivel de cuenta:** + Bounce rate (Tasa de rebotes) + *Estado*: indica el estado de la tasa de rebote utilizando los mismos valores que se describen para el panel de resumen. + *Tasa de rebote histórica*: porcentaje de correos electrónicos de la cuenta que dieron como resultado una devolución permanente calculada a partir del promedio histórico global basado en un volumen representativo que representa las prácticas de envío típicas. + Complaint rate (Tasa de reclamaciones) + *Estado*: indica el estado de la tasa de reclamación utilizando los mismos valores que se describen para el panel de resumen. + *Tasa de rebote histórica*: porcentaje de correos electrónicos de la cuenta que dieron como resultado que los destinatarios los notifiquen como spam calculado del promedio histórico global en función del volumen representativo de las prácticas de envío típicas. + **Contenido de la pestaña del conjunto de configuración:** + Reputación por conjunto de configuración + *Conjunto de configuración*: le permite escribir o seleccionar un conjunto de configuración que tenga habilitadas las métricas de reputación para que pueda ver los datos de resumen, rebote y reclamación basados en los correos electrónicos enviados mediante el conjunto de configuración seleccionado. Los paneles resultantes que aparecen después de seleccionar un conjunto de configuración son los mismos que los descritos anteriormente para la página métricas de reputación, excepto que solo se basan en el correo electrónico enviado con el conjunto de configuración seleccionado en comparación con las métricas de envío globales de nivel de cuenta. ## Configuración de SMTP En esta página se enumeran las configuraciones SMTP necesarias para utilizar la interfaz SMTP de Amazon SES, ya sea a través de la API de SES o mediante programación, y se proporcionan enlaces para crear y administrar sus credenciales de SMTP: + **Configuración SMTP**: si desea utilizar un lenguaje de programación, servidor de correo electrónico o aplicación habilitados para SMTP para conectarse a la interfaz SMTP de Amazon SES, se proporciona la siguiente información: + Punto de enlace de SMTP + Puerto STARTTLS + seguridad de la capa de transporte (TLS) + Puerto de contenedor TLS + Enlaces de autenticación proporcionados para la creación y la administración de credenciales de SMTP e IAM ## Uso de la consola para monitorear las métricas de envío y reputación Los siguientes procedimientos le permitirán comenzar a explorar las métricas de envío y reputación mediante la página del **Account dashboard** (Panel de cuenta) para las métricas basadas en el historial reciente (hasta 14 días) o utilizar la página de **Reputation metrics** (Métricas de reputación) para obtener métricas basadas en el historial general hasta el momento actual. **Para ver los correos electrónicos enviados y la cuota de envío utilizada** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, elija **Account dashboard** (Panel de la cuenta). Las estadísticas de uso se muestran en la sección **Daily email usage** (Uso diario de correo electrónico). **Para ver el recuento de envíos, tasas de rechazos, rebotes y reclamos** 1. En el panel de navegación, elija **Account dashboard** (Panel de la cuenta). 1. En la sección **Sending Statistics** (Estadístics de envío), utilice el menú desplegable **Date range** (Intervalo de fechas) a fin de seleccionar un valor inicial para un intervalo de fechas y filtrar los cuatro gráficos directamente debajo de la sección **Sending statistics** (Estadísticas de envío). 1. En función del intervalo de fechas seleccionado, puede ver cuáles fueron las tasas de rebote y reclamos en el pasado que muestran la progresión de la métrica del cambio previo al presente. 1. En cualquiera de los gráficos, pulsa el CloudWatch botón **Ver en** para abrir la métrica correspondiente en la CloudWatch consola de **Amazon**, donde podrás ver datos detallados, realizar cálculos métricos personalizados y [crear alarmas de monitorización CloudWatch](reputationdashboard-cloudwatch-alarm.md). **Para consultar las tasas de rebotes y reclamaciones históricas** 1. En el panel de navegación, elija **Reputation metrics** (Métricas de reputación). 1. En el panel **Bounce rate** (Tasa de rebotes) puede ver el porcentaje de correos electrónicos enviados desde la cuenta que han dado lugar a un rechazo permanente y en **Complaint rate** (Tasa de reclamaciones) puede consultar el porcentaje de correos electrónicos enviados desde la cuenta que han dado lugar a que los destinatarios los notifiquen como spam; ambas métricas se calculan a partir de un volumen representativo de correo electrónico basado en las prácticas de envío típicas. 1. En cualquiera de los paneles, pulse el CloudWatch botón **Ver en** para abrir la métrica correspondiente en la CloudWatch consola de **Amazon**, donde podrá ver datos detallados, realizar cálculos métricos personalizados y [crear alarmas de monitorización CloudWatch](reputationdashboard-cloudwatch-alarm.md). **Para consultar las métricas de reputación por conjuntos de configuración** 1. En el panel de navegación, elija **Reputation metrics** (Métricas de reputación). 1. En la página de métricas de reputación, seleccione la pestaña **Configuration set** (Conjunto de configuración). 1. En el panel **Reputation by configuration set** (Reputación por conjunto de configuración)‎, haga clic dentro del **Configuration set** (Conjunto de configuración) y comience a escribir o seleccione un conjunto de configuración que tenga habilitadas las métricas de reputación. 1. Después de seleccionar el conjunto de configuración, cargará los paneles de resumen, rebote y reclamación que muestran métricas basadas solo en el correo electrónico enviado con el conjunto de configuración seleccionado. # Monitoreo de sus estadísticas de uso mediante la API de Amazon SES La API de Amazon SES proporciona la operación `GetSendStatistics`, que devuelve información acerca del uso que se hace del servicio. Le recomendamos que compruebe las estadísticas de envío con regularidad, a fin de que pueda realizar ajustes si es necesario. Si llama a la operación `GetSendStatistics`, recibe una lista de puntos de datos que representan las dos últimas semanas de su actividad de envío. Cada punto de datos de esta lista representa 15 minutos de actividad y contiene la siguiente información para ese periodo: + El número de rebotes permanentes + El número de reclamaciones + El número de intentos de entrega (corresponde al número de correos electrónicos que haya enviado) + El número de intentos de envío rechazados + Una marca de tiempo para el periodo de análisis Para obtener una descripción completa de la operación `GetSendStatistics`, consulte la [Referencia de la API de Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html). En esta sección, encontrará los temas siguientes: + [Llamar a la operación de la `GetSendStatistics` API mediante el AWS CLI](#monitor-sending-activity-api-cli) + [Llamada a la operación `GetSendStatistics` mediante programación](#monitor-sending-activity-api-sdk) ## Llamar a la operación de la `GetSendStatistics` API mediante el AWS CLI La forma más sencilla de llamar a la operación `GetSendStatistics` de la API consiste en utilizar la [AWS Command Line Interface](https://aws.amazon.com/cli) (AWS CLI). **Para llamar a la operación de `GetSendStatistics` API mediante el AWS CLI** 1. Si aún no lo ha hecho, descargue e instale la AWS CLI. Para obtener más información, consulte la sección "[Instalación del AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)" en la *Guía del AWS Command Line Interface usuario*. 1. Si aún no lo ha hecho, configúrelo AWS CLI para que utilice sus AWS credenciales. Para obtener más información, consulte [la sección "Configuración del AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)" en la *Guía del AWS Command Line Interface usuario*. 1. En la línea de comandos, ejecute el comando siguiente: ``` aws ses get-send-statistics ``` Si AWS CLI está configurado correctamente, verá una lista de estadísticas de envío en formato JSON. Cada objeto JSON incluye estadísticas de envío agregadas para un periodo de 15 minutos. ## Llamada a la operación `GetSendStatistics` mediante programación También puede llamar a la `GetSendStatistics` operación mediante AWS SDKs. Esta sección incluye ejemplos de código AWS SDKs para Go, PHP, Python y Ruby. Elija uno de los siguientes enlaces para ver ejemplos de código para dicho lenguaje: + [Ejemplo de código para el AWS SDK para Go](#code-example-getsendstatistics-golang) + [Ejemplo de código para el AWS SDK para PHP](#code-example-getsendstatistics-php) + [Ejemplo de código para el AWS SDK para Python (Boto)](#code-example-getsendstatistics-python) + [Ejemplo de código para el AWS SDK para Ruby](#code-example-getsendstatistics-ruby) **nota** En estos ejemplos de código se supone que has creado un archivo de credenciales AWS compartidas que contiene tu identificador de clave de AWS acceso, tu clave de acceso AWS secreta y tu AWS región preferida. Para obtener más información, consulte [Archivos de configuración y credenciales compartidas](https://docs.aws.amazon.com/credref/latest/refdocs/creds-config-files.html). ### Llamar `GetSendStatistics` usando el AWS SDK para Go ``` 1. package main 2. 3. import ( 4. "fmt" 5. 6. //go get github.com/aws/aws-sdk-go/... 7. "github.com/aws/aws-sdk-go/aws" 8. "github.com/aws/aws-sdk-go/aws/session" 9. "github.com/aws/aws-sdk-go/service/ses" 10. "github.com/aws/aws-sdk-go/aws/awserr" 11. ) 12. 13. const ( 14. // Replace us-west-2 with the AWS Region you're using for Amazon SES. 15. AwsRegion = "us-west-2" 16. ) 17. 18. func main() { 19. 20. // Create a new session and specify an AWS Region. 21. sess, err := session.NewSession(&aws.Config{ 22. Region:aws.String(AwsRegion)}, 23. ) 24. 25. // Create an SES client in the session. 26. svc := ses.New(sess) 27. input := &ses.GetSendStatisticsInput{} 28. 29. result, err := svc.GetSendStatistics(input) 30. 31. // Display error messages if they occur. 32. if err != nil { 33. if aerr, ok := err.(awserr.Error); ok { 34. switch aerr.Code() { 35. default: 36. fmt.Println(aerr.Error()) 37. } 38. } else { 39. // Print the error, cast err to awserr.Error to get the Code and 40. // Message from an error. 41. fmt.Println(err.Error()) 42. } 43. return 44. } 45. 46. fmt.Println(result) 47. } ``` ### Llamar `GetSendStatistics` mediante el AWS SDK para PHP ``` 1. 'latest', 16. 'region' => REGION 17. )); 18. 19. try { 20. $result = $client->getSendStatistics([]); 21. echo($result); 22. } catch (Exception $e) { 23. echo($e->getMessage()."\n"); 24. } 25. 26. ?> ``` ### Llamar `GetSendStatistics` mediante el AWS SDK para Python (Boto) ``` 1. import boto3 #pip install boto3 2. import json 3. from botocore.exceptions import ClientError 4. 5. client = boto3.client('ses') 6. 7. try: 8. response = client.get_send_statistics( 9. ) 10. except ClientError as e: 11. print(e.response['Error']['Message']) 12. else: 13. print(json.dumps(response, indent=4, sort_keys=True, default=str)) ``` ### Llamar `GetSendStatistics` mediante el AWS SDK para Ruby ``` 1. require 'aws-sdk' # gem install aws-sdk 2. require 'json' 3. 4. # Replace us-west-2 with the AWS Region you're using for Amazon SES. 5. awsregion = "us-west-2" 6. 7. # Create a new SES resource and specify a region 8. ses = Aws::SES::Client.new(region: awsregion) 9. 10. begin 11. 12. resp = ses.get_send_statistics({ 13. }) 14. puts JSON.pretty_generate(resp.to_h) 15. 16. # If something goes wrong, display an error message. 17. rescue Aws::SES::Errors::ServiceError => error 18. puts error 19. 20. end ``` # Monitoreo del envío de correo electrónico mediante la publicación de eventos de Amazon SES Para que pueda realizar un seguimiento detallado de sus envíos de correo electrónico, puede configurar Amazon SES para que publique los *eventos de envío de correos electrónicos* a Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service o EventBridge Amazon en función de las características que defina. Puede realizar un seguimiento de varios tipos de eventos de envío de correo electrónico, incluidos envíos, entregas, aperturas, clics, rebotes, quejas, rechazos, fallos de representación y retrasos en la entrega. Esta información puede resultar útil para fines operativos y de análisis. Por ejemplo, puede publicar sus datos de envío de correo electrónico CloudWatch y crear paneles que hagan un seguimiento del rendimiento de sus campañas de correo electrónico, o puede utilizar Amazon SNS para enviarle notificaciones cuando se produzcan determinados eventos. ## Funcionamiento de la publicación de eventos con conjuntos de configuración y etiquetas de mensajes Para utilizar la publicación de eventos, primero debe configurar uno o varios *conjuntos de configuración*. Un conjunto de configuración especifica dónde publicar los eventos y qué eventos publicar. Luego, cada vez que envía un correo electrónico, proporciona el nombre del conjunto de configuraciones y una o más *etiquetas de mensaje*, en forma de name/value pares, para clasificar el correo electrónico. Por ejemplo, si promociona libros, puede denominar una etiqueta del mensaje como *género* y asignarle un valor de *ciencia ficción* o *western*, cuando envíe un correo electrónico para la campaña asociada. En función de la interfaz de envío de correo electrónico que utilice, tendrá que proporcionar la etiqueta del mensaje como parámetro al campo [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) de la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) de la API o agregar la etiqueta de mensaje al encabezado de correo electrónico [https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers) específico de SES. Para obtener más información acerca de los conjuntos de configuración, consulte [Uso de conjuntos de configuración en Amazon SES](using-configuration-sets.md). Además de las etiquetas de mensajes que especifique, SES también agrega *etiquetas automáticas* a los mensajes que se envían. No necesita realizar ningún paso adicional para utilizar etiquetas automáticas. En la siguiente tabla, se muestran las etiquetas automáticas que se aplican automáticamente a los mensajes que se envían con SES. **Etiquetas automáticas de SES** | Nombre de etiqueta automática | Description (Descripción) | | --- | --- | | ses:caller-identity | Identidad de IAM del usuario de SES que ha enviado el correo electrónico. | | ses:configuration-set | El nombre del conjunto de configuración asociado al correo electrónico. | | ses:from-domain | El dominio de la dirección del remitente ("From"). | | ses:outgoing-ip | Dirección IP que SES ha utilizado para enviar el correo electrónico. | | ses:source-ip | La dirección IP que el intermediario utilizó para enviar el correo electrónico. | | ses:source-tls-version | La versión del protocolo TLS que el intermediario usó para enviar el correo electrónico. | | ses:outgoing-tls-version | Versión del protocolo TLS que el intermediario ha utilizado para enviar el correo electrónico. | ## Retroalimentación detallada de las campañas de correo electrónico `ses:feedback-id-` es una etiqueta de mensaje opcional que se puede considerar híbrida o semiautomática. Si bien es similar a las etiquetas automáticas descritas en la sección anterior, la diferencia es que hay que agregarla manualmente y usar la clave de prefijo `ses:`. Puede utilizar hasta dos de estas etiquetas definidas como `ses:feedback-id-a` y `ses:feedback-id-b`. Cuando se especifican estas etiquetas, SES las agrega automáticamente al encabezado `Feedback-ID` estándar que se utiliza para proporcionar estadísticas de entrega, como las tasas de quejas y spam, dentro de un bucle de retroalimentación (FBL); consulte [Bucles de retroalimentación](faqs-enforcement.md#cm-feedback-loop). El `Feedback-ID` encabezado está compuesto por el identificador, el *SESInternalID*, que utiliza SES para recopilar la información sobre las quejas, y la etiqueta estática, *AmazonSES, que identifica a SES* como la plataforma de envío, por ejemplo: `FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))` Estas etiquetas opcionales de identificación de la retroalimentación se ofrecen como una forma de generar retroalimentación detallada; por ejemplo, para los mensajes que se envían en el marco de una campaña de correo electrónico. Puede utilizar `ses:feedback-id-` especificándolo como etiqueta de mensaje en el campo [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) de la solicitud de la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html), como se muestra en el siguiente ejemplo: ``` { "FromEmailAddress": "noreply@example.com", "Destination": { "ToAddresses": [ "customer@example.net" ] }, "Content": { "Simple": { "Subject": { "Data": "Hello and welcome" }, "Body": { "Text": { "Data": "Lorem ipsum dolor sit amet." }, "Html": { "Data": "Lorem ipsum dolor sit amet." } } } }, "EmailTags": [ { "Name": "ses:feedback-id-a", "Value": "new-members-campaign" }, { "Name": "ses:feedback-id-b", "Value": "football-campaign" } ], "ConfigurationSetName": "football-club" } ``` Si lo envía en formato sin procesar, es preciso agregar la etiqueta de mensaje `ses:feedback-id-` al encabezado [`X-SES-MESSAGE-TAGS`](event-publishing-send-email.md#event-publishing-using-ses-headers) específico de SES. La etiqueta de `ses:feedback-id-` mensaje también se puede rastrear en Amazon CloudWatch especificándola como fuente de CloudWatch valor como cualquier otra etiqueta de mensaje, consulte [Añadir un destino de CloudWatch evento](event-publishing-add-event-destination-cloudwatch.md#event-publishing-add-event-destination-cloudwatch-add) *(Se aplican cargos adicionales, consulte [Precio por métrica para](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing)) CloudWatch.* ## Cómo utilizar la publicación de eventos Las siguientes secciones contienen la información necesaria para configurar y utilizar la publicación de eventos de SES. + [Configuración de la publicación de eventos](monitor-sending-using-event-publishing-setup.md) + [Trabajar con datos de eventos](working-with-event-data.md) ## Terminología de publicación de eventos En la siguiente lista se definen los términos relacionados con la publicación de eventos de SES. **Evento de envío de correo electrónico** Información asociada con el resultado de un correo electrónico que envía a SES. Los eventos de envío incluyen lo siguiente: + **Send** (Envío): la solicitud de envío se realizó de forma correcta y Amazon SES intentará entregar el mensaje al servidor de correo del destinatario. (Si se está utilizando la supresión global o de nivel de cuenta, SES lo seguirá contando como un envío, pero la entrega se suprimirá). + **RenderingFailure**— El correo electrónico no se envió debido a un problema de representación de la plantilla. Este tipo de evento se puede producir cuando faltan datos en la plantilla o cuando los parámetros y los datos de la plantilla no coinciden. (Este tipo de evento solo se produce cuando envía correo electrónico con las operaciones de la API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) o [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html)). + **Reject** (Rechazo): Amazon SES aceptó el correo electrónico, pero determinó que contenía un virus y no intentó entregarlo al servidor de correo del destinatario. + **Delivery** (Entregados): Amazon SES entregó correctamente el correo electrónico al servidor de correo del destinatario. + **Rebotar**: una *devolución permanente* que el servidor de correo del destinatario ha rechazado el correo electrónico de forma permanente. (Los *rebotes suaves* solo se incluyen cuando SES ya no vuelve a intentar entregar el correo electrónico. Por lo general, estos rebotes suaves indican un error en la entrega, aunque en algunos casos se puede devolver un rebote suave incluso cuando el correo llega correctamente a la bandeja de entrada del destinatario. Esto suele ocurrir cuando el destinatario envía una respuesta out-of-office automática. Obtén más información sobre los rebotes suaves en este artículo de [AWS Re:post](https://repost.aws/knowledge-center/ses-understand-soft-bounces).) + **Complaint (Reclamo)**: el correo electrónico se entregó correctamente al servidor de correo del destinatario, pero el destinatario lo marcó como spam. + **DeliveryDelay**— No se pudo entregar el correo electrónico al servidor de correo del destinatario porque se produjo un problema temporal. Pueden producirse retrasos en la entrega, por ejemplo, si la bandeja de entrada del destinatario está llena o el servidor de recepción de email experimenta un problema transitorio. + **Subscriptions** (Suscripciones): el correo electrónico se entregó correctamente, pero el destinatario actualizó las preferencias de suscripción al hacer clic en `List-Unsubscribe` en el encabezado del correo electrónico o el enlace `Unsubscribe` del pie de página. + **Open** (Abiertos): el destinatario recibió el mensaje y lo abrió en su cliente de correos electrónicos. + **Clic**: el destinatario hizo clic en uno o varios enlaces incluidos en el correo electrónico. **Conjunto de configuraciones** Conjunto de reglas que define el destino en el que SES publica los eventos de envío de correo electrónico y los tipos de eventos de envío de correo electrónico que se desea publicar. Cuando envíe un correo electrónico que desea utilizar con la publicación de eventos, especifique el conjunto de configuración que asociar con el correo electrónico. **Destino del evento** Un AWS servicio en el que se publican los eventos de envío de correos electrónicos de SES. Cada destino de eventos que configure pertenece a uno y solo a un conjunto de configuración. **Etiqueta de mensajes** Un name/value par que se utiliza para clasificar un correo electrónico con el fin de publicar un evento. Los ejemplos son *campaña/libro* y *campaña/ropa*. Cuando se envía un correo electrónico, se especifica la etiqueta del mensaje como parámetro a la llamada a la API o como encabezado de correo electrónico específico de SES. **Etiqueta automática** Las etiquetas de mensajes que se incluyen automáticamente en informes de publicación de eventos. Hay una etiqueta automática para el nombre del conjunto de configuración, el dominio de la dirección de origen, la dirección IP de salida del intermediario, la dirección IP saliente de SES y la identidad de IAM del intermediario. # Configuración de publicación de eventos de Amazon SES En esta sección se describe lo que debe hacer para configurar Amazon SES para que publique sus eventos de envío de correo electrónico en los siguientes AWS servicios: + Amazon CloudWatch + Amazon Data Firehose + Amazon Pinpoint + Amazon Simple Notification Service (Amazon SNS) Los siguientes pasos necesarios para configurar la publicación de eventos se tratan en los siguientes temas: 1. Debe crear un *conjunto de configuración* a través del API o de la consola de Amazon SES. 1. Agregue uno o más *destinos del evento* (FirehoseCloudWatch, Pinpoint o SNS) al conjunto de configuraciones y configure los parámetros exclusivos del destino del evento. 1. Especifique un conjunto de configuración que contenga su destino de eventos cuando envíe un correo electrónico. **Topics** + [Paso 1: crear un conjunto de configuración](event-publishing-create-configuration-set.md) + [Paso 2: añadir un destino de evento](event-publishing-add-event-destination.md) + [Paso 3: Especifique el conjunto de configuración cuando envía correo electrónico](event-publishing-send-email.md) # Paso 1: crear un conjunto de configuración Primero debe tener un conjunto de configuración para configurar la publicación de eventos. Si aún no tiene un conjunto de configuración o desea crear uno nuevo, consulte [Creación de conjuntos de configuración en SES](creating-configuration-sets.md). También puede crear conjuntos de configuración mediante la [CreateConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateConfigurationSet.html)operación de la API V2 de Amazon SES o la CLI v2 de Amazon SES, consulte[Cree un conjunto de configuración (AWS CLI)](creating-configuration-sets.md#config-sets-create-cli). # Paso 2: añadir un destino de evento Los destinos de eventos son lugares en los que publica eventos de Amazon SES. Cada destino de eventos que configure pertenece a uno y solo a un conjunto de configuración. Cuando configura un destino de evento con Amazon SES, elige el destino del AWS servicio y especifica los parámetros asociados a ese destino. Al configurar un destino para eventos, puede elegir enviar los eventos a uno de los siguientes AWS servicios: + Amazon CloudWatch + Amazon Data Firehose + Amazon EventBridge + Amazon Pinpoint + Amazon Simple Notification Service (Amazon SNS) El destino de eventos que elija depende del nivel de detalle que desea sobre los eventos y la forma en que desea recibir la información del evento. Si simplemente desea un total acumulado de cada tipo de evento (por ejemplo, para poder configurar una alarma cuando el total sea demasiado alto), puede usar CloudWatch. Si quieres registros de eventos detallados que puedas enviar a otro servicio, como Amazon OpenSearch Service o Amazon Redshift, para su análisis, puedes usar Firehose. Si desea recibir notificaciones cuando se producen determinados eventos, puede usar Amazon SNS. **Topics** + [Configurar un destino de CloudWatch evento para la publicación de eventos](event-publishing-add-event-destination-cloudwatch.md) + [Configuración de un destino de eventos de Data Firehose para la publicación de eventos de Amazon SES](event-publishing-add-event-destination-firehose.md) + [Configura un EventBridge destino de Amazon para la publicación de eventos](event-publishing-add-event-destination-eventbridge.md) + [Configuración de un destino de eventos de Amazon Pinpoint para la publicación de eventos](event-publishing-add-event-destination-pinpoint.md) + [Configuración de un destino de eventos de Amazon SNS para la publicación de eventos](event-publishing-add-event-destination-sns.md) # Configurar un destino de CloudWatch evento para la publicación de eventos Con [ CloudWatch las métricas de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html), puedes usar los destinos de los eventos para publicar los eventos de envío de correos electrónicos de Amazon SES CloudWatch. Como el destino de un CloudWatch evento solo se puede configurar en un conjunto de configuraciones, primero debe [crear un conjunto de configuración](event-publishing-create-configuration-set.md) y, a continuación, añadir el destino del evento al conjunto de configuraciones. Al añadir un destino de CloudWatch eventos a un conjunto de configuraciones, debe elegir una o más CloudWatch *dimensiones* que se correspondan con las etiquetas de los mensajes que utiliza al enviar los correos electrónicos. Al igual que las etiquetas de los mensajes, una CloudWatch dimensión es un name/value par que le ayuda a identificar de forma única una métrica. Por ejemplo, podría tener una etiqueta de mensajes y una dimensión denominada `campaign` que usa para identificar su campaña de correo electrónico. Cuando publicas tus eventos de envío de correo electrónico CloudWatch, es importante elegir las etiquetas y dimensiones de los mensajes, ya que estas elecciones afectan a tu CloudWatch facturación y determinan cómo puedes filtrar los datos de los eventos de envío de correo electrónico CloudWatch. En esta sección se proporciona información que le ayudará a elegir las dimensiones y, a continuación, se muestra cómo añadir un destino de CloudWatch evento a un conjunto de configuraciones. **Topics** + [Añadir un destino de CloudWatch evento](#event-publishing-add-event-destination-cloudwatch-add) + [Selección de CloudWatch dimensiones](#event-publishing-add-event-destination-cloudwatch-dimensions) ## Añadir un destino de CloudWatch evento El procedimiento de esta sección muestra cómo añadir los detalles del destino CloudWatch del evento a un conjunto de configuraciones y supone que ha completado los pasos 1 a 6 que se indican más adelante[Crear un destino de eventos](event-destinations-manage.md#event-destination-add). También puede usar la [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operación en la API V2 de Amazon SES para crear y modificar destinos de eventos. **Para añadir los detalles CloudWatch del destino del evento a un conjunto de configuraciones mediante la consola** 1. Estas son las instrucciones detalladas para seleccionar CloudWatch el tipo de destino del evento en el [paso 7](event-destinations-manage.md#specify-event-dest-step) y se supone que ha completado todos los pasos anteriores[Crear un destino de eventos](event-destinations-manage.md#event-destination-add). Tras seleccionar el **tipo de CloudWatch destino**, introducir un **nombre** de destino y activar la **publicación de eventos**, se muestra el panel de ** CloudWatch dimensiones de Amazon**, cuyos campos se abordan en los siguientes pasos. *(Se aplican cargos adicionales; consulte el [precio por métrica](#cw-add-pricing) para ver). CloudWatch* 1. En **Value Source**, especifique cómo obtendrá Amazon SES los datos a los que pasa CloudWatch. Están disponibles los siguientes orígenes de valores: + **Message Tag** (Etiqueta de mensaje): Amazon SES recupera el nombre y el valor de la dimensión de una etiqueta que especifica utilizando el encabezado `X-SES-MESSAGE-TAGS` o el parámetro de la API `EmailTags`. Para obtener más información acerca del uso de etiquetas de mensaje, consulte [Paso 3: Especifique el conjunto de configuración cuando envía correo electrónico](event-publishing-send-email.md). **nota** 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 (\$1). También puede utilizar la fuente del valor **Message Tag** (Etiqueta de mensaje) para crear dimensiones basadas en las etiquetas automáticas de Amazon SES. Para utilizar una etiqueta automática, escriba el nombre completo de la etiqueta automática como **Dimension Name** (Nombre de dimensión). Por ejemplo, para crear una dimensión en función de la etiqueta automática del conjunto de configuración, utilice `ses:configuration-set` para el **Dimension Name** (Nombre de dimensión) y el nombre del conjunto de configuración para el **Default Value** (Valor predeterminado). Para obtener una lista completa de etiquetas automáticas, consulte [Funcionamiento de la publicación de eventos con conjuntos de configuración y etiquetas de mensajes](monitor-using-event-publishing.md#event-publishing-how-works). + **Email Header** (Encabezado de correo electrónico): Amazon SES recupera el nombre y el valor de la dimensión a partir de un encabezado de correo electrónico. **nota** No puede usar ninguno de los siguientes encabezados de correo electrónico como **Dimension Name**: `Received`, `To`, `From`, `DKIM-Signature`, `CC`, `message-id` o `Return-Path`. + **Link Tag** (Etiqueta de enlace): Amazon SES recupera el nombre y el valor de la dimensión a partir de una etiqueta especificada en un enlace. Para obtener más información sobre cómo añadir etiquetas a los enlaces, consulte [¿Puedo etiquetar enlaces con identificadores únicos?](faqs-metrics.md#sending-metric-faqs-clicks-q5). 1. Para **Dimension Name (Nombre de dimensión)**, escriba el nombre de la dimensión que desea transferir a CloudWatch. **nota** Los nombres de dimensión deben contener únicamente letras ASCII (a-z, A-Z), números (0 a 9), guiones bajos (\$1) y guiones (-). Los espacios, los caracteres acentuados, los caracteres no latinos y otros caracteres especiales no están permitidos. 1. Para **Default Value** (Valor predeterminado), escriba el valor de la dimensión. **nota** Los valores de dimensión solo deben contener letras ASCII (a-z, A-Z), números (0-9), guiones bajos (\$1), guiones (-), arrobas (@) y puntos (.). Los espacios, los caracteres acentuados, los caracteres no latinos y otros caracteres especiales no están permitidos. 1. Si desea añadir más dimensiones, elija **Add Dimension** (Añadir dimensión). En caso contrario, elija **Siguiente**. 1. En la pantalla de revisión, si está satisfecho con la forma en que ha definido el destino de eventos, elija **Add destination** (Agregar destino). ## Selección de CloudWatch dimensiones Al elegir nombres y valores para usarlos como CloudWatch dimensiones, tenga en cuenta los siguientes factores: + **Precio por métrica**: puedes ver las métricas básicas de Amazon SES de forma CloudWatch gratuita. Sin embargo, si recopila métricas mediante la publicación de eventos, incurre en costos de [monitoreo CloudWatch detallado](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html). Cada combinación única de tipo de evento, nombre de dimensión y valor de dimensión crea una métrica diferente. CloudWatch Cuando utilizas CloudWatch Detailed Monitoring, se te cobra por cada métrica. Por este motivo, es posible que desee evitar elegir dimensiones que puedan tener muchos valores diferentes. Por ejemplo, a menos que esté muy interesado en el seguimiento de los eventos de envío de correo electrónico desde el dominio del remitente (“From”), es posible que no desee definir una dimensión para la etiqueta automática de Amazon SES `ses:from-domain`, ya que puede tener muchos valores distintos. Para más información, consulte [Precios de CloudWatch](https://aws.amazon.com/cloudwatch/pricing). + **Filtrado de métricas**: si una métrica tiene varias dimensiones, no puede acceder a la métrica en CloudWatch función de cada dimensión por separado. Por ese motivo, piénselo detenidamente antes de añadir más de una dimensión a un único destino de CloudWatch evento. Por ejemplo, si desea métricas por `campaign` y por una combinación de `campaign` y `genre`, tiene que añadir dos destinos de evento: uno solo con `campaign` como dimensión y otro con `campaign` y `genre` como dimensiones. + **Fuente de los valores de las dimensiones**: como alternativa a especificar los valores de las dimensiones utilizando encabezados específicos de Amazon SES o un parámetro para la API, también puede especificar que Amazon SES tome los valores de las dimensiones de sus propios encabezados de mensaje MIME. Podría utilizar esta opción si ya está utilizando encabezados personalizados y no desea cambiar sus mensajes de correo electrónico o sus llamadas a la API de envío de correo electrónico para recopilar métricas en función de los valores de encabezado. Si utiliza sus propios encabezados de mensaje MIME para la publicación de eventos de Amazon SES, los nombres y los valores de los encabezados usados con esta finalidad para Amazon SES solo pueden incluir las letras de la A a la Z, los números del 0 al 9, guiones bajos (\$1), signos arroba (@), guiones (-) y puntos (.). Si especificas un nombre o un valor que contenga otros caracteres, la llamada de envío del correo electrónico seguirá siendo correcta, pero las estadísticas del evento no se enviarán a Amazon CloudWatch. Para obtener más información sobre CloudWatch los conceptos, consulta [Amazon CloudWatch Concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) en la *Guía del CloudWatch usuario de Amazon*. # Configuración de un destino de eventos de Data Firehose para la publicación de eventos de Amazon SES Un destino de eventos de Amazon Data Firehose representa una entidad que publica eventos de envío de correo electrónico de Amazon SES específicos a Firehose. Dado que un destino de eventos de Firehose solo se puede configurar en un conjunto de configuración, primero debe [crear un conjunto de configuración](event-publishing-create-configuration-set.md). A continuación, agregue el destino del evento al conjunto de configuración. En el procedimiento de esta sección, se muestra cómo agregar detalles de destino de eventos de Firehose a un conjunto de configuración y se supone que ha completado los pasos del 1 al 6 de [Crear un destino de eventos](event-destinations-manage.md#event-destination-add). También puede usar la [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operación en el destino de la API V2 de Amazon SES para crear y actualizar los destinos de los eventos. **Adición de detalles del destino de eventos de Firehose a un conjunto de configuración mediante la consola** 1. Estas son las instrucciones detalladas para seleccionar Firehose como tipo de destino de evento en el [paso 7](event-destinations-manage.md#specify-event-dest-step), en las que se supone que ha completado todos los pasos anteriores de [Crear un destino de eventos](event-destinations-manage.md#event-destination-add). Después de seleccionar el ‎**Tipo de destino** de Firehose, escribir el **Nombre** y activar la **Publicación de ‎eventos**, aparecerá el panel **Flujo de entrega de Amazon Data Firehose**, cuyos campos se explican en los siguientes pasos. 1. En **Flujo de entrega**, elija un flujo de entrega existente de Firehose, o elija **Crear un flujo nuevo** para crear uno nuevo mediante la consola de Firehose. Para obtener más información sobre la creación de flujos mediante la consola de Firehose, consulte [Creación de un flujo de entrega de Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) en la *Guía para desarrolladores de Amazon Data Firehose*. 1. En **Rol de Identity and Access Management (IAM)**, elija un rol de IAM para el que Amazon SES tenga permiso de publicación en Firehose en su nombre. Puede elegir un rol existente, hacer que Amazon SES cree un rol para usted o crear su propio rol. Si elige un rol existente o crea su propio rol, debe modificar manualmente las políticas del rol para concederle permiso para acceder al flujo de entrega de Firehose y conceder permiso a Amazon SES para asumir el rol. Para ver ejemplos de políticas, consulte [Concesión de permiso a Amazon SES para la publicación en el flujo de entrega de Firehose](#event-publishing-add-event-destination-firehose-role). 1. Elija **Siguiente**. 1. En la pantalla de revisión, si está satisfecho con la forma en que ha definido el destino de eventos, elija **Add destination** (Agregar destino). Para obtener información sobre cómo utilizar la API de `UpdateConfigurationSetEventDestination` para agregar un destino de eventos de Firehose, consulte la [Referencia de la API de Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetEventDestination.html). ## Concesión de permiso a Amazon SES para la publicación en el flujo de entrega de Firehose Para habilitar Amazon SES de tal forma que pueda publicar registros en su flujo de entrega de Firehose, debe utilizar un [rol](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) de AWS Identity and Access Management (IAM) y asociar o modificar la política de permisos y la política de confianza del rol. La política de permisos permite al rol publicar registros en el flujo de entrega de Firehose y la política de confianza permite a Amazon SES asumir el rol. En esta sección, se proporcionan ejemplos de ambas políticas. Para obtener más información acerca de cómo adjuntar políticas a roles de IAM, consulte [Modificación de un rol](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) en la *Guía del usuario de IAM*. ### Política de permisos La siguiente política de permisos permite al rol publicar registros de datos en su flujo de entrega de Firehose. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Action": [ "firehose:PutRecordBatch" ], "Resource": [ "arn:aws:firehose:us-east-1:111122223333:deliverystream/delivery-stream-name" ] } ] } ``` ------ En la política de ejemplo anterior, realice los siguientes cambios: + *delivery-region*Sustitúyala por la AWS región en la que creaste el flujo de entrega de Firehose. + Reemplace *111122223333* por su ID de cuenta de AWS . + *delivery-stream-name*Sustitúyalo por el nombre del flujo de entrega de Firehose. ### Política de confianza La siguiente política de confianza habilita a Amazon SES para que asuma el rol. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "AWS:SourceAccount": "111122223333", "AWS:SourceArn": "arn:aws:ses:delivery-region:111122223333:configuration-set/configuration-set-name" } } } ] } ``` ------ En la política de ejemplo anterior, realice los siguientes cambios: + *delivery-region*Sustitúyala por la AWS región en la que creaste el flujo de entrega de Firehose. + Reemplace *111122223333* por su ID de cuenta de AWS . + *configuration-set-name*Sustitúyalo por el nombre del conjunto de configuración asociado al flujo de entrega de Firehose. # Configura un EventBridge destino de Amazon para la publicación de eventos Un destino de EventBridge eventos de Amazon te notifica los eventos de envío de correo electrónico que especifiques en un conjunto de configuraciones. SES genera y envía los eventos de envío de correos electrónicos que usted defina al crear el destino del evento al bus de eventos EventBridge predeterminado. Un [bus de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html) es un enrutador que recibe eventos y puede enviarlos a varios destinos. Puedes obtener más información sobre la integración de eventos de envío de correo electrónico con Amazon EventBridge en[Supervisión de eventos de SES con Amazon EventBridge](monitoring-eventbridge.md). Como el destino de un EventBridge evento solo se puede configurar en un conjunto de configuraciones, debe [crear un conjunto de configuración](event-publishing-create-configuration-set.md) antes de añadir el destino del evento al conjunto de configuraciones. En el procedimiento de esta sección se muestra cómo agregar los detalles EventBridge del destino del evento a un conjunto de configuración y se supone que ha completado los pasos 1 a 6 descritos más abajo[Crear un destino de eventos](event-destinations-manage.md#event-destination-add). También puede usar la [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operación en la API V2 de Amazon SES para crear y modificar destinos de eventos. **Para añadir los detalles EventBridge del destino del evento a un conjunto de configuraciones mediante la consola** 1. Estas son las instrucciones detalladas para seleccionar EventBridge el tipo de destino del evento en el [paso 7](event-destinations-manage.md#specify-event-dest-step) y se supone que ha completado todos los pasos anteriores[Crear un destino de eventos](event-destinations-manage.md#event-destination-add). Tras seleccionar el **tipo de EventBridge destino** de *Amazon*, introducir un **nombre** de destino y activar la **publicación de eventos**, se mostrará un panel informativo **sobre el autobús de EventBridge eventos de Amazon**. 1. Elija **Siguiente**. 1. En la pantalla de revisión, si está satisfecho con la forma en que ha definido el destino de eventos, elija **Add destination** (Agregar destino). Se abrirá la página de resumen del destino del evento en la que un banner de éxito confirmará si el destino del evento se ha creado o modificado en forma correcta. # Configuración de un destino de eventos de Amazon Pinpoint para la publicación de eventos Un destino de eventos de Amazon Pinpoint le notifica acerca de eventos de envío de correo electrónico que haya especificado en un conjunto de configuración. Dado que un destino de eventos de Amazon Pinpoint solo existe dentro de un conjunto de configuración, primero debe [crear un conjunto de configuración](event-publishing-create-configuration-set.md) y, a continuación, agregar el destino de eventos a dicho conjunto. En el procedimiento de esta sección se muestra cómo agregar detalles de destino de eventos de Amazon Pinpoint a un conjunto de configuración y se supone que ha completado los pasos del 1 al 6 de [Crear un destino de eventos](event-destinations-manage.md#event-destination-add). También puede usar la [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operación en la API V2 de Amazon SES para crear y modificar destinos de eventos. Hay cargos adicionales por los tipos de canales que haya configurado en sus proyectos de Amazon Pinpoint. Para obtener más información, consulte [Precios de Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/). **Para agregar detalles del destino de eventos de Amazon Pinpoint a un conjunto de configuración mediante la consola** 1. Estas son las instrucciones detalladas para seleccionar Amazon Pinpoint como tipo de destino de evento en [Paso 7](event-destinations-manage.md#specify-event-dest-step) y supone que ha completado todos los pasos anteriores en [Crear un destino de eventos](event-destinations-manage.md#event-destination-add). **nota** Amazon Pinpoint no admite los tipos de eventos **Delivery delays (Retrasos de entrega)** ni **Subscriptions (Suscripciones)**. Después de seleccionar el ‎**Tipo de destino** de Amazon Pinpoint, escribir el **Nombre** y activar la **Publicación de ‎eventos**, aparecerá el panel **Flujo de entrega de Amazon Pinpoint**, cuyos campos se explican en los siguientes pasos. 1. En **Project (Proyecto)**, elija un proyecto existente de Amazon Pinpoint o elija **Create a new project in Amazon Pinpoint (Crear un nuevo proyecto en Amazon Pinpoint)** para crear uno nuevo. Para obtener información sobre la creación de un proyecto, consulte [Crear un proyecto](https://docs.aws.amazon.com/pinpoint/latest/userguide/gettingstarted-create-project.html) en la *Guía del usuario de Amazon Pinpoint*. 1. Elija **Siguiente**. 1. En la pantalla de revisión, si está satisfecho con la forma en que ha definido el destino de eventos, elija **Add destination** (Agregar destino). Se abrirá la página de resumen del destino del evento en la que un banner de éxito confirmará si el destino del evento se ha creado o modificado en forma correcta. # Configuración de un destino de eventos de Amazon SNS para la publicación de eventos Un destino de eventos de Amazon SNS le notifica acerca de eventos de envío de correo electrónico que haya especificado en un conjunto de configuración. Dado que un destino de eventos de Amazon SNS solo existe dentro de un conjunto de configuración, primero debe [crear un conjunto de configuración](event-publishing-create-configuration-set.md) y, a continuación, agregar el destino de eventos a dicho conjunto. En el procedimiento de esta sección se muestra cómo agregar detalles de destino de eventos de Amazon SNS a un conjunto de configuración y se supone que ha completado los pasos del 1 al 6 de [Crear un destino de eventos](event-destinations-manage.md#event-destination-add). También puede usar la [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operación en la API V2 de Amazon SES para crear y modificar destinos de eventos. **nota** Las notificaciones de feedback sobre devoluciones, quejas y entregas también se pueden configurar a través de Amazon SNS para cualquiera de las identidades de envío verificadas. Para obtener más información, consulte [Configuración de notificaciones de Amazon SNS para Amazon SES](configure-sns-notifications.md). Se aplican cargos adicionales por enviar mensajes a los puntos de enlace que están suscritos a sus temas de Amazon SNS. Para obtener más información, consulte [Precios de Amazon SNS](https://aws.amazon.com/sns/pricing/). **Para agregar detalles del destino de eventos de Amazon SNS a un conjunto de configuración mediante la consola** 1. Estas son las instrucciones detalladas para seleccionar Amazon SNS como tipo de destino de evento en [Paso 7](event-destinations-manage.md#specify-event-dest-step) y supone que ha completado todos los pasos anteriores en [Crear un destino de eventos](event-destinations-manage.md#event-destination-add). Después de seleccionar el ‎**Tipo de destino** de Amazon SNS, escribir el **Nombre** y activar la **Publicación de ‎eventos**, aparecerá el panel **Tema de Amazon Simple Notification Service (SNS)**, cuyos campos se explican en los siguientes pasos. 1. Para **SNS Topic** (Tema de SNS), elija un tema de Amazon SNS existente o elija **Create SNS topic** (Crear tema de SNS) para crear uno nuevo. Para obtener más información acerca de la creación de un tema, consulte [Creación de un tema](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*. **importante** Al crear un tema con Amazon SNS, en **Type** (Tipo), solo elija **Standard** (Estándar). (SES no admite temas de tipo FIFO). 1. Elija **Siguiente**. 1. En la pantalla de revisión, si está satisfecho con la forma en que ha definido el destino de eventos, elija **Add destination** (Agregar destino). Se abrirá la página de resumen del destino del evento en la que un banner de éxito confirmará si el destino del evento se ha creado o modificado en forma correcta. 1. Tanto si creó un nuevo tema de SNS como si seleccionó uno existente, ahora deberá conceder acceso a SES para publicar notificaciones sobre el tema. En la página de resumen del destino del evento del paso anterior, elija **Amazon SNS** desde la columna **Destination type (Tipo de destino)**; esto lo dirigirá a la lista **Topics (Temas)** en la consola de Amazon Simple Notification Service, *realice los siguientes pasos desde la consola de Amazon SNS:* 1. Seleccione el nombre del tema de SNS que creó o modificó en el paso anterior. 1. En la pantalla de detalles del tema, elija **Edit (Editar)**. 1. Para conceder permiso a SES para publicar notificaciones sobre el tema, en la pantalla **Edit topic (Editar tema)** de la consola de SNS, expanda **Access policy (Política de acceso)** y en el **JSON editor (Editor de JSON)**, agregue la siguiente política de permisos: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "notification-policy", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "sns:Publish", "Resource": "arn:aws:sns:us-east-1:111122223333:topic_name", "Condition": { "StringEquals": { "AWS:SourceAccount": "111122223333", "AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:configuration-set/configuration-set-name" } } } ] } ``` ------ En la política de ejemplo anterior, realice los siguientes cambios: + *topic\$1region*Sustitúyalo por la AWS región en la que creó el tema de SNS. + *111122223333*Sustitúyalo por tu ID AWS de cuenta. + *topic\$1name*Sustitúyalo por el nombre de tu tema de SNS. + *configuration-set-name*Sustitúyalo por el nombre del conjunto de configuración asociado al destino del evento de SNS. 1. Seleccione **Save changes (Guardar cambios)**. # Paso 3: Especifique el conjunto de configuración cuando envía correo electrónico Después de [crear un conjunto de configuración](event-publishing-create-configuration-set.md) y [añadir un evento de destino](event-publishing-add-event-destination.md), 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 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. + [Uso de parámetros de la API de Amazon SES](#event-publishing-using-ses-parameters) + [Uso de encabezados de correo electrónico específicos de Amazon SES](#event-publishing-using-ses-headers) + [Uso de encabezados de correo electrónico personalizados](#event-publishing-using-custom-headers) **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 (\$1). ## Uso de parámetros de la API de Amazon SES Para usar [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendEmail.html),, [SendTemplatedEmail[SendBulkTemplatedEmail[SendCustomVerificationEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendCustomVerificationEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html), o [SendRawEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendRawEmail.html)con la publicación de eventos, debe especificar el conjunto de configuraciones y las etiquetas de los mensajes pasando las estructuras de datos llamadas [ConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference/API_ConfigurationSet.html)y [MessageTag](https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html)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](https://docs.aws.amazon.com/ses/latest/APIReference/). ## 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 configuraciones | `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. ``` 1. X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2 2. X-SES-CONFIGURATION-SET: myConfigurationSet 3. From: sender@example.com 4. To: recipient@example.com 5. Subject: Subject 6. Content-Type: multipart/alternative; 7. boundary="----=_boundary" 8. 9. ------=_boundary 10. Content-Type: text/plain; charset=UTF-8 11. Content-Transfer-Encoding: 7bit 12. 13. body 14. ------=_boundary 15. Content-Type: text/html; charset=UTF-8 16. Content-Transfer-Encoding: 7bit 17. 18. body 19. ------=_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 especificas un nombre o valor de encabezado que no sea ASCII para la publicación de eventos de Amazon SES, la llamada de envío del correo electrónico seguirá siendo correcta, pero las métricas del evento no se emitirán a Amazon. CloudWatch # Trabajar con datos de eventos de Amazon SES Después de [configurar la publicación de eventos](monitor-sending-using-event-publishing-setup.md) y especificar un conjunto de configuración para el envío de correos electrónicos, puede recuperar los eventos de envío de correo electrónico desde el destino de eventos especificado al configurar el conjunto de configuración asociado con el correo electrónico. En esta sección, se describe cómo recuperar los eventos de envío de correo electrónico desde Amazon CloudWatch y Amazon Data Firehose, y cómo interpretar los datos de los eventos proporcionados por Amazon SNS. + [Recuperación de datos de eventos de Amazon SES de CloudWatch](event-publishing-retrieving-cloudwatch.md) + [Recuperación de datos de eventos de Amazon SES desde Firehose](event-publishing-retrieving-firehose.md) + [Interpretación de datos de eventos de Amazon SES desde Amazon SNS](event-publishing-retrieving-sns.md) # Recuperación de datos de eventos de Amazon SES de CloudWatch Amazon SES puede publicar métricas para tus eventos de envío de correos electrónicos a Amazon CloudWatch. Cuando publica datos de eventos en CloudWatch, proporciona estas métricas como un conjunto ordenado de datos de series temporales. Puede utilizar estas métricas para monitorizar el rendimiento de su envío de correo electrónico. Por ejemplo, puedes supervisar la métrica de quejas y configurar una CloudWatch alarma para que se active cuando la métrica supere un valor determinado. Existen dos niveles de granularidad en los que Amazon SES puede publicar estos eventos: CloudWatch + **En general Cuenta de AWS**: estas métricas aproximadas, que corresponden a las métricas que monitoriza mediante la consola Amazon SES y la `GetSendStatistics` API, son totales de todo su conjunto Cuenta de AWS. Amazon SES publica estas métricas CloudWatch automáticamente. + **Detalladas**: estas métricas se clasifican por características de email que define mediante *etiquetas de mensajes*. Para publicar estas métricas en CloudWatch, debe [configurar la publicación de eventos](monitor-sending-using-event-publishing-setup.md) con un destino de CloudWatch evento y [especificar un conjunto de configuraciones](event-publishing-send-email.md) al enviar un correo electrónico. También puede especificar etiquetas de mensajes o utilizar las [etiquetas automáticas](monitor-using-event-publishing.md#event-publishing-how-works) que Amazon SES proporciona de forma automática. En esta sección, se describen las métricas disponibles y cómo ver las métricas en CloudWatch. ## Métricas disponibles Puede publicar las siguientes métricas de envío de correo electrónico de Amazon SES en CloudWatch: + **Send** (Envío): la solicitud de envío se realizó de forma correcta y Amazon SES intentará entregar el mensaje al servidor de correo del destinatario. (Si se está utilizando la supresión global o de nivel de cuenta, SES lo seguirá contando como un envío, pero la entrega se suprimirá). + **RenderingFailure**— El correo electrónico no se envió debido a un problema de representación de la plantilla. Este tipo de evento se puede producir cuando faltan datos en la plantilla o cuando los parámetros y los datos de la plantilla no coinciden. (Este tipo de evento solo se produce cuando envía correo electrónico con las operaciones de la API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) o [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html)). + **Reject** (Rechazo): Amazon SES aceptó el correo electrónico, pero determinó que contenía un virus y no intentó entregarlo al servidor de correo del destinatario. + **Delivery** (Entregados): Amazon SES entregó correctamente el correo electrónico al servidor de correo del destinatario. + **Rebotar**: una *devolución permanente* que el servidor de correo del destinatario ha rechazado el correo electrónico de forma permanente. (Los *rebotes suaves* solo se incluyen cuando SES ya no vuelve a intentar entregar el correo electrónico. Por lo general, estos rebotes suaves indican un error en la entrega, aunque en algunos casos se puede devolver un rebote suave incluso cuando el correo llegue correctamente a la bandeja de entrada del destinatario. Esto suele ocurrir cuando el destinatario envía una respuesta out-of-office automática. Obtén más información sobre los rebotes suaves en este artículo de [AWS Re:post](https://repost.aws/knowledge-center/ses-understand-soft-bounces).) + **Complaint (Reclamo)**: el correo electrónico se entregó correctamente al servidor de correo del destinatario, pero el destinatario lo marcó como spam. + **DeliveryDelay**— No se pudo entregar el correo electrónico al servidor de correo del destinatario porque se produjo un problema temporal. Pueden producirse retrasos en la entrega, por ejemplo, si la bandeja de entrada del destinatario está llena o el servidor de recepción de email experimenta un problema transitorio. + **Subscriptions** (Suscripciones): el correo electrónico se entregó correctamente, pero el destinatario actualizó las preferencias de suscripción al hacer clic en `List-Unsubscribe` en el encabezado del correo electrónico o el enlace `Unsubscribe` del pie de página. + **Open** (Abiertos): el destinatario recibió el mensaje y lo abrió en su cliente de correos electrónicos. + **Clic**: el destinatario hizo clic en uno o varios enlaces incluidos en el correo electrónico. ## Dimensiones disponibles CloudWatch utiliza los nombres de dimensión que especifique al añadir un destino de CloudWatch evento a un conjunto de configuraciones en Amazon SES. Para obtener más información, consulte [Configurar un destino de CloudWatch evento para la publicación de eventos](event-publishing-add-event-destination-cloudwatch.md). ## Visualización de las métricas de Amazon SES en la CloudWatch consola El siguiente procedimiento describe cómo ver las métricas de publicación de eventos de Amazon SES mediante la CloudWatch consola. **Para ver las métricas mediante la CloudWatch consola** 1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Si es necesario, cambie la región. En la barra de navegación, selecciona la región en la que residen tus AWS recursos. Para obtener más información, consulte [Regiones y puntos de conexión](https://docs.aws.amazon.com/general/latest/gr/rande.html). 1. En el panel de navegación, seleccione **Todas las métricas**. 1. En el panel **Métricas**, seleccione **SES**. 1. Elija la métrica que desea ver. Para ver [métricas de publicación de eventos](monitor-using-event-publishing.md) detalladas, elija la combinación de dimensiones que ha especificado al [configurar el destino de eventos de CloudWatch](event-publishing-add-event-destination-cloudwatch.md). Para obtener más información sobre cómo ver las métricas con CloudWatch, consulta Cómo [usar CloudWatch las métricas de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html). **Para ver las métricas utilizando la AWS CLI** + En el símbolo del sistema, ejecute el siguiente comando: ``` 1. aws cloudwatch list-metrics --namespace "AWS/SES" ``` # Recuperación de datos de eventos de Amazon SES desde Firehose Amazon SES publica los eventos de envío de correo electrónico a Firehose como registros JSON. A continuación, Firehose publica los registros en el destino de AWS servicio que eligió al configurar el flujo de entrega en Firehose. Para obtener más información sobre la configuración de flujos de entrega de Firehose, consulte [Creación de un flujo de entrega de Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) en la *Guía para desarrolladores de Amazon Data Firehose*. **Topics** + [Contenido de los datos de eventos que Amazon SES publica en Firehose](event-publishing-retrieving-firehose-contents.md) + [Ejemplos de datos de eventos que Amazon SES publica en Firehose](event-publishing-retrieving-firehose-examples.md) # Contenido de los datos de eventos que Amazon SES publica en Firehose Amazon SES publica los registros de eventos de envío de correo electrónico en Amazon Data Firehose en formato JSON. Al publicar eventos en Firehose, Amazon SES agrega a cada registro JSON un carácter de nueva línea. Puede encontrar registros de ejemplo para todos estos tipos de notificación en [Ejemplos de datos de eventos que Amazon SES publica en Firehose](event-publishing-retrieving-firehose-examples.md). **Topics** + [Objeto JSON de nivel superior](#event-publishing-retrieving-firehose-contents-top-level-json-object) + [Objeto Mail](#event-publishing-retrieving-firehose-contents-mail-object) + [Objeto Bounce](#event-publishing-retrieving-firehose-contents-bounce-object) + [Objeto Complaint](#event-publishing-retrieving-firehose-contents-complaint-object) + [Objeto Delivery](#event-publishing-retrieving-firehose-contents-delivery-object) + [Objeto Send](#event-publishing-retrieving-firehose-contents-send-object) + [Objeto Reject](#event-publishing-retrieving-firehose-contents-reject-object) + [Objeto Open](#event-publishing-retrieving-firehose-contents-open-object) + [Objeto Click](#event-publishing-retrieving-firehose-contents-click-object) + [Objeto Rendering Failure](#event-publishing-retrieving-firehose-contents-failure-object) + [DeliveryDelay objeto](#event-publishing-retrieving-firehose-delivery-delay-object) + [Objeto suscripción](#event-publishing-retrieving-firehose-subscription-object) ## 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. | Nombre del campo | Description (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](monitor-sending-using-event-publishing-setup.md) 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 | Description (Descripción) | | --- | --- | | `timestamp` | La fecha y la hora, en ISO8601 formato (*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. 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ónicoUso de la autorización de envío](sending-authorization.md). | | `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`. 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. 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` tendrá siempre los campos siguientes. | Nombre del campo | Description (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 ISO8601 formato (*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. 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` aloja una lista de objetos (un objeto por destinatario a quien pertenece el evento de rebote) y siempre contendrá el campo siguiente. | Nombre del campo | Description (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 | Description (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 se rebote será uno de los tipos que se muestra 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 | Description (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](sending-email-suppression-list.md). | | 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](sending-email-suppression-list.md). 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 | Description (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 (AAAA-MM-:MM:SS.SZ), en ISO8601 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 | Description (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 o del informe de comentarios en formato (AAAA-MM `Arrival-Date` -:MM:SS.sz). `Received-Date` ISO8601 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** Como la mayoría de ISPs las veces no incluye la dirección de correo electrónico del destinatario que presentó la queja en su notificación de queja, esta lista contiene información sobre los destinatarios que podrían haber enviado la queja, basada en los destinatarios del mensaje original y en el ISP del que recibimos la queja. Amazon SES realiza una búsqueda en el mensaje original para determinar esta lista de destinatarios. Los objetos JSON de esta lista contienen el siguiente campo. | Nombre del campo | Description (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](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2): | Nombre del campo | Description (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. | ## Objeto Delivery El objeto JSON que contiene información acerca de un evento `Delivery` tendrá siempre los campos siguientes. | Nombre del campo | Description (Descripción) | | --- | --- | | `timestamp` | La fecha y la hora en que Amazon SES entregó el correo electrónico al servidor de correo del destinatario, en ISO8601 formato (*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. | | `remoteMtaIp` | La dirección IP de la MTA a la que Amazon SES entregó el correo electrónico. | ## 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` tendrá siempre los campos siguientes. | Nombre del campo | Description (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` contendrá siempre los campos siguientes. | Nombre del campo | Description (Descripción) | | --- | --- | | `ipAddress` | La dirección IP del destinatario. | | `timestamp` | *La fecha y la hora en que se produjo el evento de apertura en el formato (AAAA-MM-:MM:SS.SZ). ISO8601 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` contendrá siempre los campos siguientes. | Nombre del campo | Description (Descripción) | | --- | --- | | `ipAddress` | La dirección IP del destinatario. | | `timestamp` | *La fecha y la hora en que se produjo el clic en el formato (AAAA-MM-:MM:SS.SZ). ISO8601 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?](faqs-metrics.md#sending-metric-faqs-clicks-q5) en la [Métricas de envío de correo electrónico de Amazon SES FAQs](faqs-metrics.md). | ## Objeto Rendering Failure El objeto JSON que contiene información acerca de un evento `Rendering Failure` tiene los campos siguientes. | Nombre del campo | Description (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 | Description (Descripción) | | --- | --- | | `delayType` | El tipo de retraso. Los valores posibles son los que se indican a continuación. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/ses/latest/dg/event-publishing-retrieving-firehose-contents.html) | | `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 | Description (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 | Description (Descripción) | | --- | --- | | `contactList` | El nombre de la lista de contacto está activado. | | `timestamp` | La fecha y la hora, en ISO8601 formato *(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 | Description (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. **OptIn**OptOut****`subscriptionStatus` | | `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` | # Ejemplos de datos de eventos que Amazon SES publica en Firehose En esta sección, se proporcionan ejemplos de los tipos de registros de eventos de envío de correo electrónico que Amazon SES publica en Firehose. **Topics** + [Registro Bounce](#event-publishing-retrieving-firehose-bounce) + [Registro Complaint](#event-publishing-retrieving-firehose-complaint) + [Registro Delivery](#event-publishing-retrieving-firehose-delivery) + [Registro Send](#event-publishing-retrieving-firehose-send) + [Registro Reject](#event-publishing-retrieving-firehose-reject) + [Registro Open](#event-publishing-retrieving-firehose-open) + [Registro Click](#event-publishing-retrieving-firehose-click) + [Registro Rendering Failure](#event-publishing-retrieving-firehose-failure) + [DeliveryDelay registro](#event-publishing-retrieving-firehose-delayed-delivery) + [Registro de suscripción](#event-publishing-retrieving-firehose-subscription) **nota** En los siguientes ejemplos en los que se utiliza un campo `tag`, se emplea la publicación de eventos a través de un conjunto de configuración para el que SES admite la publicación de etiquetas para todos los tipos de eventos. Si se utilizan las notificaciones de respuesta directamente en la identidad, SES no publica las etiquetas. Consulte cómo agregar etiquetas al [crear un conjunto de configuración](creating-configuration-sets.md) o [modificar un conjunto de configuración](managing-configuration-sets.md#console-detail-configuration-sets). ## Registro Bounce El siguiente es un ejemplo de un registro de evento `Bounce` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType":"Bounce", 3. "bounce":{ 4. "bounceType":"Permanent", 5. "bounceSubType":"General", 6. "bouncedRecipients":[ 7. { 8. "emailAddress":"recipient@example.com", 9. "action":"failed", 10. "status":"5.1.1", 11. "diagnosticCode":"smtp; 550 5.1.1 user unknown" 12. } 13. ], 14. "timestamp":"2017-08-05T00:41:02.669Z", 15. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000", 16. "reportingMTA":"dsn; mta.example.com" 17. }, 18. "mail":{ 19. "timestamp":"2017-08-05T00:40:02.012Z", 20. "source":"Sender Name ", 21. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 22. "sendingAccountId":"123456789012", 23. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 24. "destination":[ 25. "recipient@example.com" 26. ], 27. "headersTruncated":false, 28. "headers":[ 29. { 30. "name":"From", 31. "value":"Sender Name " 32. }, 33. { 34. "name":"To", 35. "value":"recipient@example.com" 36. }, 37. { 38. "name":"Subject", 39. "value":"Message sent from Amazon SES" 40. }, 41. { 42. "name":"MIME-Version", 43. "value":"1.0" 44. }, 45. { 46. "name":"Content-Type", 47. "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\"" 48. } 49. ], 50. "commonHeaders":{ 51. "from":[ 52. "Sender Name " 53. ], 54. "to":[ 55. "recipient@example.com" 56. ], 57. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 58. "subject":"Message sent from Amazon SES" 59. }, 60. "tags":{ 61. "ses:configuration-set":[ 62. "ConfigSet" 63. ], 64. "ses:source-ip":[ 65. "192.0.2.0" 66. ], 67. "ses:from-domain":[ 68. "example.com" 69. ], 70. "ses:caller-identity":[ 71. "ses_user" 72. ] 73. } 74. } 75. } ``` ## Registro Complaint El siguiente es un ejemplo de un registro de evento `Complaint` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType":"Complaint", 3. "complaint": { 4. "complainedRecipients":[ 5. { 6. "emailAddress":"recipient@example.com" 7. } 8. ], 9. "timestamp":"2017-08-05T00:41:02.669Z", 10. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000", 11. "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36", 12. "complaintFeedbackType":"abuse", 13. "arrivalDate":"2017-08-05T00:41:02.669Z" 14. }, 15. "mail":{ 16. "timestamp":"2017-08-05T00:40:01.123Z", 17. "source":"Sender Name ", 18. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 19. "sendingAccountId":"123456789012", 20. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 21. "destination":[ 22. "recipient@example.com" 23. ], 24. "headersTruncated":false, 25. "headers":[ 26. { 27. "name":"From", 28. "value":"Sender Name " 29. }, 30. { 31. "name":"To", 32. "value":"recipient@example.com" 33. }, 34. { 35. "name":"Subject", 36. "value":"Message sent from Amazon SES" 37. }, 38. { 39. "name":"MIME-Version","value":"1.0" 40. }, 41. { 42. "name":"Content-Type", 43. "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\"" 44. } 45. ], 46. "commonHeaders":{ 47. "from":[ 48. "Sender Name " 49. ], 50. "to":[ 51. "recipient@example.com" 52. ], 53. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 54. "subject":"Message sent from Amazon SES" 55. }, 56. "tags":{ 57. "ses:configuration-set":[ 58. "ConfigSet" 59. ], 60. "ses:source-ip":[ 61. "192.0.2.0" 62. ], 63. "ses:from-domain":[ 64. "example.com" 65. ], 66. "ses:caller-identity":[ 67. "ses_user" 68. ] 69. } 70. } 71. } ``` ## Registro Delivery El siguiente es un ejemplo de un registro de evento `Delivery` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType": "Delivery", 3. "mail": { 4. "timestamp": "2016-10-19T23:20:52.240Z", 5. "source": "sender@example.com", 6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId": "123456789012", 8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination": [ 10. "recipient@example.com" 11. ], 12. "headersTruncated": false, 13. "headers": [ 14. { 15. "name": "From", 16. "value": "sender@example.com" 17. }, 18. { 19. "name": "To", 20. "value": "recipient@example.com" 21. }, 22. { 23. "name": "Subject", 24. "value": "Message sent from Amazon SES" 25. }, 26. { 27. "name": "MIME-Version", 28. "value": "1.0" 29. }, 30. { 31. "name": "Content-Type", 32. "value": "text/html; charset=UTF-8" 33. }, 34. { 35. "name": "Content-Transfer-Encoding", 36. "value": "7bit" 37. } 38. ], 39. "commonHeaders": { 40. "from": [ 41. "sender@example.com" 42. ], 43. "to": [ 44. "recipient@example.com" 45. ], 46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 47. "subject": "Message sent from Amazon SES" 48. }, 49. "tags": { 50. "ses:configuration-set": [ 51. "ConfigSet" 52. ], 53. "ses:source-ip": [ 54. "192.0.2.0" 55. ], 56. "ses:from-domain": [ 57. "example.com" 58. ], 59. "ses:caller-identity": [ 60. "ses_user" 61. ], 62. "ses:outgoing-ip": [ 63. "192.0.2.0" 64. ], 65. "myCustomTag1": [ 66. "myCustomTagValue1" 67. ], 68. "myCustomTag2": [ 69. "myCustomTagValue2" 70. ] 71. } 72. }, 73. "delivery": { 74. "timestamp": "2016-10-19T23:21:04.133Z", 75. "processingTimeMillis": 11893, 76. "recipients": [ 77. "recipient@example.com" 78. ], 79. "smtpResponse": "250 2.6.0 Message received", 80. "remoteMtaIp": "123.456.789.012", 81. "reportingMTA": "mta.example.com" 82. } 83. } ``` ## Registro Send El siguiente es un ejemplo de un registro de evento `Send` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType": "Send", 3. "mail": { 4. "timestamp": "2016-10-14T05:02:16.645Z", 5. "source": "sender@example.com", 6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId": "123456789012", 8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination": [ 10. "recipient@example.com" 11. ], 12. "headersTruncated": false, 13. "headers": [ 14. { 15. "name": "From", 16. "value": "sender@example.com" 17. }, 18. { 19. "name": "To", 20. "value": "recipient@example.com" 21. }, 22. { 23. "name": "Subject", 24. "value": "Message sent from Amazon SES" 25. }, 26. { 27. "name": "MIME-Version", 28. "value": "1.0" 29. }, 30. { 31. "name": "Content-Type", 32. "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\"" 33. }, 34. { 35. "name": "X-SES-MESSAGE-TAGS", 36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2" 37. } 38. ], 39. "commonHeaders": { 40. "from": [ 41. "sender@example.com" 42. ], 43. "to": [ 44. "recipient@example.com" 45. ], 46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 47. "subject": "Message sent from Amazon SES" 48. }, 49. "tags": { 50. "ses:configuration-set": [ 51. "ConfigSet" 52. ], 53. "ses:source-ip": [ 54. "192.0.2.0" 55. ], 56. "ses:from-domain": [ 57. "example.com" 58. ], 59. "ses:caller-identity": [ 60. "ses_user" 61. ], 62. "myCustomTag1": [ 63. "myCustomTagValue1" 64. ], 65. "myCustomTag2": [ 66. "myCustomTagValue2" 67. ] 68. } 69. }, 70. "send": {} 71. } ``` ## Registro Reject El siguiente es un ejemplo de un registro de evento `Reject` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType": "Reject", 3. "mail": { 4. "timestamp": "2016-10-14T17:38:15.211Z", 5. "source": "sender@example.com", 6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId": "123456789012", 8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination": [ 10. "sender@example.com" 11. ], 12. "headersTruncated": false, 13. "headers": [ 14. { 15. "name": "From", 16. "value": "sender@example.com" 17. }, 18. { 19. "name": "To", 20. "value": "recipient@example.com" 21. }, 22. { 23. "name": "Subject", 24. "value": "Message sent from Amazon SES" 25. }, 26. { 27. "name": "MIME-Version", 28. "value": "1.0" 29. }, 30. { 31. "name": "Content-Type", 32. "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\"" 33. }, 34. { 35. "name": "X-SES-MESSAGE-TAGS", 36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2" 37. } 38. ], 39. "commonHeaders": { 40. "from": [ 41. "sender@example.com" 42. ], 43. "to": [ 44. "recipient@example.com" 45. ], 46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 47. "subject": "Message sent from Amazon SES" 48. }, 49. "tags": { 50. "ses:configuration-set": [ 51. "ConfigSet" 52. ], 53. "ses:source-ip": [ 54. "192.0.2.0" 55. ], 56. "ses:from-domain": [ 57. "example.com" 58. ], 59. "ses:caller-identity": [ 60. "ses_user" 61. ], 62. "myCustomTag1": [ 63. "myCustomTagValue1" 64. ], 65. "myCustomTag2": [ 66. "myCustomTagValue2" 67. ] 68. } 69. }, 70. "reject": { 71. "reason": "Bad content" 72. } 73. } ``` ## Registro Open El siguiente es un ejemplo de un registro de evento `Open` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType": "Open", 3. "mail": { 4. "commonHeaders": { 5. "from": [ 6. "sender@example.com" 7. ], 8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "subject": "Message sent from Amazon SES", 10. "to": [ 11. "recipient@example.com" 12. ] 13. }, 14. "destination": [ 15. "recipient@example.com" 16. ], 17. "headers": [ 18. { 19. "name": "X-SES-CONFIGURATION-SET", 20. "value": "ConfigSet" 21. }, 22. { 23. "name":"X-SES-MESSAGE-TAGS", 24. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2" 25. }, 26. { 27. "name": "From", 28. "value": "sender@example.com" 29. }, 30. { 31. "name": "To", 32. "value": "recipient@example.com" 33. }, 34. { 35. "name": "Subject", 36. "value": "Message sent from Amazon SES" 37. }, 38. { 39. "name": "MIME-Version", 40. "value": "1.0" 41. }, 42. { 43. "name": "Content-Type", 44. "value": "multipart/alternative; boundary=\"XBoundary\"" 45. } 46. ], 47. "headersTruncated": false, 48. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 49. "sendingAccountId": "123456789012", 50. "source": "sender@example.com", 51. "tags": { 52. "myCustomTag1":[ 53. "myCustomValue1" 54. ], 55. "myCustomTag2":[ 56. "myCustomValue2" 57. ], 58. "ses:caller-identity": [ 59. "IAM_user_or_role_name" 60. ], 61. "ses:configuration-set": [ 62. "ConfigSet" 63. ], 64. "ses:from-domain": [ 65. "example.com" 66. ], 67. "ses:source-ip": [ 68. "192.0.2.0" 69. ] 70. }, 71. "timestamp": "2017-08-09T21:59:49.927Z" 72. }, 73. "open": { 74. "ipAddress": "192.0.2.1", 75. "timestamp": "2017-08-09T22:00:19.652Z", 76. "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60" 77. } 78. } ``` ## Registro Click El siguiente es un ejemplo de un registro de evento `Click` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType": "Click", 3. "click": { 4. "ipAddress": "192.0.2.1", 5. "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html", 6. "linkTags": { 7. "samplekey0": [ 8. "samplevalue0" 9. ], 10. "samplekey1": [ 11. "samplevalue1" 12. ] 13. }, 14. "timestamp": "2017-08-09T23:51:25.570Z", 15. "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36" 16. }, 17. "mail": { 18. "commonHeaders": { 19. "from": [ 20. "sender@example.com" 21. ], 22. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 23. "subject": "Message sent from Amazon SES", 24. "to": [ 25. "recipient@example.com" 26. ] 27. }, 28. "destination": [ 29. "recipient@example.com" 30. ], 31. "headers": [ 32. { 33. "name": "X-SES-CONFIGURATION-SET", 34. "value": "ConfigSet" 35. }, 36. { 37. "name":"X-SES-MESSAGE-TAGS", 38. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2" 39. }, 40. { 41. "name": "From", 42. "value": "sender@example.com" 43. }, 44. { 45. "name": "To", 46. "value": "recipient@example.com" 47. }, 48. { 49. "name": "Subject", 50. "value": "Message sent from Amazon SES" 51. }, 52. { 53. "name": "MIME-Version", 54. "value": "1.0" 55. }, 56. { 57. "name": "Content-Type", 58. "value": "multipart/alternative; boundary=\"XBoundary\"" 59. }, 60. { 61. "name": "Message-ID", 62. "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000" 63. } 64. ], 65. "headersTruncated": false, 66. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 67. "sendingAccountId": "123456789012", 68. "source": "sender@example.com", 69. "tags": { 70. "myCustomTag1":[ 71. "myCustomValue1" 72. ], 73. "myCustomTag2":[ 74. "myCustomValue2" 75. ], 76. "ses:caller-identity": [ 77. "ses_user" 78. ], 79. "ses:configuration-set": [ 80. "ConfigSet" 81. ], 82. "ses:from-domain": [ 83. "example.com" 84. ], 85. "ses:source-ip": [ 86. "192.0.2.0" 87. ] 88. }, 89. "timestamp": "2017-08-09T23:50:05.795Z" 90. } 91. } ``` ## Registro Rendering Failure El siguiente es un ejemplo de un registro de evento `Rendering Failure` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType":"Rendering Failure", 3. "mail":{ 4. "timestamp":"2018-01-22T18:43:06.197Z", 5. "source":"sender@example.com", 6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId":"123456789012", 8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination":[ 10. "recipient@example.com" 11. ], 12. "headersTruncated":false, 13. "tags":{ 14. "ses:configuration-set":[ 15. "ConfigSet" 16. ] 17. } 18. }, 19. "failure":{ 20. "errorMessage":"Attribute 'attributeName' is not present in the rendering data.", 21. "templateName":"MyTemplate" 22. } 23. } ``` ## DeliveryDelay registro El siguiente es un ejemplo de un registro de evento `DeliveryDelay` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType": "DeliveryDelay", 3. "mail":{ 4. "timestamp":"2020-06-16T00:15:40.641Z", 5. "source":"sender@example.com", 6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId":"123456789012", 8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination":[ 10. "recipient@example.com" 11. ], 12. "headersTruncated":false, 13. "tags":{ 14. "ses:configuration-set":[ 15. "ConfigSet" 16. ] 17. } 18. }, 19. "deliveryDelay": { 20. "timestamp": "2020-06-16T00:25:40.095Z", 21. "delayType": "TransientCommunicationFailure", 22. "expirationTime": "2020-06-16T00:25:40.914Z", 23. "delayedRecipients": [{ 24. "emailAddress": "recipient@example.com", 25. "status": "4.4.1", 26. "diagnosticCode": "smtp; 421 4.4.1 Unable to connect to remote host" 27. }] 28. } 29. } ``` ## Registro de suscripción El siguiente es un ejemplo de un registro de evento `Subscription` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType": "Subscription", 3. "mail": { 4. "timestamp": "2022-01-12T01:00:14.340Z", 5. "source": "sender@example.com", 6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId": "123456789012", 8. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000", 9. "destination": ["recipient@example.com"], 10. "headersTruncated": false, 11. "headers": [ 12. { 13. "name": "From", 14. "value": "sender@example.com" 15. }, 16. { 17. "name": "To", 18. "value": "recipient@example.com" 19. }, 20. { 21. "name": "Subject", 22. "value": "Message sent from Amazon SES" 23. }, 24. { 25. "name": "MIME-Version", 26. "value": "1.0" 27. }, 28. { 29. "name": "Content-Type", 30. "value": "text/html; charset=UTF-8" 31. }, 32. { 33. "name": "Content-Transfer-Encoding", 34. "value": "7bit" 35. } 36. ], 37. "commonHeaders": { 38. "from": ["sender@example.com"], 39. "to": ["recipient@example.com"], 40. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000", 41. "subject": "Message sent from Amazon SES" 42. }, 43. "tags": { 44. "ses:operation": ["SendEmail"], 45. "ses:configuration-set": ["ConfigSet"], 46. "ses:source-ip": ["192.0.2.0"], 47. "ses:from-domain": ["example.com"], 48. "ses:caller-identity": ["ses_user"], 49. "myCustomTag1": ["myCustomValue1"], 50. "myCustomTag2": ["myCustomValue2"] 51. } 52. }, 53. "subscription": { 54. "contactList": "ContactListName", 55. "timestamp": "2022-01-12T01:00:17.910Z", 56. "source": "UnsubscribeHeader", 57. "newTopicPreferences": { 58. "unsubscribeAll": true, 59. "topicSubscriptionStatus": [ 60. { 61. "topicName": "ExampleTopicName", 62. "subscriptionStatus": "OptOut" 63. } 64. ] 65. }, 66. "oldTopicPreferences": { 67. "unsubscribeAll": false, 68. "topicSubscriptionStatus": [ 69. { 70. "topicName": "ExampleTopicName", 71. "subscriptionStatus": "OptOut" 72. } 73. ] 74. } 75. } 76. } ``` # Interpretación de datos de eventos de Amazon SES desde Amazon SNS Amazon SES publica eventos de envío de correo electrónico en Amazon Simple Notification Service (Amazon SNS) como registros JSON. A continuación, Amazon SNS entrega notificaciones a los puntos de enlace suscritos al tema de Amazon SNS asociado al destino de eventos. Para obtener información acerca de cómo configurar temas y suscripciones en Amazon SNS, consulte [Introducción](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*. Para obtener una descripción del contenido de registros y registros de ejemplo, consulte las secciones siguientes. + [Contenido de los registros de eventos](event-publishing-retrieving-sns-contents.md) + [Ejemplos de registros de evento](event-publishing-retrieving-sns-examples.md) # 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](event-publishing-retrieving-sns-examples.md). **Topics** + [Objeto JSON de nivel superior](#event-publishing-retrieving-sns-contents-top-level-json-object) + [Objeto Mail](#event-publishing-retrieving-sns-contents-mail-object) + [Objeto Bounce](#event-publishing-retrieving-sns-contents-bounce-object) + [Objeto Complaint](#event-publishing-retrieving-sns-contents-complaint-object) + [Objeto Delivery](#event-publishing-retrieving-sns-contents-delivery-object) + [Objeto Send](#event-publishing-retrieving-sns-contents-send-object) + [Objeto Reject](#event-publishing-retrieving-sns-contents-reject-object) + [Objeto Open](#event-publishing-retrieving-sns-contents-open-object) + [Objeto Click](#event-publishing-retrieving-sns-contents-click-object) + [Objeto Rendering Failure](#event-publishing-retrieving-sns-contents-failure-object) + [DeliveryDelay objeto](#event-publishing-retrieving-sns-contents-delivery-delay-object) + [Objeto suscripción](#event-publishing-retrieving-sns-contents-subscription-object) ## 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 | Description (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](monitor-sending-using-event-publishing-setup.md) 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 | Description (Descripción) | | --- | --- | | `timestamp` | La fecha y la hora, en ISO8601 formato (*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. 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ónicoUso de la autorización de envío](sending-authorization.md). | | `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`. 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. 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 | Description (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 ISO8601 formato (*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. 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 | Description (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 | Description (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 | Description (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](sending-email-suppression-list.md). | | 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](sending-email-suppression-list.md). 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 | Description (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 (AAAA-MM-:MM:SS.SZ), en ISO8601 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 | Description (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 o del informe de comentarios en formato (AAAA-MM `Arrival-Date` -:MM:SS.sz). `Received-Date` ISO8601 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 | Description (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](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2): | Nombre del campo | Description (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](sending-email-suppression-list.md). ## Objeto Delivery El objeto JSON que contiene información acerca de un evento `Delivery` tiene los campos siguientes. | Nombre del campo | Description (Descripción) | | --- | --- | | `timestamp` | La fecha y la hora en que Amazon SES entregó el correo electrónico al servidor de correo del destinatario, en ISO8601 formato (*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. | | `remoteMtaIp` | La dirección IP de la MTA a la que Amazon SES entregó el correo electrónico. | ## 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 | Description (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 | Description (Descripción) | | --- | --- | | `ipAddress` | La dirección IP del destinatario. | | `timestamp` | *La fecha y la hora en que se produjo el evento de apertura en el formato (AAAA-MM-:MM:SS.SZ). ISO8601 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 | Description (Descripción) | | --- | --- | | `ipAddress` | La dirección IP del destinatario. | | `timestamp` | *La fecha y la hora en que se produjo el clic en el formato (AAAA-MM-:MM:SS.SZ). ISO8601 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?](faqs-metrics.md#sending-metric-faqs-clicks-q5) en la [Métricas de envío de correo electrónico de Amazon SES FAQs](faqs-metrics.md). | ## Objeto Rendering Failure El objeto JSON que contiene información acerca de un evento `Rendering Failure` tiene los campos siguientes. | Nombre del campo | Description (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 | Description (Descripción) | | --- | --- | | `delayType` | El tipo de retraso. Los valores posibles son los que se indican a continuación. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/ses/latest/dg/event-publishing-retrieving-sns-contents.html) | | `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 | Description (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 | Description (Descripción) | | --- | --- | | `contactList` | El nombre de la lista de contacto está activado. | | `timestamp` | La fecha y la hora, en ISO8601 formato *(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 | Description (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. **OptIn**OptOut****`subscriptionStatus` | | `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` | # Ejemplos de datos de eventos que Amazon SES publica en Amazon SNS En esta sección se proporcionan ejemplos de los tipos de registros de evento de envío de correo electrónico que Amazon SES publica en Amazon SNS. **Topics** + [Registro Bounce](#event-publishing-retrieving-sns-bounce) + [Registro Complaint](#event-publishing-retrieving-sns-complaint) + [Registro Delivery](#event-publishing-retrieving-sns-delivery) + [Registro Send](#event-publishing-retrieving-sns-send) + [Registro Reject](#event-publishing-retrieving-sns-reject) + [Registro Open](#event-publishing-retrieving-sns-open) + [Registro Click](#event-publishing-retrieving-sns-click) + [Registro Rendering Failure](#event-publishing-retrieving-sns-failure) + [DeliveryDelay registro](#event-publishing-retrieving-sns-delayed-delivery) + [Registro de suscripción](#event-publishing-retrieving-sns-subscription) **nota** En los siguientes ejemplos en los que se utiliza un campo `tag`, se emplea la publicación de eventos a través de un conjunto de configuración para el que SES admite la publicación de etiquetas para todos los tipos de eventos. Si se utilizan las notificaciones de respuesta directamente en la identidad, SES no publica las etiquetas. Consulte cómo agregar etiquetas al [crear un conjunto de configuración](creating-configuration-sets.md) o [modificar un conjunto de configuración](managing-configuration-sets.md#console-detail-configuration-sets). ## Registro Bounce El siguiente es el ejemplo de un registro de evento `Bounce` que Amazon SES publica en Amazon SNS. ``` 1. { 2. "eventType":"Bounce", 3. "bounce":{ 4. "bounceType":"Permanent", 5. "bounceSubType":"General", 6. "bouncedRecipients":[ 7. { 8. "emailAddress":"recipient@example.com", 9. "action":"failed", 10. "status":"5.1.1", 11. "diagnosticCode":"smtp; 550 5.1.1 user unknown" 12. } 13. ], 14. "timestamp":"2017-08-05T00:41:02.669Z", 15. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000", 16. "reportingMTA":"dsn; mta.example.com" 17. }, 18. "mail":{ 19. "timestamp":"2017-08-05T00:40:02.012Z", 20. "source":"Sender Name ", 21. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 22. "sendingAccountId":"123456789012", 23. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 24. "destination":[ 25. "recipient@example.com" 26. ], 27. "headersTruncated":false, 28. "headers":[ 29. { 30. "name":"From", 31. "value":"Sender Name " 32. }, 33. { 34. "name":"To", 35. "value":"recipient@example.com" 36. }, 37. { 38. "name":"Subject", 39. "value":"Message sent from Amazon SES" 40. }, 41. { 42. "name":"MIME-Version", 43. "value":"1.0" 44. }, 45. { 46. "name":"Content-Type", 47. "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\"" 48. } 49. ], 50. "commonHeaders":{ 51. "from":[ 52. "Sender Name " 53. ], 54. "to":[ 55. "recipient@example.com" 56. ], 57. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 58. "subject":"Message sent from Amazon SES" 59. }, 60. "tags":{ 61. "ses:configuration-set":[ 62. "ConfigSet" 63. ], 64. "ses:source-ip":[ 65. "192.0.2.0" 66. ], 67. "ses:from-domain":[ 68. "example.com" 69. ], 70. "ses:caller-identity":[ 71. "ses_user" 72. ] 73. } 74. } 75. } ``` ## Registro Complaint El siguiente es el ejemplo de un registro de evento `Complaint` que Amazon SES publica en Amazon SNS. ``` 1. { 2. "eventType":"Complaint", 3. "complaint": { 4. "complainedRecipients":[ 5. { 6. "emailAddress":"recipient@example.com" 7. } 8. ], 9. "timestamp":"2017-08-05T00:41:02.669Z", 10. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000", 11. "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36", 12. "complaintFeedbackType":"abuse", 13. "arrivalDate":"2017-08-05T00:41:02.669Z" 14. }, 15. "mail":{ 16. "timestamp":"2017-08-05T00:40:01.123Z", 17. "source":"Sender Name ", 18. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 19. "sendingAccountId":"123456789012", 20. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 21. "destination":[ 22. "recipient@example.com" 23. ], 24. "headersTruncated":false, 25. "headers":[ 26. { 27. "name":"From", 28. "value":"Sender Name " 29. }, 30. { 31. "name":"To", 32. "value":"recipient@example.com" 33. }, 34. { 35. "name":"Subject", 36. "value":"Message sent from Amazon SES" 37. }, 38. { 39. "name":"MIME-Version","value":"1.0" 40. }, 41. { 42. "name":"Content-Type", 43. "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\"" 44. } 45. ], 46. "commonHeaders":{ 47. "from":[ 48. "Sender Name " 49. ], 50. "to":[ 51. "recipient@example.com" 52. ], 53. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 54. "subject":"Message sent from Amazon SES" 55. }, 56. "tags":{ 57. "ses:configuration-set":[ 58. "ConfigSet" 59. ], 60. "ses:source-ip":[ 61. "192.0.2.0" 62. ], 63. "ses:from-domain":[ 64. "example.com" 65. ], 66. "ses:caller-identity":[ 67. "ses_user" 68. ] 69. } 70. } 71. } ``` ## Registro Delivery El siguiente es el ejemplo de un registro de evento `Delivery` que Amazon SES publica en Amazon SNS. ``` 1. { 2. "eventType": "Delivery", 3. "mail": { 4. "timestamp": "2016-10-19T23:20:52.240Z", 5. "source": "sender@example.com", 6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId": "123456789012", 8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination": [ 10. "recipient@example.com" 11. ], 12. "headersTruncated": false, 13. "headers": [ 14. { 15. "name": "From", 16. "value": "sender@example.com" 17. }, 18. { 19. "name": "To", 20. "value": "recipient@example.com" 21. }, 22. { 23. "name": "Subject", 24. "value": "Message sent from Amazon SES" 25. }, 26. { 27. "name": "MIME-Version", 28. "value": "1.0" 29. }, 30. { 31. "name": "Content-Type", 32. "value": "text/html; charset=UTF-8" 33. }, 34. { 35. "name": "Content-Transfer-Encoding", 36. "value": "7bit" 37. } 38. ], 39. "commonHeaders": { 40. "from": [ 41. "sender@example.com" 42. ], 43. "to": [ 44. "recipient@example.com" 45. ], 46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 47. "subject": "Message sent from Amazon SES" 48. }, 49. "tags": { 50. "ses:configuration-set": [ 51. "ConfigSet" 52. ], 53. "ses:source-ip": [ 54. "192.0.2.0" 55. ], 56. "ses:from-domain": [ 57. "example.com" 58. ], 59. "ses:caller-identity": [ 60. "ses_user" 61. ], 62. "ses:outgoing-ip": [ 63. "192.0.2.0" 64. ], 65. "myCustomTag1": [ 66. "myCustomTagValue1" 67. ], 68. "myCustomTag2": [ 69. "myCustomTagValue2" 70. ] 71. } 72. }, 73. "delivery": { 74. "timestamp": "2016-10-19T23:21:04.133Z", 75. "processingTimeMillis": 11893, 76. "recipients": [ 77. "recipient@example.com" 78. ], 79. "smtpResponse": "250 2.6.0 Message received", 80. "remoteMtaIp": "123.456.789.012", 81. "reportingMTA": "mta.example.com" 82. } 83. } ``` ## Registro Send El siguiente es el ejemplo de un registro de evento `Send` que Amazon SES publica en Amazon SNS. Algunos campos no siempre están presentes. Por ejemplo, con un correo electrónico con plantilla, el asunto se representa más tarde y se incluye en eventos posteriores. ``` 1. { 2. "eventType": "Send", 3. "mail": { 4. "timestamp": "2016-10-14T05:02:16.645Z", 5. "source": "sender@example.com", 6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId": "123456789012", 8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination": [ 10. "recipient@example.com" 11. ], 12. "headersTruncated": false, 13. "headers": [ 14. { 15. "name": "From", 16. "value": "sender@example.com" 17. }, 18. { 19. "name": "To", 20. "value": "recipient@example.com" 21. }, 22. { 23. "name": "Subject", 24. "value": "Message sent from Amazon SES" 25. }, 26. { 27. "name": "MIME-Version", 28. "value": "1.0" 29. }, 30. { 31. "name": "Content-Type", 32. "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\"" 33. }, 34. { 35. "name": "X-SES-MESSAGE-TAGS", 36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2" 37. } 38. ], 39. "commonHeaders": { 40. "from": [ 41. "sender@example.com" 42. ], 43. "to": [ 44. "recipient@example.com" 45. ], 46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 47. "subject": "Message sent from Amazon SES" 48. }, 49. "tags": { 50. "ses:configuration-set": [ 51. "ConfigSet" 52. ], 53. "ses:source-ip": [ 54. "192.0.2.0" 55. ], 56. "ses:from-domain": [ 57. "example.com" 58. ], 59. "ses:caller-identity": [ 60. "ses_user" 61. ], 62. "myCustomTag1": [ 63. "myCustomTagValue1" 64. ], 65. "myCustomTag2": [ 66. "myCustomTagValue2" 67. ] 68. } 69. }, 70. "send": {} 71. } ``` ## Registro Reject El siguiente es el ejemplo de un registro de evento `Reject` que Amazon SES publica en Amazon SNS. ``` 1. { 2. "eventType": "Reject", 3. "mail": { 4. "timestamp": "2016-10-14T17:38:15.211Z", 5. "source": "sender@example.com", 6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId": "123456789012", 8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination": [ 10. "sender@example.com" 11. ], 12. "headersTruncated": false, 13. "headers": [ 14. { 15. "name": "From", 16. "value": "sender@example.com" 17. }, 18. { 19. "name": "To", 20. "value": "recipient@example.com" 21. }, 22. { 23. "name": "Subject", 24. "value": "Message sent from Amazon SES" 25. }, 26. { 27. "name": "MIME-Version", 28. "value": "1.0" 29. }, 30. { 31. "name": "Content-Type", 32. "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\"" 33. }, 34. { 35. "name": "X-SES-MESSAGE-TAGS", 36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2" 37. } 38. ], 39. "commonHeaders": { 40. "from": [ 41. "sender@example.com" 42. ], 43. "to": [ 44. "recipient@example.com" 45. ], 46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 47. "subject": "Message sent from Amazon SES" 48. }, 49. "tags": { 50. "ses:configuration-set": [ 51. "ConfigSet" 52. ], 53. "ses:source-ip": [ 54. "192.0.2.0" 55. ], 56. "ses:from-domain": [ 57. "example.com" 58. ], 59. "ses:caller-identity": [ 60. "ses_user" 61. ], 62. "myCustomTag1": [ 63. "myCustomTagValue1" 64. ], 65. "myCustomTag2": [ 66. "myCustomTagValue2" 67. ] 68. } 69. }, 70. "reject": { 71. "reason": "Bad content" 72. } 73. } ``` ## Registro Open El siguiente es un ejemplo de un registro de evento `Open` que Amazon SES publica en Amazon SNS. ``` 1. { 2. "eventType": "Open", 3. "mail": { 4. "commonHeaders": { 5. "from": [ 6. "sender@example.com" 7. ], 8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "subject": "Message sent from Amazon SES", 10. "to": [ 11. "recipient@example.com" 12. ] 13. }, 14. "destination": [ 15. "recipient@example.com" 16. ], 17. "headers": [ 18. { 19. "name": "X-SES-CONFIGURATION-SET", 20. "value": "ConfigSet" 21. }, 22. { 23. "name":"X-SES-MESSAGE-TAGS", 24. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2" 25. }, 26. { 27. "name": "From", 28. "value": "sender@example.com" 29. }, 30. { 31. "name": "To", 32. "value": "recipient@example.com" 33. }, 34. { 35. "name": "Subject", 36. "value": "Message sent from Amazon SES" 37. }, 38. { 39. "name": "MIME-Version", 40. "value": "1.0" 41. }, 42. { 43. "name": "Content-Type", 44. "value": "multipart/alternative; boundary=\"XBoundary\"" 45. } 46. ], 47. "headersTruncated": false, 48. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 49. "sendingAccountId": "123456789012", 50. "source": "sender@example.com", 51. "tags": { 52. "myCustomTag1":[ 53. "myCustomValue1" 54. ], 55. "myCustomTag2":[ 56. "myCustomValue2" 57. ], 58. "ses:caller-identity": [ 59. "IAM_user_or_role_name" 60. ], 61. "ses:configuration-set": [ 62. "ConfigSet" 63. ], 64. "ses:from-domain": [ 65. "example.com" 66. ], 67. "ses:source-ip": [ 68. "192.0.2.0" 69. ] 70. }, 71. "timestamp": "2017-08-09T21:59:49.927Z" 72. }, 73. "open": { 74. "ipAddress": "192.0.2.1", 75. "timestamp": "2017-08-09T22:00:19.652Z", 76. "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60" 77. } 78. } ``` ## Registro Click El siguiente es el ejemplo de un registro de evento `Click` que Amazon SES publica en Amazon SNS. ``` 1. { 2. "eventType": "Click", 3. "click": { 4. "ipAddress": "192.0.2.1", 5. "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html", 6. "linkTags": { 7. "samplekey0": [ 8. "samplevalue0" 9. ], 10. "samplekey1": [ 11. "samplevalue1" 12. ] 13. }, 14. "timestamp": "2017-08-09T23:51:25.570Z", 15. "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36" 16. }, 17. "mail": { 18. "commonHeaders": { 19. "from": [ 20. "sender@example.com" 21. ], 22. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 23. "subject": "Message sent from Amazon SES", 24. "to": [ 25. "recipient@example.com" 26. ] 27. }, 28. "destination": [ 29. "recipient@example.com" 30. ], 31. "headers": [ 32. { 33. "name": "X-SES-CONFIGURATION-SET", 34. "value": "ConfigSet" 35. }, 36. { 37. "name":"X-SES-MESSAGE-TAGS", 38. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2" 39. }, 40. { 41. "name": "From", 42. "value": "sender@example.com" 43. }, 44. { 45. "name": "To", 46. "value": "recipient@example.com" 47. }, 48. { 49. "name": "Subject", 50. "value": "Message sent from Amazon SES" 51. }, 52. { 53. "name": "MIME-Version", 54. "value": "1.0" 55. }, 56. { 57. "name": "Content-Type", 58. "value": "multipart/alternative; boundary=\"XBoundary\"" 59. }, 60. { 61. "name": "Message-ID", 62. "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000" 63. } 64. ], 65. "headersTruncated": false, 66. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 67. "sendingAccountId": "123456789012", 68. "source": "sender@example.com", 69. "tags": { 70. "myCustomTag1":[ 71. "myCustomValue1" 72. ], 73. "myCustomTag2":[ 74. "myCustomValue2" 75. ], 76. "ses:caller-identity": [ 77. "ses_user" 78. ], 79. "ses:configuration-set": [ 80. "ConfigSet" 81. ], 82. "ses:from-domain": [ 83. "example.com" 84. ], 85. "ses:source-ip": [ 86. "192.0.2.0" 87. ] 88. }, 89. "timestamp": "2017-08-09T23:50:05.795Z" 90. } 91. } ``` ## Registro Rendering Failure El siguiente es el ejemplo de un registro de evento `Rendering Failure` que Amazon SES publica en Amazon SNS. ``` 1. { 2. "eventType":"Rendering Failure", 3. "mail":{ 4. "timestamp":"2018-01-22T18:43:06.197Z", 5. "source":"sender@example.com", 6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId":"123456789012", 8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination":[ 10. "recipient@example.com" 11. ], 12. "headersTruncated":false, 13. "tags":{ 14. "ses:configuration-set":[ 15. "ConfigSet" 16. ] 17. } 18. }, 19. "failure":{ 20. "errorMessage":"Attribute 'attributeName' is not present in the rendering data.", 21. "templateName":"MyTemplate" 22. } 23. } ``` ## DeliveryDelay registro El siguiente es el ejemplo de un registro de evento `DeliveryDelay` que Amazon SES publica en Amazon SNS. ``` 1. { 2. "eventType": "DeliveryDelay", 3. "mail":{ 4. "timestamp":"2020-06-16T00:15:40.641Z", 5. "source":"sender@example.com", 6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId":"123456789012", 8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", 9. "destination":[ 10. "recipient@example.com" 11. ], 12. "headersTruncated":false, 13. "tags":{ 14. "ses:configuration-set":[ 15. "ConfigSet" 16. ] 17. } 18. }, 19. "deliveryDelay": { 20. "timestamp": "2020-06-16T00:25:40.095Z", 21. "delayType": "TransientCommunicationFailure", 22. "expirationTime": "2020-06-16T00:25:40.914Z", 23. "delayedRecipients": [{ 24. "emailAddress": "recipient@example.com", 25. "status": "4.4.1", 26. "diagnosticCode": "smtp; 421 4.4.1 Unable to connect to remote host" 27. }] 28. } 29. } ``` ## Registro de suscripción El siguiente es un ejemplo de un registro de evento `Subscription` que Amazon SES publica en Firehose. ``` 1. { 2. "eventType": "Subscription", 3. "mail": { 4. "timestamp": "2022-01-12T01:00:14.340Z", 5. "source": "sender@example.com", 6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", 7. "sendingAccountId": "123456789012", 8. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000", 9. "destination": ["recipient@example.com"], 10. "headersTruncated": false, 11. "headers": [ 12. { 13. "name": "From", 14. "value": "sender@example.com" 15. }, 16. { 17. "name": "To", 18. "value": "recipient@example.com" 19. }, 20. { 21. "name": "Subject", 22. "value": "Message sent from Amazon SES" 23. }, 24. { 25. "name": "MIME-Version", 26. "value": "1.0" 27. }, 28. { 29. "name": "Content-Type", 30. "value": "text/html; charset=UTF-8" 31. }, 32. { 33. "name": "Content-Transfer-Encoding", 34. "value": "7bit" 35. } 36. ], 37. "commonHeaders": { 38. "from": ["sender@example.com"], 39. "to": ["recipient@example.com"], 40. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000", 41. "subject": "Message sent from Amazon SES" 42. }, 43. "tags": { 44. "ses:operation": ["SendEmail"], 45. "ses:configuration-set": ["ConfigSet"], 46. "ses:source-ip": ["192.0.2.0"], 47. "ses:from-domain": ["example.com"], 48. "ses:caller-identity": ["ses_user"], 49. "myCustomTag1": ["myCustomValue1"], 50. "myCustomTag2": ["myCustomValue2"] 51. } 52. }, 53. "subscription": { 54. "contactList": "ContactListName", 55. "timestamp": "2022-01-12T01:00:17.910Z", 56. "source": "UnsubscribeHeader", 57. "newTopicPreferences": { 58. "unsubscribeAll": true, 59. "topicSubscriptionStatus": [ 60. { 61. "topicName": "ExampleTopicName", 62. "subscriptionStatus": "OptOut" 63. } 64. ] 65. }, 66. "oldTopicPreferences": { 67. "unsubscribeAll": false, 68. "topicSubscriptionStatus": [ 69. { 70. "topicName": "ExampleTopicName", 71. "subscriptionStatus": "OptOut" 72. } 73. ] 74. } 75. } 76. } ```