Notificações SNS de eventos de aplicativos da Amazon para aplicativos móveis - Amazon Simple Notification Service

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á.

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

SNSA Amazon fornece suporte para acionar notificações quando ocorrem determinados eventos do aplicativo. Em seguida, você pode executar algumas ações programáticas nesse evento. Seu aplicativo deve incluir suporte para um serviço de notificação 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 SNS console da Amazon ou AWS SDKs o. AWS CLI

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 Usando os atributos do SNS aplicativo Amazon para 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. À medida que a Amazon SNS envia as notificações, o tópico pode encaminhá-las para endpoints que realizarã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 HTTP endpointsHTTPS, filas ou funções da AmazonSQS. 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 SNS console da Amazon, o AWS Command Line Interface (AWS CLI) ou AWS SDKs o.

AWS Management Console

  1. Faça login no SNSconsole da Amazon.

  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 ARNs os quatro tópicos a serem usados nos 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 SNS tópico da Amazon para todos os quatro eventos do aplicativo:

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 à Amazon SNS API usando um AWS SDK.

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