Notificações de eventos do aplicativo Amazon SNS para aplicativos móveis - Amazon Simple Notification Service
Eventos do aplicativo disponíveisEnviar notificações por push para dispositivos móveis

Notificações de eventos do aplicativo Amazon SNS para aplicativos móveis

O Amazon SNS fornece suporte para acionar as notificações quando determinados eventos da aplicação ocorrem. Em seguida, você pode executar algumas ações programáticas nesse evento. A aplicação deve incluir suporte a um serviço de notificação por push, como Apple Push Notification Service (APNs), Firebase Cloud Messaging (FCM) e Windows Push Notification Services (WNS). Você define as notificações de eventos da aplicação usando o console do Amazon SNS, a AWS CLI ou os AWS SDKs.

Eventos do aplicativo disponíveis

As notificações de eventos do aplicativo rastreiam quando endpoints de plataforma individuais são criados, excluídos e atualizados, bem como as falhas de entrega. A seguir estão os nomes de atributo para os eventos do aplicativo.

Nome do atributo Trigger para a notificação
EventEndpointCreated Um novo endpoint de plataforma é adicionado ao seu aplicativo.
EventEndpointDeleted Qualquer endpoint de plataforma associado ao seu aplicativo é excluído.
EventEndpointUpdated Qualquer um dos atributos dos endpoints de plataforma associados ao seu aplicativo é alterado.
EventDeliveryFailure Uma entrega para qualquer um dos endpoints de plataforma associados ao seu aplicativo encontra uma falha permanente.
nota

Para rastrear falhas de entrega no aplicativo da plataforma, inscreva-se em eventos de status de entrega de mensagens para o aplicativo. Para obter mais informações, consulte Usar atributos de aplicativo do Amazon SNS para obter o status de entrega de mensagens.

Você pode associar qualquer atributo a um aplicativo que poderá então receber essas notificações de eventos.

Enviar notificações por push para dispositivos móveis

Para enviar notificações de eventos do aplicativo, você especifica um tópico para receber notificações de cada tipo de evento. Como o Amazon SNS envia notificações, o tópico pode direcioná-las para endpoints que executarão ações programáticas.

Importante

Aplicativos de grande volume criarão um grande número de notificações de eventos do aplicativo (por exemplo, dezenas de milhares), que sobrecarregarão os endpoints destinados ao uso humano, como endereços de e-mail, números de telefone e aplicativos móveis. Considere as seguintes diretrizes ao enviar as notificações de eventos do aplicativo para um tópico:

  • Cada tópico que recebe notificações deve conter apenas inscrições para endpoints programáticos, como, por exemplo, endpoints HTTP ou HTTPS, filas do Amazon SQS ou funções do AWS Lambda.

  • Para reduzir a quantidade de processamento que é acionada pelas notificações, limite as inscrições de cada tópico em um pequeno número (por exemplo, cinco ou menos).

Você pode enviar notificações de eventos da aplicação usando o console do Amazon SNS, a AWS Command Line Interface (AWS CLI) ou os AWS SDKs.

AWS Management Console

  1. Faça login no console do Amazon SNS.

  2. No painel de navegação, escolha Dispositivos móveis, Notificações por push.

  3. Na página Notificações por push para dispositivos móveis, na seção Aplicativos de plataforma, selecione um aplicativo e escolha Editar.

  4. Expanda a seção Notificações de eventos.

  5. Escolha Ações, Configurar eventos.

  6. Insira os ARNs dos tópicos a serem usados para os seguintes eventos:

    • Endpoint criado

    • Endpoint excluído

    • Endpoint atualizado

    • Falha na entrega

  7. Escolha Save changes (Salvar alterações).

AWS CLI

Execute o comando set-platform-application-attributes.

O exemplo a seguir define o mesmo tópico do Amazon SNS para todos os quatro eventos da aplicação:

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"

SDKs da AWS

Defina notificações de eventos de aplicação enviando uma solicitação SetPlatformApplicationAttributes com a API do Amazon SNS usando um AWS SDK.

Para obter a lista completa de Guias do desenvolvedor do SDK e exemplos de código da AWS , incluindo ajuda para começar a usar e informações sobre as versões anteriores, consulte Usando o Amazon SNS com um AWS SDK.