Configuración de notificaciones de Amazon SNS para Amazon SES

Amazon SES puede informarle de los rebotes, los reclamos y las entregas mediante Amazon Simple Notification Service (Amazon SNS).

Puede configurar las notificaciones en la consola de Amazon SES o mediante la API de Amazon SES.

Requisitos previos

Realice los pasos siguientes antes de configurar notificaciones de Amazon SNS en Amazon SES:

1. Cree un tema en Amazon SNS. Para obtener más información, consulte Creación de un tema 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).

   Tanto si crea un nuevo tema de SNS como si selecciona uno existente, debe conceder acceso a SES para publicar notificaciones en el tema.

   Para conceder permiso a Amazon SES para publicar notificaciones en el tema, en la pantalla Edit topic (Editar tema) de la consola de SNS, expanda Access policy (Política de acceso) y en el editor de JSON, agregue la siguiente política de permisos:

   {
     "Version": "2012-10-17",
     "Id": "notification-policy",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "ses.amazonaws.com"
         },
         "Action": "sns:Publish",
         "Resource": "arn:aws:sns:topic_region:111122223333:topic_name",
         "Condition": {
           "StringEquals": {
             "AWS:SourceAccount": "111122223333",
             "AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:identity/identity_name"
           }
         }
       }
     ]
   }

   En el ejemplo anterior de política, realice los siguientes cambios:

   • Reemplace topic_region por la región de AWS en la que creó el tema de SNS.

   • Reemplace 111122223333 por su ID de cuenta de AWS.

   • Reemplace topic_name por el nombre del tema de SNS.

   • Reemplace identity_name por la identidad verificada (dirección de correo electrónico o dominio) que se está suscribiendo al tema de SNS.

2. Suscriba al menos un punto de enlace al tema. Por ejemplo, si desea recibir notificaciones por mensaje de texto, suscriba un punto de enlace de SMS (es decir, un número de teléfono móvil) al tema. Para recibir notificaciones por correo electrónico, suscriba un punto de enlace de correo electrónico (una dirección de correo electrónico) al tema.

   Para obtener más información, consulte Introducción en la Guía para desarrolladores de Amazon Simple Notification Service.

3. (Opcional) Si su tema de Amazon SNS utiliza AWS Key Management Service (AWS KMS) para el cifrado del lado del servidor, tendrá que agregar permisos a la política de claves de AWS KMS. Puede añadir permisos asociando la siguiente política a la política de claves de AWS KMS:

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "AllowSESToUseKMSKey",
               "Effect": "Allow",
               "Principal": {
                   "Service": "ses.amazonaws.com"
               },
               "Action": [
                   "kms:GenerateDataKey",
                   "kms:Decrypt"
               ],
               "Resource": "*"
           }
       ]
   }

Configuración de notificaciones con la consola de Amazon SES

Para configurar notificaciones mediante la consola de Amazon SES

1. Abra la consola de Amazon SES en https://console.aws.amazon.com/ses/.

2. En el panel de navegación, en Configuration (Configuración), elija Verified identities (Identidades verificadas).

3. En el contenedor Identities (Identidades), seleccione la identidad verificada de la que desea recibir notificaciones de valoraciones cuando un mensaje enviado desde esta identidad produzca un rebote, un reclamo o una entrega.

   importante

   La configuración de notificaciones de dominio verificada se aplican a todos los correos electrónicos enviados desde las direcciones de correo electrónico en dicho dominio excepto para las direcciones de correo electrónico que también se han verificado.

4. En la pantalla de detalles de la identidad verificada que seleccionó, elija la pestaña Notifications (Notificaciones) y seleccione Edit (Editar) en el contenedor Feedback notifications (Notificaciones de valoración).

5. Expanda el cuadro de lista de temas de SNS de cada tipo de valoración para la que desee recibir notificaciones y seleccione un tema de SNS que le pertenezca, No SNS topic (Sin tema de SNS), o bien SNS topic you don’t own (Tema de SNS que no le pertenece).

   1. Si eligió SNS topic you don’t own (Tema de SNS que no le pertenece), aparecerá el campo SNS topic ARN (ARN del tema de SNS) y deberá introducir el ARN del tema de SNS que el remitente delegado le ha compartido. (Solo el remitente delegado recibirá estas notificaciones porque es propietario del tema de SNS. Para obtener más información acerca de los envíos delegados, consulte Información general de la autorización de envío).

   importante

   Los temas de Amazon SNS que utiliza para las notificaciones de rebotes, reclamos y entregas deben estar en la misma Región de AWS en la que utiliza Amazon SES.

   Además, tiene que suscribir uno o varios puntos de enlace al tema para recibir notificaciones. Por ejemplo, si desea que las notificaciones se envíen a una dirección de correo electrónico, tiene que suscribir un punto de enlace de correo electrónico al tema. Para obtener más información, consulte Introducción en la Guía para desarrolladores de Amazon Simple Notification Service.

