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

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Eventos de aplicativo móvel

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 notificações de eventos do aplicativo usando o console do Amazon SNS ou os AWS CLI 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 somente assinaturas de endpoints programáticos, como endpoints HTTP ou HTTPS, filas ou funções do Amazon SQS. 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 do aplicativo usando o console do Amazon SNS, o 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 Mobile (Dispositivos móveis), Push notifications (Notificações por push).

  3. Na página de notificações push móveis, na seção Aplicativos da plataforma, escolha um aplicativo e escolha Editar.

  4. Expanda a seção Event notifications (Notificações de eventos).

  5. Escolha Actions (Ações), Configure events (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 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"

AWS SDKs

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

Para obter uma lista completa dos guias do desenvolvedor do AWS SDK e exemplos de código, incluindo ajuda para começar e informações sobre versões anteriores, consulteUsando o Amazon SNS com um SDK AWS.