Amazon Simple Notification Service
Guía para desarrolladores

Notificaciones de eventos de aplicaciones

Amazon SNS proporciona compatibilidad con la activación de notificaciones cuando se producen determinados eventos de aplicaciones. Después puede ejecutar algunas acciones por programación en dicho evento. La aplicación debe ser compatible con un servicio de notificaciones push como Apple Push Notification Service (APNs), Mensajería de la nube de Firebase (FCM) y Windows Push Notification Services (WNS). Defina las notificaciones de eventos de aplicaciones usando la consola de Amazon SNS, la interfaz de línea de comandos de AWS o los SDK de AWS.

Eventos de aplicaciones disponibles

Las notificaciones de eventos de aplicaciones hacen un seguimiento de cuándo se crean, eliminan o actualizan los puntos de enlace individuales de la plataforma, así como los errores de entrega. A continuación se muestran los nombres de los atributos para los eventos de la aplicación.

Nombre del atributo Desencadenador de la notificación
EventEndpointCreated Se añade a la aplicación un nuevo punto de enlace de la plataforma.
EventEndpointDeleted Se elimina cualquier punto de enlace de la plataforma asociado a la aplicación.
EventEndpointUpdated Se cambia cualquiera de los atributos de los puntos de enlace de la plataforma asociados a la aplicación.
EventDeliveryFailure Una entrega a cualquiera de los puntos de enlace de la plataforma asociados a la aplicación encuentra un error permanente.

nota

Para realizar un seguimiento de los errores de entrega en el lado de la aplicación de la plataforma, suscríbase a los eventos de estado de entrega de los mensajes para la aplicación. Para obtener más información, consulte Uso de los atributos de las aplicaciones de Amazon SNS para el estado de entrega de los mensajes.

Puede asociar cualquier atributo a una aplicación, que podrá recibir estas notificaciones de eventos.

Envío de notificaciones push en móvil

Para enviar notificaciones de eventos de aplicaciones, debe especificar un tema para recibir las notificaciones de cada tipo de evento. Como Amazon SNS envía las notificaciones, el tema puede direccionarlas a los puntos de enlace que adoptarán medidas programáticas.

importante

Las aplicaciones de alto volumen crearán un gran número de notificaciones de eventos de aplicaciones (por ejemplo, decenas de miles), que sobrepasarán los puntos de enlace destinados a uso humano, como, por ejemplo, números de teléfono, direcciones de correo electrónico y aplicaciones móviles. Tenga en cuenta las siguientes directrices cuando envíe notificaciones de eventos de aplicaciones a un tema:

  • Los temas que reciban notificaciones deben contener solo suscripciones de puntos de enlace de programación, como puntos de enlace HTTP o HTTPS, colas de Amazon SQS o funciones de AWS Lambda.

  • Para reducir la cantidad de procesamiento que las notificaciones activan, limite las suscripciones de cada tema a un número reducido (por ejemplo, cinco o menos).

Puede enviar notificaciones de eventos de aplicaciones mediante la consola de Amazon SNS, la AWS Command Line Interface (AWS CLI) o los SDK de AWS.

Consola de administración de AWS

  1. Inicie sesión en la consola de Amazon SNS.

  2. En el panel de navegación, elija Mobile (Móvil), Push notifications (Notificaciones push).

  3. En la página Mobile push notifications (Notificaciones push en móviles), en la sección Platform applications (Aplicaciones de la plataforma), seleccione una aplicación y, a continuación, elija Edit (Editar).

  4. Expanda la sección Event notifications (Notificaciones de eventos).

  5. Elija Actions (Acciones), Configure events (Configurar eventos).

  6. Escriba los ARN de los temas que se van a utilizar para los siguientes eventos:

    • Punto de enlace creado

    • Punto de enlace eliminado

    • Punto de enlace actualizado

    • Error de entrega

  7. Elija Save changes (Guardar cambios).

AWS CLI

Ejecute el comando set-platform-application-attributes.

En el siguiente ejemplo se establece el mismo tema de Amazon SNS para los cuatro eventos de aplicación:

aws sns set-platform-application-attributes --platform-application-arn arn:aws:sns:us-east-1:12345EXAMPLE:app/FCM/MyFCMPlatformApplication --attributes EventEndpointCreated="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents", EventEndpointDeleted="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents", EventEndpointUpdated="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents", EventDeliveryFailure="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents"

SDK de AWS

Llame a una de las siguientes API, según su lenguaje de programación o plataforma de destino: