Activation des notifications Push pour le SDK Chat pour l’application mobile

Mon édition

Si vous proposez Zendesk Chat par le biais de votre propre application mobile, vous pouvez activer les notifications Push pour prévenir les clients des réponses et mises à jour de leurs chats.

Pour les éditions payantes de Zendesk Chat, les notifications Push peuvent être configurées pour prévenir l’utilisateur quand l’application est en arrière-plan sur son appareil mobile. Vous pouvez activer ces notifications pour plusieurs applications.

Cet article décrit les tâches que doivent effectuer les administrateurs pour activer les notifications Push Chat pour leurs applications mobiles et inclut les sujets suivants :

• Étapes préparatoires de l’ajout de l’application
• Activation des notifications Push dans votre application mobile
• Modification des informations d’une application
• Désactivation des notifications Push pour une application
• Tests des notifications Push
• Note pour les anciens utilisateurs du Mobile SDK Chat V1

Remarque – Pour activer les notifications Push pour Zendesk Chat dans plusieurs applications mobiles, ces applications doivent utiliser le Mobile SDK Chat V2 ou version ultérieure.

Étapes préparatoires de l’ajout de l’application

Pour que vos développeurs puissent activer les notifications Push, un administrateur Chat doit télécharger des identifiants de serveur FCM (pour Android) ou un certificat PEM (pour iOS) dans le compte Chat.

Les développeurs doivent vous fournir les identifiants de serveur FCM ou le fichier du certificat PEM. S’ils ont des questions, ils peuvent consulter les documents suivants dans le portail des développeurs Zendesk :

• https://developer.zendesk.com/embeddables/docs/chat-sdk-v-2-for-ios/push_notifications
• https://developer.zendesk.com/embeddables/docs/chat-sdk-v-2-for-android/introduction

Activation des notifications Push dans votre application mobile

Remarque – Google supprimera les anciennes API FCM XMPP et HTTP en juin 2024. Les clients existants qui utilisent le SDK Chat sur Android doivent recharger les identifiants dans le format le plus récent. Consultez l’article sur la migration des anciennes API FCM vers HTTP v1.

Pour activer les notifications Push, les administrateurs doivent ajouter leurs applications mobiles à la liste du Mobile SDK, accessible à partir du tableau de bord Chat. Quand une application est ajoutée à cette liste, un ID d’application est généré et partagé avec votre équipe de développement mobile.

Pour ajouter une application à la liste du Mobile SDK

1. Dans le tableau de bord Chat, allez à Paramètres > Compte > PI et SDK.
2. Dans la section Mobile SDK, cliquez sur Ajouter une application.

   

3. À la page Ajouter une application, saisissez les informations de votre application, notamment :
   • Nom : un nom pour votre application que les développeurs et autres administrateurs reconnaîtront facilement.
   • Description : une brève description de la fonction de l’application.
   • (pour Android) Chargez la clé privée du compte de service contenant les identifiants privés, l’e-mail client (aussi appelé e-mail de compte de service) et l’ID du projet en cliquant sur Générer une nouvelle clé privée dans la console Firebase. Consultez Initialiser le SDK dans les environnements autres que Google. Vous devez aussi ajouter google-services.json à votre projet Android. Consultez Notifications Push.

     Dans la plupart des scénarios de migration, l’API Firebase Cloud Messaging (FCM) v1 est activée par défaut. Si vous rencontrez des erreurs quand vous essayez de contacter le point de terminaison, vérifiez que l’API Firebase Cloud Messaging est activée dans la liste des API et des services de la console Google Cloud.

   • (pour iOS) Chargez un certificat PEM.
4. Cliquez sur Enregistrer les modifications.

Votre application est créée et un ID d’application lui est affecté.

Informez votre équipe de développement que les identifiants ou le certificat ont été chargés. Après réception de cette confirmation, ils doivent modifier le code de l’application pour activer les notifications Push. S’ils ont besoin de plus d’informations, ils peuvent consulter les documents destinés aux développeurs répertoriés ci-dessus.

Modification des informations d’une application

Vous pouvez modifier le nom et la description affectés à votre application mobile, comme expliqué dans Activation des notifications Push dans votre application mobile ci-dessus.

Pour modifier les paramètres d’une application existante

1. Dans le tableau de bord, allez à Paramètres > Compte > API et SDK.
2. Dans la section Mobile SDK, cliquez sur l’application que vous souhaitez modifier.
3. À la page de modification de l’application, effectuez vos modifications et cliquez sur Enregistrer les modifications.

Désactivation des notifications Push pour une application

Si vous ne voulez plus offrir les notifications Push Chat pour une application mobile, vous pouvez la supprimer de la liste du Mobile SDK.

Une fois une application supprimée, les visiteurs utilisant cet ID de l’application ne recevront plus de notifications Push de votre service. Vous ne pouvez pas créer d’autre application Mobile SDK avec le même ID d’application et la suppression est irréversible.

Pour supprimer un ou plusieurs agents

1. Dans le tableau de bord, allez à Paramètres > Compte > API et SDK.
2. Dans la section Mobile SDK, cliquez sur la ou les applications que vous souhaitez supprimer.
3. Cliquez sur Supprimer la sélection.

Tests des notifications Push

Si votre application est disponible sur les appareils iOS, vous pouvez tester vos notifications Push avant de les mettre à disposition par le biais de votre application active.

Pour envoyer les notifications Push à l’environnement de test (iOS uniquement)

1. Dans le tableau de bord, allez à Paramètres > Compte > API et SDK.
2. Dans la section Mobile SDK, cliquez sur l’application qui doit envoyer les notifications Push à l’environnement de test.
3. Dans la section iOS, sélectionnez Pour la sandbox APN.
4. Cliquez sur le bouton Enregistrer les modifications.

   

Note pour les anciens utilisateurs du Mobile SDK Chat V1

Si vous utilisiez le Mobile SDK Chat V1, vous risquez de ne pas pouvoir supprimer une application intitulée « App 1 » de votre compte.

Si vous avez une application qui utilise le Mobile SDK V1 créé avec l’ancienne expérience de paramètres Mobile SDK, nous avons effectué la migration de l’application existante vers la nouvelle expérience. Vous pouvez facilement l’identifier en cherchant son nom pré-affecté « App 1 » (que vous pouvez changer dans les paramètres de l’application).

Nous avons désactivé la suppression de cette application sur votre tableau de bord car elle utilise l’ancienne version du Mobile SDK et ne peut pas être ajoutée comme nouvelle application si vous la supprimez par inadvertance.

Si vous voulez désactiver cette application :

1. Cliquez sur App 1 dans la section Mobile SDK.
2. Cliquez sur Modifier l’application.
3. Supprimez la clé de serveur FCM et/ou le fichier PEM.
4. Cliquez sur Enregistrer les modifications.