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 de eventos do aplicativo Amazon SNS para aplicativos móveis
<a name="application-event-notifications"></a>

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. 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 console do Amazon SNS ou o. AWS CLI AWS SDKs

## Eventos do aplicativo disponíveis
<a name="application-event-notifications-events"></a>

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.  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](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html).  | 

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
<a name="application-event-notifications-howto-set"></a>

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 o. AWS SDKs 

### Console de gerenciamento da AWS
<a name="application-event-notifications-howto-set-console"></a>

1. Faça login no [console do Amazon SNS](https://console.aws.amazon.com/sns/home).

1. No painel de navegação, escolha **Mobile (Dispositivos móveis)**, **Push notifications (Notificações por push)**.

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

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

1. Escolha **Ações**, **Configurar eventos**.

1. Insira ARNs os quatro tópicos a serem usados nos seguintes eventos:
   + Endpoint criado
   + Endpoint excluído
   + Endpoint atualizado
   + Falha na entrega

1. Escolha **Salvar alterações**.

### AWS CLI
<a name="awscli"></a>

Execute o comando [set-platform-application-attributes](https://docs.aws.amazon.com/cli/latest/reference/sns/set-platform-application-attributes.html).

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
<a name="application-event-notifications-sdk"></a>

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, consulte[Usando o Amazon SNS com um SDK AWS](sdk-general-information-section.md).