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á.
# Habilitar notificações por push para chat móvel
As notificações por push para chat móvel são configuradas por meio do [AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html). É possível habilitar as notificações por push para chat móvel em dispositivos iOS ou Android, permitindo alertar os clientes sobre novas mensagens mesmo quando eles não estão usando ativamente sua aplicação móvel. Você pode ativar esse recurso em seu aplicativo existente integrado ao [Connect Customer celular SDKs](https://docs.aws.amazon.com/connect/latest/adminguide/integrate-chat-with-mobile.html), a uma [solução de webview](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples) ou a uma solução nativa personalizada.
As etapas e os recursos a seguir ajudarão você a começar a integrar notificações Connect Customer push em seus aplicativos móveis nativos:
## Etapa 1: obter credenciais do console FCM da Apple APNs e do Google
Para configurar para que ele Connect Customer possa enviar notificações push para seus aplicativos, primeiro você precisa obter credenciais do console FCM da Apple APNs e do Google que permitirão que o [AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html) envie notificações para seus aplicativos móveis. As credenciais que você fornece dependem do sistema de notificação por push usado:
+ Para obter as credenciais do serviço Apple Push Notification (APNs), consulte [Obter uma chave de criptografia e um ID de chave da Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns#Obtain-an-encryption-key-and-key-ID-from-Apple) e [Obter um certificado de provedor da Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-certificate-based-connection-to-apns#Obtain-a-provider-certificate-from-Apple) na documentação do desenvolvedor da Apple.
+ É possível receber as credenciais do Firebase Cloud Messaging (FCM) do Google por meio do console do Firebase. Consulte [Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging).
## Etapa 2: criar um aplicativo de serviço de mensagens para o usuário AWS final usando o AWS console e ativar o canal de notificação push para o FCM ou APNs
Antes de habilitar o Amazon Connect para enviar notificações por push, primeiro você precisa [criar uma aplicação do AWS End User Messaging e habilitar o canal de notificações por push](https://docs.aws.amazon.com/push-notifications/latest/userguide/procedure-enable-push.html) no [console da AWS](https://console.aws.amazon.com/push-notifications/).
Siga estas instruções para criar uma aplicação e habilitar qualquer um dos canais por push. Para concluir esse procedimento, basta inserir o nome da aplicação. Você pode habilitar ou desabilitar qualquer um dos canais por push posteriormente:
1. Abra o console AWS End User Messaging Push em [https://console.aws.amazon.com/push-notifications/](https://console.aws.amazon.com/push-notifications/)
1. Selecione **Criar aplicativo**.
1. Em **Nome da aplicação**, insira um nome para sua aplicação.
1. (Opcional) Siga esta etapa opcional para ativar o **serviço Apple Push Notification (APNs)**.
1. Para o **serviço Apple Push Notification (APNs)**, selecione **Ativar**.
1. Em **Tipo de autenticação padrão**, selecione:
1. Se você escolher **Credenciais chave**, forneça as seguintes informações da sua conta de desenvolvedor da Apple. AWS O End User Messaging Push requer essas informações para criar tokens de autenticação.
1. **ID de chave**: o ID atribuído à sua chave de assinatura.
1. **Identificador do pacote**: o ID atribuído ao seu aplicativo iOS.
1. **Identificador da equipe**: o ID atribuído à sua equipe de conta de Desenvolvedor da Apple.
1. **Chave de autenticação**: o arquivo .p8 que você baixa da sua conta de desenvolvedor da Apple ao criar uma chave de autenticação.
1. Se você escolher **Credenciais do certificado**, forneça as seguintes informações:
1. **Certificado SSL**: o arquivo .p12 do certificado TLS.
1. **Senha do certificado**: se você atribuiu uma senha ao certificado, insira-a aqui.
1. **Tipo de certificado**: selecione o tipo de certificado a ser usado.
1. (Opcional) Siga esta etapa opcional para habilitar o **Firebase Cloud Messaging (FCM**).
1. No caso do **Firebase Cloud Messaging (FCM)**, selecione **Habilitar**.
1. Escolha **Credenciais de token** para o **Tipo de autenticação padrão** e, depois, escolha seu arquivo JSON de serviço.
1. Selecione **Criar aplicativo**.
## Etapa 3: associar o aplicativo AWS End User Messaging a uma Connect Customer instância
Para habilitar notificações push em uma [Connect Customer instância](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html), você precisará associar um aplicativo de mensagens de usuário AWS final a uma [Connect Customer instância](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html) chamando a [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API com `PINPOINT_APP` [IntegrationType](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html#API_CreateIntegrationAssociation_RequestSyntax)o. É possível chamar essa API com [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/connect/create-integration-association.html) ou com o [SDK do Amazon Connect](https://aws.amazon.com/developer/tools/) para qualquer idioma aceito. Essa é uma etapa única de integração necessária para cada integração entre um aplicativo de mensagens de usuário AWS final e uma Connect Customer instância.
## Etapa 4: obtenha o token do dispositivo com o FCM ou o APNs SDK e registre-o com Connect Customer
Você precisará buscar o token do dispositivo e usá-lo para registrar um dispositivo móvel do usuário final com um contato de Connect Customer bate-papo para enviar notificações push para novas mensagens no bate-papo. Leia a documentação do FCM/APNs desenvolvedor abaixo para saber como o token do dispositivo é gerado e obtido do aplicativo móvel.
+ Para o serviço Apple Push Notification (APN), consulte [Registrar seu aplicativo APNs na documentação](https://developer.apple.com/documentation/usernotifications/registering-your-app-with-apns) do Apple Developer.
+ Em relação ao Firebase Cloud Messaging (FCM), consulte [Práticas recomendadas de gerenciamento do token de registro do FCM](https://firebase.google.com/docs/cloud-messaging/manage-tokens).
Para registrar o dispositivo com um contato de chat, recomendamos fazer o seguinte:
1. Quando o aplicativo móvel chamar a [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API, transmita o `deviceToken` e `deviceType` como [atributos de contato](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes). Para usuários do webview e do widget de comunicação hospedado, consulte [Como transmitir atributos de contato para o widget de comunicação](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html#how-to-contact-attributes-chatwidget) para acessar mais detalhes.
1. Incorpore uma chamada para a [CreatePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreatePushNotificationRegistration.html)ação em uma função Lambda em um fluxo de contato. O bloco de fluxo deve ler o `deviceToken` e o `deviceType` por meio dos atributos de contato definidos pelo usuário e o `initialContactId` dos atributos do sistema e, depois, transmitir esses valores para a função do Lambda.
1. Dependendo do seu caso de uso, coloque a função do Lambda imediatamente após iniciar o chat (no início do fluxo), se você quiser que o usuário final receba notificações por push imediatamente, ou logo antes de encaminhar o contato para uma fila para que ele receba o contato somente quando o atendente estiver prestes a entrar. Depois que a chamada de API for feita, o dispositivo começará a receber notificações por push quando uma nova mensagem for enviada pelo atendente ou pelo sistema. Por padrão, as notificações por push serão enviadas para todas as mensagens do sistema e do atendente.
1. (opcional) Incorpore uma chamada para a [DeletePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeletePushNotificationRegistration.html)ação em uma função Lambda em um fluxo. Depois que a chamada de API for feita, o dispositivo deixará de receber notificações por push quando uma nova mensagem for enviada pelo atendente ou pelo sistema.
## Etapa 5: receber notificações por push suas aplicações móveis
Confira nosso projeto de [exemplos de interface de usuário do Connect Customer Chat](https://github.com/amazon-connect/amazon-connect-chat-ui-examples) e consulte nossos exemplos de visualizações na web de bate-papo para [iOS](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/iOS-WKWebView-sample) e [Android](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/android-webview-sample) que mostram como Connect Customer APIs integrar e receber notificações push.
## Monitorar o uso de notificações por push
Para garantir a confiabilidade, a disponibilidade e o desempenho de suas notificações por push, é fundamental monitorar o uso delas. É possível acompanhar essas informações por meio de vários canais:
1. AWS fornece ferramentas abrangentes de monitoramento para notificações push. Para obter mais informações, consulte [Monitorando AWS o push de mensagens do usuário final](https://docs.aws.amazon.com/push-notifications/latest/userguide/monitoring-overview.html).
1. Dependendo do serviço de notificação por push que você está usando, você pode acessar dados de uso adicionais por meio de seus respectivos consoles.
1. Firebase Cloud Messaging (FCM): consulte na documentação do FCM o capítulo [Noções básicas sobre o envio de mensagens](https://firebase.google.com/docs/cloud-messaging/understand-delivery?platform=android) para acessar informações sobre o uso do FCM.
1. Serviço de notificação push da Apple (APNs): consulte a seção de APNs documentação sobre como [visualizar o status das notificações push usando métricas e APNs](https://developer.apple.com/documentation/usernotifications/viewing-the-status-of-push-notifications-using-metrics-and-apns) monitorar o status das notificações.