Utilisation de la messagerie dans vos SDK Android et iOS

Après avoir activé la messagerie, vous pouvez l’ajouter à votre application Android ou iOS.

Cet article aborde les sujets suivants :

• À propos de la messagerie pour Android et iOS
• Création d’un nouveau canal Android ou iOS pour la messagerie
• Personnalisation et configuration du SDK Zendesk pour Android et iOS
• Obtention de la clé du canal pour l’installation

À propos de la messagerie pour Android et iOS

Dans les applications Zendesk mobiles, la fonctionnalité de messagerie est fournie via les nouveaux SDK Android et iOS. Vérifiez que vous avez bien activé la messagerie avant de commencer le processus de création. Après avoir activé la messagerie, vous pouvez personnaliser et configurer l’aspect et d’autres paramètres d’un SDK via le Centre d’administration, puis fournir à vos développeurs la clé du canal dont ils auront besoin pour terminer l’intégration en suivant cette documentation officielle pour les développeurs.

Création d’un nouveau canal Android ou iOS pour la messagerie

Si vous voulez configurer les SDK Android ou iOS, vous devez créer un canal Android ou iOS dans le Centre d’administration Zendesk et l’affecter à une marque avant de pouvoir le personnaliser et le configurer, comme expliqué ci-dessous.

Pour créer un nouveau canal Android/iOS

1. Dans le Centre d’administration, cliquez sur l’icône Canaux () dans la barre latérale, puis sélectionnez Messagerie et réseaux sociaux > Messagerie.
2. Cliquez sur le bouton Ajouter un canal, puis sélectionnez Android ou iOS.
3. À la page d’ajout d’Android/iOS, configurez chacune de ces sections :
   • Configuration élémentaire : saisissez un nom de canal, puis sélectionnez une marque dans le menu déroulant.
   • Personnalisation de l’aspect : cliquez sur les couleurs principales, du message et d’action, puis saisissez une valeur hexadécimale ou utilisez le sélecteur de couleur pour faire votre choix.
   • Installation dans votre application : une clé de canal vous sera présentée. Vous (ou votre équipe de développement) pouvez l’utiliser pour installer le SDK Android ou iOS dans votre application. Vous recevrez également un lien vers des instructions détaillées que vous pouvez utiliser pour terminer l’installation.
4. Cliquez sur Terminer. La page de modification du SDK Android/iOS s’ouvre et vous pouvez continuer de configurer le SDK ou le laisser tel quel.

Si vous désactivez la messagerie pour une marque, le Web Widget est converti en Web Widget (Classique).

Personnalisation et configuration des SDK Zendesk pour Android et iOS

Le SDK Zendesk inclut de nombreux composants que vous pouvez personnaliser pour qu’il reflète au mieux votre marque.

Pour configurer la messagerie pour Android ou iOS

1. Dans le Centre d’administration, cliquez sur l’icône Canaux () dans la barre latérale, puis sélectionnez Messagerie et réseaux sociaux > Messagerie.
2. Placez votre curseur sur la marque que vous voulez mettre à jour, cliquez sur l’icône du menu des options (), puis sur Modifier.
3. Cliquez sur l’onglet où se trouvent les composants que vous voulez personnaliser. Cliquez sur les liens ci-dessous pour en savoir plus au sujet des options de chaque onglet :
   • Infos de base (nom et workflow du canal)
   • Style (aspect du SDK)
   • Notifications (paramètres des notifications Push)
   • Installation (incorporation de la clé du canal et du centre d’aide)

L’onglet Infos de base

L’onglet Infos de base inclut un champ Nom du canal modifiable et un lien vers la page de configuration du Créateur de workflow du SDK.

Le champ Nom du canal est automatiquement rempli avec le nom de la marque. Pour qu’il soit plus facile à trouver dans votre liste de canaux, il peut être judicieux de lui donner un nom unique.

Pour mettre le nom du canal à jour

1. Dans le champ Nom du canal, supprimez le texte que vous voulez modifier.
2. Saisissez un nouveau nom pour le SDK, puis cliquez sur le bouton Enregistrer.