6. (Opcional) Si desea que la notificación del tema incluya los encabezados del correo electrónico original, marque la casilla Include original email headers (Incluir encabezados de correo electrónico originales) directamente debajo del nombre del tema de SNS de cada tipo de valoración. Esta opción solo está disponible si ha asignado un tema de Amazon SNS al tipo de notificación asociado. Para obtener información sobre el contenido de los encabezados de correo electrónico originales, consulte el objeto mail en Contenido de las notificaciones.

7. Elija Save changes. Los cambios que haya realizado en su configuración de notificaciones podrían tardar varios minutos en surtir efecto.

8. (Opcional) Si eligió las notificaciones de tema de Amazon SNS tanto para rebotes como para reclamos, puede desactivar las notificaciones por correo electrónico en su totalidad para que no reciba notificaciones dobles a través de correo electrónico y notificaciones de SNS. Para desactivar las notificaciones por correo electrónico de rebotes y reclamos, en la pestaña Notifications (Notificaciones) en la pantalla de detalles de la identidad verificada, en el contenedor Email Feedback Forwarding (Reenvío de valoración de correo), elija Edit (Editar), desmarque la casilla Enabled (Habilitado), y elija Save changes (Guardar los cambios).

Después de configurar sus ajustes, comenzará a recibir notificaciones de rebotes, reclamos o entregas en sus temas de Amazon SNS. Estas notificaciones están en formato JavaScript Object Notation (JSON) y siguen la estructura que se describe en Contenido de las notificaciones.

Se le cobrarán las tarifas estándar de Amazon SNS para notificaciones de rebotes, reclamos y entregas. Para obtener más información, consulte la Página de precios de Amazon SNS.

nota

Si se produce un error al intentar publicar en el tema de Amazon SNS porque el tema se ha eliminado o la Cuenta de AWS ya no tiene permisos para publicar en él, Amazon SES eliminará la configuración de dicho tema si se ha configurado para rebotes o quejas (no para entregas; para las notificaciones de entrega, SES no eliminará la configuración de tema de SNS). Además, Amazon SES volverá a habilitar las notificaciones por correo electrónico de rebotes y reclamos para la identidad y se recibirá una notificación del cambio por correo electrónico. Si se configuran varias identidades para utilizar el tema, la configuración del tema de cada identidad cambia cuando cada identidad experimenta un error al publicar en el tema.

Configuración de notificaciones con la API de Amazon SES

También puede configurar notificaciones de rebotes, reclamos y entregas con la API de Amazon SES. Utilice las siguientes operaciones para configurar las notificaciones:

• SetIdentityNotificationTopic

• SetIdentityFeedbackForwardingEnabled

• GetIdentityNotificationAttributes

• SetIdentityHeadersInNotificationsEnabled

Puede utilizar estas acciones de la API para escribir una aplicación front-end personalizada para notificaciones. Para obtener una descripción completa de las acciones de la API relacionadas con las notificaciones, consulte la Referencia de la API de Amazon Simple Email Service.

Solución de problemas de notificaciones de retroalimentación

No recibir notificaciones

Si no recibe notificaciones, asegúrese de que ha suscrito un punto de enlace al tema a través del que se envían notificaciones. Cuando suscriba un punto de enlace de correo electrónico a un tema, recibirá un correo electrónico que le pedirá que confirme su suscripción. Debe confirmar su suscripción antes de empezar a recibir notificaciones por correo electrónico. Para obtener más información, consulte Introducción en la Guía para desarrolladores de Amazon Simple Notification Service.

Error InvalidParameterValue al elegir un tema

Si recibe un error que indica que se ha producido un error InvalidParameterValue, consulte el tema de Amazon SNS para ver si está cifrado con AWS KMS. Si es así, tendrá que modificar la política de la clave de AWS KMS. Consulte Requisitos previos para ver un ejemplo de política.