Chat dans votre application iOS et Android : le SDK mobile

Mis à jour le 20 nov. 202615 min de lecture
Français
Sur cette page

Le SDK mobile de Deskwoot place votre chat en direct dans votre propre application iOS et Android, sous forme d'écran natif et non de page web. Vos clients écrivent à votre équipe et à votre bot IA directement dans l'application, et votre équipe répond dans Deskwoot comme d'habitude. Quand l'application est fermée, les réponses arrivent sur le téléphone du client sous forme de notifications push. Votre développeur intègre le SDK à l'application à l'aide de la documentation pour les développeurs. De votre côté, vous faites 2 choses dans Deskwoot, toutes deux dans votre boîte de réception de chat en direct, sous Chat dans votre application iOS et Android : vous copiez le jeton du widget pour votre développeur, et vous enregistrez votre clé Apple et votre compte de service Firebase pour que Deskwoot puisse envoyer les notifications push.

Ce que vos clients obtiennent dans votre application

C'est le même chat que sur votre site. L'application lit les mêmes réglages de la boîte de réception (votre couleur de marque, vos textes, votre équipe, votre bot IA et votre centre d'aide) et affiche l'apparence choisie pour la boîte : Épuré, Accueil ou Direct. Les conversations venues de l'application arrivent dans cette boîte de réception, et votre équipe y répond comme à n'importe quel autre chat.

  • Le chat est un écran natif de votre application sur iPhone, iPad et Android, pas une page web. Seul le texte d'un article d'aide s'affiche dans une web view.
  • Vos clients écrivent à votre équipe et à votre bot IA, cherchent dans votre centre d'aide et lisent les réponses sans quitter l'application. Ils peuvent envoyer des photos et des fichiers, et aussi des photos prises avec l'appareil photo si votre application l'autorise.
  • Le chat parle les 10 langues visiteurs du chat de votre site. Il utilise la langue fixe de la boîte de réception si vous en avez défini une, sinon la langue de votre application, sinon l'anglais. Par défaut, il est clair ou sombre comme votre application.
  • Quand une réponse arrive alors que l'application est ouverte et le chat fermé, une petite carte glisse en bas de l'application avec la photo et le nom de la personne qui a écrit et 2 lignes de la réponse. Un appui ouvre la conversation. Votre développeur peut désactiver la carte.
  • L'application sait combien de réponses le client n'a pas encore lues, par exemple pour afficher une pastille sur votre bouton d'aide. Elle peut aussi afficher par-dessus l'application le bouton de chat rond de votre site, mais ce bouton reste masqué tant que votre développeur ne l'active pas.
  • Quand l'application est fermée, les réponses arrivent sous forme de notifications push, une fois que vous les avez configurées (étape 2 plus bas).

Votre application décide où le chat s'ouvre : sur sa page d'accueil, dans la conversation la plus récente du client, dans une nouvelle conversation avec un texte de votre choix déjà saisi (le client peut le modifier et l'envoie lui-même), ou directement dans votre centre d'aide. La plupart des applications l'ouvrent depuis leur propre bouton d'aide.

Ce dont vous avez besoin

  • Une boîte de réception de chat en direct dans Deskwoot. L'application utilise son jeton du widget. Avec le jeton de la boîte de réception de votre site, les chats de l'application et ceux du site arrivent dans la même boîte. Pour les séparer, créez une deuxième boîte de réception de chat en direct pour l'application.
  • Votre propre application pour iPhone et iPad (iOS 15 ou plus récent), pour Android (Android 5.0 ou plus récent), ou les deux. Le SDK est natif : Swift sur iOS, Kotlin ou Java sur Android. Les applications Android construites avec des Views et celles construites avec Jetpack Compose fonctionnent toutes les deux. Il n'existe pas de paquet pour React Native ou Flutter (voir les questions plus bas).
  • Un développeur qui intègre le SDK à votre application. Tout ce dont il a besoin se trouve dans la documentation pour les développeurs.
  • Pour les notifications push sur iPhone : un compte Apple Developer dans lequel vous pouvez créer des clés. Apple le permet à l'Account Holder et aux Admins.
  • Pour les notifications push sur Android : un accès au projet Firebase de votre application Android. L'application a besoin de Firebase Cloud Messaging.
  • Dans Deskwoot, le droit de gérer les boîtes de réception. Les administrateurs l'ont, ainsi que les agents dont le rôle personnalisé comprend Gérer les boîtes de réception.

Cela fonctionne avec n'importe quel forfait Deskwoot. Deskwoot ne vérifie aucun forfait pour le SDK ni pour les notifications push, et tous les forfaits comprennent des boîtes de réception de chat en direct.

Étape 1 : donnez le jeton du widget à votre développeur

  1. Allez dans Paramètres > Boîtes de réception et ouvrez la boîte de réception de chat en direct que l'application doit utiliser.
  2. Sous Configuration et confidentialité, cliquez sur Chat dans votre application iOS et Android.
  3. En haut, sous Jeton du widget, cliquez sur Copier et envoyez le jeton à votre développeur. L'application le transmet à Deskwoot au démarrage, en un seul appel : Deskwoot.setup.
  4. Tout en bas du panneau, Comment intégrer le SDK à votre application ouvre la documentation pour les développeurs. Envoyez aussi ce lien à votre développeur : deskwoot.com/fr/docs/mobile.

C'est tout ce dont le chat a besoin : il fonctionne dans l'application même sans notifications push. Les notifications push (étape 2) ajoutent les réponses qui arrivent pendant que l'application est fermée.

Étape 2 : configurez les notifications push

Les notifications push demandent du travail des deux côtés. Votre développeur prépare l'application comme l'explique la documentation pour les développeurs, sous Notifications push. Vous enregistrez les identifiants avec lesquels Deskwoot envoie : une clé d'authentification APNs d'Apple pour les iPhone, et un compte de service Firebase pour les téléphones Android. Le serveur de Deskwoot envoie ensuite chaque push avec vos propres comptes Apple et Google. Le SDK de l'application ne communique jamais lui-même avec Apple ni avec Google.

Vous pouvez configurer iOS, Android ou les deux. Chaque bloc du panneau a son propre bouton Enregistrer. Quand vous cliquez dessus, Deskwoot demande d'abord à Apple ou à Google s'ils acceptent ce que vous avez saisi, et ne l'enregistre que dans ce cas. S'ils refusent, une ligne sous le bloc indique ce qui ne va pas, et rien n'est enregistré. Si Apple ou Google ne répondent pas, réessayez dans un instant.

Notifications push sur iPhone : votre clé APNs

Il vous faut 4 éléments de votre compte Apple Developer :

  • La clé d'authentification APNs, un fichier qui se termine par .p8. Dans votre compte Apple Developer, allez dans Certificates, Identifiers & Profiles, cliquez sur Keys et créez une clé avec l'Apple Push Notification service activé. Téléchargez le fichier et conservez-le précieusement : Apple ne vous laisse le télécharger qu'une seule fois.
  • L'ID de clé. Apple l'affiche sous le nom de la clé quand vous sélectionnez la clé dans Keys. Il comporte 10 lettres et chiffres.
  • Votre ID d'équipe. Il se trouve dans votre compte Apple Developer, sous Membership details, et comporte lui aussi 10 lettres et chiffres.
  • Le Bundle ID de votre application, par exemple com.example.app. Votre développeur le connaît depuis Xcode, et Apple l'affiche dans Certificates, Identifiers & Profiles, Identifiers.

Apple peut limiter une clé à un seul environnement, sandbox ou production. Les applications de l'App Store et de TestFlight utilisent production, les builds de développement utilisent sandbox. Quand vous enregistrez la clé, Deskwoot demande à Apple pour quels environnements elle fonctionne, et s'il n'y en a qu'un, une ligne dans le bloc iOS vous l'indique. Pour une clé limitée à sandbox, cette ligne est un avertissement : les iPhone avec votre application installée depuis l'App Store ou TestFlight ne reçoivent aucune notification push, alors créez aussi une clé pour l'environnement production et enregistrez-la. Pour une clé limitée à production, c'est une simple remarque : les builds de développement de votre application ne reçoivent aucune notification push. Dans les deux cas, le bloc affiche Connecté, car Apple a accepté la clé. Vérifiez donc que votre clé fonctionne pour production, où tourne l'application de vos clients.

Ensuite, dans Deskwoot :

  1. Dans Chat dans votre application iOS et Android, allez au bloc iOS.
  2. Collez le contenu du fichier .p8 dans Clé d'authentification APNs (.p8), ou cliquez sur Importer le fichier .p8 et choisissez le fichier.
  3. Saisissez l'ID de clé, l'ID d'équipe et le Bundle ID.
  4. Cliquez sur Enregistrer.

Apple vérifie ensemble la clé, l'ID de clé et l'ID d'équipe : les 3 doivent donc provenir de la même clé, et le Bundle ID doit appartenir à votre équipe. Une fois qu'Apple les accepte, le bloc affiche Connecté ainsi que l'ID de clé, l'ID d'équipe et le Bundle ID. Seuls les iPhone qui ont l'application de ce Bundle ID reçoivent des notifications push.

Notifications push sur Android : votre compte de service Firebase

Les notifications push vers les téléphones Android passent par Firebase Cloud Messaging, avec un compte de service du projet Firebase qu'utilise votre application Android.

  1. Dans Firebase, ouvrez le projet de votre application, puis Paramètres du projet, puis Comptes de service, et générez une nouvelle clé privée. Firebase vous donne un fichier JSON.
  2. Dans Deskwoot, dans Chat dans votre application iOS et Android, allez au bloc Android.
  3. Collez le contenu du fichier dans JSON du compte de service, ou cliquez sur Importer le fichier .json et choisissez le fichier.
  4. Cliquez sur Enregistrer.

Google vérifie si ce compte de service a le droit d'envoyer des messages dans son projet. Pour cela, sa clé doit être valide, il lui faut un rôle autorisé à envoyer des messages, et l'API Firebase Cloud Messaging doit être activée dans le projet. Une fois que Google l'accepte, le bloc affiche Connecté ainsi que le projet et l'adresse e-mail du compte de service. Si les téléphones Android appartiennent vraiment à ce projet, on ne le voit qu'au premier vrai push (voir la section suivante).

Ce que signifie le statut

Dans la vue d'ensemble de la boîte de réception, la ligne Chat dans votre application iOS et Android affiche l'un de ces statuts :

  • Non configuré : aucun identifiant push n'est enregistré. Le chat de votre application fonctionne quand même, simplement sans notifications push.
  • Notifications push sur iOS, Notifications push sur Android ou Notifications push sur iOS et Android : les plateformes dont les identifiants sont enregistrés.
  • N'envoie pas : Apple ou Google a refusé les push que Deskwoot a voulu envoyer avec vos identifiants enregistrés.

Dans le panneau, chaque bloc affiche son propre statut : Connecté, Non configuré ou N'envoie pas. Avec N'envoie pas, une ligne du bloc indique pourquoi :

  • Apple refuse la clé, l'ID de clé ou l'ID d'équipe. Enregistrez les bonnes valeurs.
  • Apple refuse le Bundle ID. Enregistrez le Bundle ID de votre application.
  • Google refuse d'envoyer avec ce compte de service. Vérifiez que sa clé existe toujours, qu'il a un rôle autorisé à envoyer des messages et que l'API Firebase Cloud Messaging est activée dans son projet.
  • Les téléphones Android appartiennent à un autre projet Firebase que celui du compte de service. Importez le compte de service du projet Firebase de votre application.

N'envoie pas reste affiché jusqu'à ce qu'un push passe de nouveau ou que vous enregistriez de nouveaux identifiants. Le bloc iOS peut aussi indiquer que des iPhone utilisent un autre Bundle ID que celui enregistré, et combien. Ces iPhone ne reçoivent aucune notification push : vérifiez donc que le Bundle ID enregistré est bien celui de votre application.

Clés enregistrées : les remplacer ou les supprimer

Après l'enregistrement, le champ de la clé ou du JSON est de nouveau vide, avec une note indiquant qu'un élément est enregistré. Deskwoot conserve la clé et le JSON chiffrés et ne les affiche plus jamais, ni sur cette page ni par l'API. Restent visibles l'ID de clé, l'ID d'équipe et le Bundle ID, et pour Android le projet Firebase et l'adresse e-mail du compte de service.

  • Pour remplacer la clé ou le compte de service, collez ou importez le nouveau fichier et cliquez sur Enregistrer. Deskwoot le vérifie de nouveau auprès d'Apple ou de Google.
  • Pour changer seulement l'ID de clé, l'ID d'équipe ou le Bundle ID, modifiez le champ et cliquez sur Enregistrer. La clé enregistrée reste en place, vous n'avez donc pas besoin de l'importer de nouveau.
  • Pour supprimer un bloc, cliquez sur Supprimer et confirmez avec Supprimer. À partir de là, les iPhone (ou les téléphones Android) ne reçoivent plus de notifications push tant que vous n'ajoutez pas de nouveaux identifiants. Le chat de votre application continue de fonctionner.

Quand une notification push part

Deskwoot envoie un push pour chaque réponse que le client voit dans le chat : une réponse d'un membre de votre équipe, une réponse de votre bot IA ou un message automatique. Il n'en envoie jamais pour les messages du client lui-même, pour les notes privées ni pendant que le bot IA est encore en train d'écrire sa réponse. Les conversations marquées comme spam et les contacts bloqués n'en reçoivent pas.

  • Si le client n'était pas en ligne un instant plus tôt, le push part tout de suite.
  • S'il était en ligne un instant plus tôt, Deskwoot attend 12 secondes. S'il a lu la réponse entre-temps, aucun push ne part. Un client qui regarde la conversation n'est donc pas dérangé.
  • Chaque réponse ne fait sonner le téléphone qu'une fois. Elle va à chaque téléphone sur lequel le client utilise votre application avec cette boîte de réception, jusqu'à 10 téléphones.
  • Si le téléphone est éteint ou hors ligne, Apple et Google gardent le push pendant une journée, puis l'abandonnent.

Le titre de la notification indique qui a écrit : le prénom du membre de votre équipe ou le nom de votre bot IA, sinon le nom de votre entreprise. Le texte montre la réponse en texte brut, jusqu'à 160 caractères. Pour une réponse qui ne contient qu'un fichier, il indique dans la langue du téléphone qu'un fichier a été envoyé (sur un téléphone en français, « Fichier envoyé »). Un appui sur la notification ouvre la conversation dans votre application.

Clients connectés dans votre application

Sans autre réglage, un client discute dans l'application comme visiteur anonyme, et la conversation reste sur ce téléphone. Si vos clients se connectent à votre application, l'application peut dire au chat qui ils sont. Leurs conversations les suivent alors sur tous leurs appareils et dans le chat de votre site sur la même boîte de réception, et votre équipe voit qui écrit.

Cela fonctionne exactement comme la vérification d'identité sur votre site, avec la même clé secrète, que vous créez dans la même boîte de réception de chat en direct, sous Reconnaître les clients connectés. Votre serveur signe l'identifiant utilisateur du client avec cette clé, et après votre propre connexion, l'application transmet l'utilisateur et la signature au SDK. La création de la clé et la signature de l'identifiant sont expliquées dans Vérification d'identité des clients connectés. L'appel dans l'application se trouve dans la documentation pour les développeurs.

La clé doit rester sur votre serveur. Ne l'intégrez jamais à l'application : toute personne qui décompresse l'application pourrait la lire et discuter sous l'identité de n'importe lequel de vos clients.

Quand un client se déconnecte de votre application, l'application le signale au SDK. Le SDK supprime alors ce qu'il gardait sur ce client dans le téléphone, le téléphone ne reçoit plus de notifications push pour lui, et le prochain chat commence avec un nouveau visiteur anonyme. Ses conversations restent dans Deskwoot et reviennent quand il se reconnecte.

Questions fréquentes

Est-ce que cela coûte plus cher, et quel forfait me faut-il ?

Le SDK et les notifications push n'ont pas de prix à part, et Deskwoot ne vérifie aucun forfait pour eux. Tous les forfaits comprennent des boîtes de réception de chat en direct, donc n'importe quel forfait convient. Pour les notifications push, vous utilisez votre propre compte Apple Developer et votre propre projet Firebase.

Existe-t-il un SDK pour React Native ou Flutter ?

Non. Deskwoot propose des SDK natifs pour iOS (Swift) et pour Android (Kotlin et Java), et aucun paquet pour React Native ou Flutter. Dans une application construite avec eux, vous pouvez afficher le chat de votre site dans une web view avec le mode intégré du widget. Mode intégré : le chat dans un conteneur ou en plein écran explique comment.

Ai-je besoin de Firebase sur iOS ?

Non. Deskwoot envoie les notifications push pour iPhone directement à Apple avec votre clé d'authentification APNs, et le SDK n'embarque pas Firebase. Firebase n'est nécessaire que pour Android.

Qui envoie les notifications push, Deskwoot ou nous ?

C'est le serveur de Deskwoot qui les envoie, avec votre clé d'authentification APNs et votre compte de service Firebase, donc par vos propres comptes Apple et Google. Votre application transmet seulement son jeton push au SDK au démarrage. Vos propres notifications push restent les vôtres : le SDK ne prend que celles de Deskwoot et laisse toutes les autres à votre application.

Le SDK demande-t-il des autorisations à mes clients ?

Il ne demande jamais l'autorisation d'afficher des notifications. C'est votre application qui la demande au moment qui lui convient, comme pour ses propres notifications. Sur Android 13 et plus récent, aucune notification ne s'affiche sans cette autorisation. En dehors de cela, le SDK n'a besoin d'aucune autorisation sur iPhone et seulement de l'accès à internet sur Android. Vos clients peuvent envoyer des photos et des fichiers sans aucune autorisation. L'appareil photo ne fonctionne que si votre application l'autorise. La carte qui montre une réponse quand l'application est ouverte n'a pas besoin d'autorisation non plus.

Que voit le client quand l'application est fermée ?

Une notification push avec le nom de la personne qui a écrit et jusqu'à 160 caractères de la réponse. Un appui ouvre la conversation dans votre application. Si l'application est ouverte et le chat fermé, c'est une petite carte en bas de l'application qui montre la réponse. Tant que le client regarde cette conversation, aucune notification ne s'affiche.

Ce guide vous a-t-il aidé ?

Continuer la lecture

Demander à Fynn à propos de ce guide

Obtenez une réponse courte tirée de ce guide et du reste du centre d'aide.

Besoin d'aide supplémentaire ?

Fynn répond dans le chat à partir de ces guides, et vous pouvez aussi y joindre l'équipe.