L’onglet Style

L’onglet Style inclut les composants liés à l’aspect du SDK pour Android ou iOS.

Dans la section Cadre, vous pouvez mettre les éléments suivants à jour :

• Couleur principale, la couleur principale du bouton de lancement et de l’en-tête du SDK. Saisissez un nombre hexadécimal ou cliquez sur l’échantillon de couleur pour ouvrir un sélecteur de couleur.
• Couleur du message, la couleur de la bulle autour des messages des clients. Saisissez un nombre hexadécimal ou cliquez sur l’échantillon de couleur pour ouvrir un sélecteur de couleur.
• Couleur d’action, la couleur des boutons ou des éléments que les utilisateurs peuvent toucher dans la conversation, comme les messages de réponse rapide. Saisissez un nombre hexadécimal ou cliquez sur l’échantillon de couleur pour ouvrir un sélecteur de couleur.
• Logo (facultatif), un fichier JPG ou PNG qui s’affiche en haut du cadre du SDK. Cliquez sur Télécharger une image, puis naviguez jusqu’à l’image que vous voulez ajouter.
• Titre, le texte qui s’affiche en haut de l’écran de conversation du SDK, généralement le nom de votre entreprise ou de votre marque.
• Description (facultatif) un court texte sous le titre. Il peut s’agir d’informations que vous voulez partager, un slogan par exemple. Saisissez la description dans le champ de texte.

L’onglet Notifications

C’est dans l’onglet Notifications que vous pouvez configurer les notifications Push pour le SDK Zendesk pour Android ou iOS.

Pour Android, fournissez la « clé » (key) et l’« ID de l’expéditeur » (Sender ID) Firebase Cloud Messaging (FCM) :

Pour iOS, chargez le fichier .p12 depuis APNs. Vous devrez aussi fournir le mot de passe du certificat :

Pour générer le fichier .p12, vous devez être connecté à votre compte Apple Developer. Si vous n’avez pas de compte de développeur, vous pouvez vous inscrire ici.

1. Connectez-vous au centre des membres Apple Developer et allez à la liste des certificats.
2. Cliquez sur le bouton + en haut de la page pour créer un nouveau certificat, et sélectionnez Apple Push Notification service SSL (Sandbox & Production).
3. Sélectionnez l’ID de votre application dans le menu déroulant et cliquez sur Continue.
4. Suivez les instructions pour générer une demande de signature de certificat (Certificate Signing Request ou CSR) en utilisant Keychain Access (trousseau de clés), puis chargez-la pour générer votre certificat.
5. Une fois le certificat prêt, téléchargez-le sur votre ordinateur et double-cliquez dessus pour l’ouvrir dans Keychain Access.
6. Cliquez sur le certificat que vous avez créé avec le bouton droit de la souris et sélectionnez « Export "Apple Push Services: {your-app-id}" ».
7. Choisissez un mot de passe si vous le souhaitez et enregistrez le fichier .p12 sur votre ordinateur.

Pour entièrement activer les notifications Push, vos développeurs doivent aussi suivre certaines instructions. Vous trouverez ces instructions dans notre documentation officielle pour les développeurs pour Android et iOS.

Obtention de la clé du canal pour l’installation

Pour installer la messagerie dans votre application mobile, vous devez fournir la clé du canal à vos développeurs. Vous trouverez la clé du canal, ainsi qu’un lien vers la documentation Zendesk officielle pour les développeurs, dans l’onglet Installation.

Pour obtenir la clé du canal

1. Dans le Centre d’administration, cliquez sur l’icône Canaux () dans la barre latérale, puis sélectionnez Messagerie et réseaux sociaux > Messagerie.
2. Placez votre curseur sur la marque que vous voulez mettre à jour, cliquez sur l’icône du menu des options (), puis sur Modifier.
3. Cliquez sur l’onglet Installation.
4. Sous Clé du canal, cliquez sur le bouton Copier pour copier la clé dans votre presse-papiers et envoyez ces informations à vos développeurs.