Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Activation des notifications push pour le chat mobile
Les notifications push pour le chat mobile sont configurées via la [ messagerie pour utilisateurs finaux AWS](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html). Vous pouvez activer les notifications push pour le chat mobile sur les appareils iOS ou Android afin d’avertir les clients en cas de nouveaux messages même s’ils n’utilisent pas activement votre application mobile. Vous pouvez activer cette fonctionnalité dans votre application existante intégrée au [Connect Customer mobile SDKs](https://docs.aws.amazon.com/connect/latest/adminguide/integrate-chat-with-mobile.html), dans une [solution de visualisation Web](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples) ou dans une solution native personnalisée.
Les étapes et ressources suivantes vous aideront à commencer à intégrer les notifications Connect Customer push dans vos applications mobiles natives :
## Étape 1 : obtenir les informations d'identification de la console FCM d'Apple APNs et de Google
Pour le configurer de Connect Customer manière à ce qu'il puisse envoyer des notifications push à vos applications, vous devez d'abord obtenir les informations d'identification de la console FCM d'Apple APNs et de Google qui permettront à [l'utilisateur AWS final d'](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)envoyer des notifications à vos applications mobiles. Les informations d’identification que vous fournissez dépendent du système de notification push que vous utilisez :
+ Pour les informations d'identification du service de notification push Apple (APNs), consultez les [sections Obtenir une clé de chiffrement et un identifiant de clé auprès d'Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns#Obtain-an-encryption-key-and-key-ID-from-Apple) et [Obtenir un certificat de fournisseur auprès d'Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-certificate-based-connection-to-apns#Obtain-a-provider-certificate-from-Apple) dans la documentation destinée aux développeurs Apple.
+ Pour les informations d’identification Firebase Cloud Messaging (FCM) de Google, elles peuvent être obtenues via la console Firebase (voir [Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging)).
## Étape 2 : créer une application de service de messagerie pour utilisateurs AWS finaux à l'aide de la AWS console et activer le canal de notification push pour FCM ou APNs
Avant de pouvoir activer Amazon Connect pour envoyer des notifications push, vous devez [créer une application de messagerie pour utilisateurs finaux AWS et activer le canal de notifications push](https://docs.aws.amazon.com/push-notifications/latest/userguide/procedure-enable-push.html) dans la [console AWS](https://console.aws.amazon.com/push-notifications/).
Suivez ces instructions pour créer une application et activer l’un des canaux push. Pour terminer cette procédure, il vous suffit de saisir le nom d’une application. Vous pourrez activer ou désactiver n’importe quel canal push ultérieurement :
1. Ouvrez la console AWS Final User Messaging Push à l'adresse [https://console.aws.amazon.com/push-notifications/](https://console.aws.amazon.com/push-notifications/)
1. Choisissez **Créer une application**.
1. Dans **Nom de l’application**, entrez le nom de votre application.
1. (Facultatif) Suivez cette étape facultative pour activer le **service de notification push Apple (APNs)**.
1. Pour le **service de notification push Apple (APNs)**, sélectionnez **Activer**.
1. Pour **Type d’authentification par défaut**, choisissez l’une des options suivantes :
1. Si vous choisissez **Key credentials**, fournissez les informations suivantes depuis votre compte développeur Apple. AWS Final User Messaging Push a besoin de ces informations pour créer des jetons d'authentification.
1. **ID de clé** : ID attribué à votre clé de signature.
1. **Identifiant de solution groupée** : ID attribué à votre application iOS.
1. **Identifiant d’équipe** : ID attribué à l’équipe chargée de votre compte Apple Developer.
1. **Clé d'authentification** : fichier .p8 que vous téléchargez depuis votre compte de développeur Apple lorsque vous créez une clé d'authentification.
1. Si vous choisissez **Certificate credentials (Informations d’identification de certificat)**, fournissez les informations suivantes :
1. **SSL certificate (Certificat SSL)** : fichier .p12 de votre certificat TLS.
1. **Mot de passe de certificat** : si vous avez attribué un mot de passe à votre certificat, entrez-le ici.
1. **Type de certificat** : sélectionnez le type de certificat à utiliser.
1. (Facultatif) Suivez cette étape facultative pour activer **Firebase Cloud Messaging (FCM)**.
1. Pour **Firebase Cloud Messaging (FCM)**, sélectionnez **Activer**.
1. Choisissez **informations d’identification du jeton** pour le **type d’authentification par défaut**, puis choisissez le fichier JSON de service.
1. Choisissez **Créer une application**.
## Étape 3 : associer l'application de messagerie utilisateur AWS final à une Connect Customer instance
Pour activer les notifications push sur une [Connect Customer instance](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html), vous devez associer une application de messagerie utilisateur AWS final à une [Connect Customer instance](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html) en appelant l'[CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API avec le `PINPOINT_APP` [IntegrationType](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html#API_CreateIntegrationAssociation_RequestSyntax). Vous pouvez appeler cette API [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/connect/create-integration-association.html) ou le [kit SDK Amazon Connect](https://aws.amazon.com/developer/tools/) pour toutes les langues prises en charge. Il s'agit d'une étape d'intégration unique requise pour chaque intégration entre une application de messagerie utilisateur AWS final et une Connect Customer instance.
## Étape 4 : Obtenez un jeton d'appareil avec FCM ou APNs SDK, et enregistrez-le avec Connect Customer
Vous devrez récupérer le jeton de l'appareil et l'utiliser pour enregistrer un appareil mobile de l'utilisateur final auprès d'un contact de Connect Customer chat afin d'envoyer des notifications push pour les nouveaux messages dans le chat. Lisez la documentation destinée aux FCM/APNs développeurs ci-dessous pour savoir comment le jeton de l'appareil est généré et obtenu à partir de l'application mobile.
+ Pour le service de notification push (APN) Apple, consultez la section [Enregistrement de votre application auprès](https://developer.apple.com/documentation/usernotifications/registering-your-app-with-apns) de APNs la documentation Apple destinée aux développeurs.
+ Pour Firebase Cloud Messaging (FCM), consultez [Bonnes pratiques pour la gestion des jetons d’inscription FCM](https://firebase.google.com/docs/cloud-messaging/manage-tokens).
Pour enregistrer l’appareil avec un contact par chat, nous vous recommandons de procéder comme suit :
1. Lorsque l'application mobile appelle l'[StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API, transmettez les [attributs `deviceToken` et `deviceType` en tant que contact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes). Pour les utilisateurs de WebView et de widgets de communication hébergés, consultez [Comment transmettre des attributs de contact dans le widget de communication](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html#how-to-contact-attributes-chatwidget) pour plus de détails.
1. Intégrez un appel à l'[CreatePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreatePushNotificationRegistration.html)action dans une fonction Lambda dans un flux de contacts. Le bloc de flux doit lire `deviceToken` et `deviceType` à partir des attributs de contact définis par l’utilisateur, ainsi que l’`initialContactId` à partir des attributs système, puis transmettre ces valeurs à la fonction Lambda.
1. Selon votre cas d’utilisation, placez la fonction Lambda juste après le démarrage du chat (au début du flux) si vous souhaitez que l’utilisateur final reçoive des notifications push immédiatement ou juste avant le routage du contact vers une file d’attente pour qu’il ne reçoive ces notifications que lorsque l’agent est sur le point de le rejoindre. Une fois l’appel d’API effectué, l’appareil commence à recevoir des notifications push lorsqu’un nouveau message provient de l’agent ou du système. Par défaut, des notifications push sont envoyées pour tous les messages du système et de l’agent.
1. (facultatif) Intégrez un appel à l'[DeletePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeletePushNotificationRegistration.html)action dans une fonction Lambda dans un flux. Une fois l’appel d’API effectué, l’appareil cesse de recevoir des notifications push lorsqu’un nouveau message provient de l’agent ou du système.
## Étape 5 : recevoir une notification push sur vos applications mobiles
Consultez notre projet d'[exemples d'interface utilisateur de Connect Customer chat](https://github.com/amazon-connect/amazon-connect-chat-ui-examples) et consultez nos exemples de vues Web de chat [iOS](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/iOS-WKWebView-sample) et [Android](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/android-webview-sample) qui montrent comment intégrer Connect Customer APIs et recevoir des notifications push.
## Surveillance de votre utilisation des notifications push
Pour garantir la fiabilité, la disponibilité et les performances de vos notifications push, il est essentiel de surveiller leur utilisation. Vous pouvez suivre ces informations par le biais de plusieurs canaux :
1. AWS fournit des outils de surveillance complets pour les notifications push. Pour plus d'informations, consultez la section [Surveillance des messages push destinés aux utilisateurs AWS finaux](https://docs.aws.amazon.com/push-notifications/latest/userguide/monitoring-overview.html).
1. Selon le service de notification push que vous utilisez, vous pouvez accéder à des données d’utilisation supplémentaires via leur console respective.
1. Firebase Cloud Messaging (FCM) : consultez la documentation de FCM [Comprendre la distribution des messages](https://firebase.google.com/docs/cloud-messaging/understand-delivery?platform=android) pour obtenir des informations sur votre utilisation de FCM.
1. Service de notifications push Apple (APNs) : consultez la section de APNs documentation sur l'[affichage de l'état des notifications push à l'aide de métriques et APNs](https://developer.apple.com/documentation/usernotifications/viewing-the-status-of-push-notifications-using-metrics-and-apns) pour surveiller l'état de vos notifications.