Activation des notifications push pour le chat mobile - Amazon Connect
Étape 1 : obtenir les informations d'identification de la console FCM d'Apple APNs et de GoogleÉ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Étape 3 : associer l'application de messagerie utilisateur AWS final à une Amazon Connect instanceÉtape 4 : Obtenez un jeton d'appareil avec FCM ou APNs SDK, et enregistrez-le avec Amazon ConnectÉtape 5 : recevoir une notification push sur vos applications mobilesSurveillance de votre utilisation des notifications push

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. 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 Amazon Connect mobile SDKs, dans une solution de visualisation Web ou dans une solution native personnalisée.

Les étapes et ressources suivantes vous aideront à commencer à intégrer les notifications Amazon Connect 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 Amazon Connect 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'envoyer des notifications à vos applications mobiles. Les informations d’identification que vous fournissez dépendent du système de notification push que vous utilisez :

É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 dans la console AWS.

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/

  2. Choisissez Créer une application.

  3. Dans Nom de l’application, entrez le nom de votre application.

  4. (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.

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

        2. Identifiant de solution groupée : ID attribué à votre application iOS.

        3. Identifiant d’équipe : ID attribué à l’équipe chargée de votre compte Apple Developer.

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

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

        2. Mot de passe de certificat : si vous avez attribué un mot de passe à votre certificat, entrez-le ici.

        3. Type de certificat : sélectionnez le type de certificat à utiliser.

  5. (Facultatif) Suivez cette étape facultative pour activer Firebase Cloud Messaging (FCM).

    1. Pour Firebase Cloud Messaging (FCM), sélectionnez Activer.

    2. Choisissez informations d’identification du jeton pour le type d’authentification par défaut, puis choisissez le fichier JSON de service.

  6. Choisissez Créer une application.

Étape 3 : associer l'application de messagerie utilisateur AWS final à une Amazon Connect instance

Pour activer les notifications push sur une Amazon Connect instance, vous devez associer une application de messagerie utilisateur AWS final à une Amazon Connect instance en appelant l'CreateIntegrationAssociationAPI avec le PINPOINT_APP IntegrationType. Vous pouvez appeler cette API AWS CLI ou le kit SDK Amazon Connect 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 Amazon Connect instance.

Étape 4 : Obtenez un jeton d'appareil avec FCM ou APNs SDK, et enregistrez-le avec Amazon Connect

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 Amazon Connect 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 enregistrer l’appareil avec un contact par chat, nous vous recommandons de procéder comme suit :

  1. Lorsque l'application mobile appelle l'StartChatContactAPI, transmettez les attributs deviceToken et deviceType en tant que contact. 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 pour plus de détails.

  2. Intégrez un appel à l'CreatePushNotificationRegistrationaction 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.

      Invoquez le bloc de flux Fonction Lambda dans le concepteur de flux du site Web d’administration Amazon Connect .

  1. (facultatif) Intégrez un appel à l'DeletePushNotificationRegistrationaction 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 Amazon Connect chat et consultez nos exemples de vues Web de chat iOS et Android qui montrent comment intégrer Amazon Connect 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.

  2. 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 pour obtenir des informations sur votre utilisation de FCM.

    2. 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 pour surveiller l'état de vos notifications.