Passer au contenu principal

Fin Messenger : configuration Zendesk

Comment configurer et personnaliser Fin dans Fin Messenger et transférer les conversations vers Zendesk.

Apprenez à intégrer Fin Messenger avec Zendesk, personnaliser le workflow et contrôler la manière dont les conversations sont transmises à vos coéquipiers.


Intégrez Fin Messenger avec Zendesk

Connectez-vous à Zendesk en utilisant OAuth

OAuth est la méthode principale pour connecter Fin à Zendesk. OAuth supprime la nécessité de gérer manuellement les jetons API et garantit une compatibilité continue avec les changements de Zendesk.

  1. Allez sur Connect.

  2. Sous Connect to Zendesk, sélectionnez Connect to Zendesk.

  3. Connectez-vous à Zendesk en utilisant OAuth et approuvez l'accès.

  4. Retournez à Fin pour confirmer que la connexion apparaît comme Connected.

Note : Zendesk déprécie l'authentification par jeton API. Tous les nouveaux clients doivent connecter Fin à Zendesk en utilisant OAuth.

  • Nouveaux clients non contractuels : OAuth est obligatoire.

  • Nouveaux clients contractuels : OAuth est obligatoire une fois activé sur l'espace de travail.

  • Clients existants : Les connexions par jeton API continuent de fonctionner, mais en cas de déconnexion, la reconnexion doit utiliser OAuth. Une bannière persistante apparaîtra jusqu'à l'activation d'OAuth.

Connectez-vous à Zendesk Sunshine

Si votre workflow inclut Hand-off to Zendesk agent, vous devez également vous connecter à Zendesk Sunshine. Les identifiants Zendesk Sunshine restent basés sur des clés ; OAuth ne les remplace pas.

Fournissez les détails suivants depuis Zendesk Admin Center > Apps & Integrations > Zendesk Sunshine :

  • App ID

  • Key ID

  • Secret Key

Une fois que vous avez copié tout ce qui précède, sélectionnez Connect.

Note : L'API Zendesk Chat a été dépréciée au profit de Zendesk Sunshine. Vous devez disposer d'une licence Sunshine Conversations pour connecter Zendesk Sunshine.

Si vous ne voyez pas l'option « Zendesk Sunshine » dans vos paramètres d'administration Zendesk sous Apps and integrations > APIs > Zendesk Sunshine, alors vous n'avez probablement pas de licence Sunshine Conversations et devrez contacter le support Zendesk pour en obtenir une.

Comment fonctionne Zendesk Sunshine

Zendesk Sunshine synchronise vos conversations Fin et Zendesk en temps réel. Fin envoie et reçoit des appels API :

  • À chaque message client entrant

  • À chaque réponse de Fin

  • Lorsque les conversations sont assignées, escaladées ou clôturées

Si un client commence dans Fin Messenger, Fin crée ou trouve l'utilisateur Sunshine correspondant.


Si une conversation commence dans Zendesk Messenger, Fin renvoie les messages dans l'espace de travail Fin.

Activez plusieurs conversations dans Zendesk

Si vous utilisez Hand-off to Zendesk agent ou Determined by situation, Zendesk exige que Multiple conversations soit activé.

Page de configuration Fin Messenger dans Zendesk montrant le chemin Admin Center pour activer Multi-conversations dans les paramètres Messaging.
  1. Dans Fin, allez à Settings > Fin Messenger > Configure in Zendesk.

  2. Dans Zendesk, allez à Admin Center > Channels > Messaging > Manage settings > Multi-conversations et activez Multiple Conversations. Vous pouvez cliquer sur Manage in Zendesk dans Fin pour ouvrir Zendesk.

  3. Retournez à Fin et cliquez sur Refresh.


Construisez votre workflow

Configurez le workflow de salutation et de transfert

Depuis l'écran d'intégration, cliquez sur Manage workflow. Un modèle est fourni, mais vous pouvez entièrement personnaliser :

Vue d'ensemble du workflow Fin Messenger montrant une nouvelle conversation, un message de bienvenue et une étape Laissez Fin gérer avec un chemin de transfert.
  • Quand Fin doit répondre

  • Comment Fin salue les clients

  • Que se passe-t-il en cas d'escalade

  • Quelles données collecter avant le transfert

À la fin de tout chemin non résolu, Fin se désaffecte et applique le tag routed-to-the-team.

Cliquez sur l'étape Let Fin handle dans votre workflow pour personnaliser les éléments suivants :

Panneau Laissez Fin répondre listant les options pour la formation, les attentes de support humain, les questions de transfert, le suivi des clients inactifs, le CSAT et la fermeture automatique des conversations abandonnées.
  • Définir l'attente pour le support humain - Affichez la présence des coéquipiers dans une conversation messenger. Désactivez ceci si votre équipe travaille uniquement dans un autre outil ou si personne ne surveille l'inbox.

  • Suivi des clients inactifs - Décidez ce qui se passe si le client ne répond pas après que Fin a répondu.

  • Demander plus d'informations avant le transfert - Collectez plus d'informations lorsqu'un client demande à parler à l'équipe. En collectant plus d'informations, Fin peut fournir une réponse supplémentaire, augmentant ainsi les chances de résolution.

  • Créer un ticket Zendesk lorsque Fin répond - Cette fonctionnalité a été supprimée et n'est plus disponible. Zendesk propose désormais des "AI Agent Tickets" pour tous les clients, qui créent automatiquement une visibilité sur les conversations uniquement avec l'IA. Les AI Agent tickets Zendesk sont activés par défaut. En savoir plus sur les AI Agent Tickets Zendesk.

  • Demander une évaluation de la conversation (CSAT) - Choisissez d'envoyer une enquête CSAT après que les clients ont interagi avec Fin.

  • Fermeture automatique des conversations Fin abandonnées - Décidez combien de temps Fin doit attendre avant qu'un client soit considéré comme inactif, quand fermer les conversations inactives, et personnalisez ce que Fin dit lors de la fermeture de la conversation.

Configuration des paramètres de fermeture automatique

Fin vous permet de personnaliser le comportement de fermeture automatique via des actions spécifiques dans votre workflow. Les paramètres pertinents se trouvent dans l'étape Let Fin handle. Suivez ces étapes pour gérer et personnaliser les configurations de fermeture automatique :

  • Dans l'étape Let Fin handle, trouvez la section intitulée Auto-close abandoned Fin conversations.

  • Utilisez cette section pour définir les conditions spécifiques selon lesquelles une conversation est considérée comme abandonnée. Spécifiez le délai avant que la conversation soit automatiquement fermée.

  • Pour configurer le délai de fermeture basé sur l'inactivité, ajustez les paramètres Close-on-inactivity timing dans la même section Let Fin handle. Ces paramètres vous permettent de gérer combien de temps Fin attendra avant de fermer une conversation en l'absence d'activité client détectée.

  • Allonger le délai de fermeture automatique peut aider à réduire le nombre de résolutions supposées. Par exemple, augmenter le délai par défaut (par ex., 8 heures) à 24 ou 48 heures donne plus de temps aux clients pour répondre avant la fermeture des conversations.

Conseils :

  • Fixez des délais réalistes : un délai trop court ou trop long peut nuire à l'expérience client. Cherchez à équilibrer réactivité et temps suffisant pour que les clients répondent.

  • Définissez clairement les conditions : assurez-vous que les critères d'abandon et d'inactivité sont bien définis et adaptés à votre cas d'utilisation support.

  • Testez les paramètres : effectuez des tests pour confirmer que les réglages choisis correspondent bien à vos besoins de workflow et aux attentes des clients.

Vous pouvez affiner l'expérience dans le constructeur de workflow en :

  • Créant différentes branches selon vos conditions.

  • Choisissant quand Fin répond.

  • Faisant envoyer un message par Fin.

  • Fournissant des boutons de réponse.

  • Collectant des données.

  • Collectant la réponse du client.

  • Ajoutant des notes internes.

  • Ajoutant un résumé généré par l'IA de la conversation.

  • Auto-classification des attributs du ticket basée sur ce que le client a dit.

Note : Vous devez être en mode Édition pour pouvoir modifier votre workflow. Sélectionnez Éditer en haut à droite de l'écran de l'éditeur de workflow.

Chemin de workflow Fin se terminant par une action Créer un ticket Zendesk, avec une info-bulle expliquant qu'un ticket séparé est créé avec le résumé de la conversation.
Chemin de workflow Fin se terminant par une action Transfert à un agent Zendesk, avec une info-bulle expliquant qu'un chat en direct est créé pour un membre de l'équipe.

Dans le chemin final de transfert du workflow, vous pouvez choisir comment Fin transfère la conversation :

La méthode de transfert sélectionnée détermine les API Zendesk que vous devez connecter.

Capacité

Nécessite Zendesk API (OAuth)

Nécessite Zendesk Sunshine

Créer un ticket Zendesk

Oui ✅

Non ❌

Transfert à un agent Zendesk

Oui ✅

Oui ✅

Déterminé par la situation

Oui ✅

Oui ✅

  • Créer un ticket Zendesk : Termine la session des users dans Fin et crée un ticket avec un résumé de la conversation et les données collectées.

  • Transfert vers URL : Redirige l'utilisateur vers une nouvelle URL dans le même onglet.

  • Transfert avec JavaScript : Utilise handoff_with_javascript pour définir des actions dans Fin Messenger.

  • Transfert à un agent Zendesk : Démarre un chat en direct dans Zendesk pour qu'un membre de l'équipe continue la conversation.

Si une option de transfert a déjà été sélectionnée, vous pouvez la supprimer en la survolant, en cliquant sur les 3 points qui apparaissent et en sélectionnant supprimer.

Personnalisez les sujets des tickets Zendesk en utilisant des attributs

Si votre transfert crée un ticket Zendesk, vous pouvez cliquer sur l'action Create Zendesk ticket pour personnaliser le sujet du ticket en utilisant des attributs dans votre espace de travail Fin.

Panneau Créer un ticket Zendesk avec l'attribut AI Title dans le champ titre du ticket, un sélecteur de formulaires et un bouton de vérification d'email.

Une fois que vous avez terminé de personnaliser le message d'accueil et le transfert à votre équipe, cliquez sur Enregistrer, ou Mettre en ligne pour activer cela dans votre messenger (vous pouvez aussi revenir plus tard pour le mettre en ligne).

Attribuer des tickets à des organisations Zendesk spécifiques

Si votre espace de travail Zendesk utilise des organisations et qu'un utilisateur appartient à plusieurs, vous pouvez contrôler à quelle organisation un ticket est attribué via le JWT token.

Pour ce faire :

  1. Créez ou utilisez une organisation existante dans Zendesk avec un identifiant externe, cela peut être créé via l'API Zendesk ici.

    Détails de l'organisation Zendesk avec l'ID externe 457 mis en évidence.
  2. Incluez un champ company dans le JWT avec deux attributs :

    {
    "id": "457", // This should match the external ID of the Zendesk organization.
    "name": "Examply Org"
    }

  3. Configurez un workflow Fin Messenger avec la transmission Create Zendesk ticket.

  4. Tous les tickets créés depuis Fin Messenger seront automatiquement attribués à l'organisation définie par le external_id dans le JWT (tant que cet utilisateur fait partie de l'organisation). Note : Cela n'est disponible que dans Fin Messenger sur les canaux qui supportent les JWT (le courrier électronique n'est pas pris en charge).

Astuce : Vous pouvez créer et gérer plusieurs workflows Fin directement dans votre espace de travail Fin. Cela vous permet d'adapter les expériences clients à différents scénarios de messagerie et de configurer des workflows « test » distincts déclenchés uniquement pour votre équipe.


Installer le Fin Messenger

Pour installer le Fin Messenger, allez dans Deploy > Fin Messenger > Install. Vous devrez installer le messenger soit pour votre site web ou application web, soit pour votre application mobile.

Installer pour le web

Choisissez comment vous souhaitez installer le Messenger

Tout d'abord, vous devrez choisir comment vous souhaitez installer le messenger. Si vous sélectionnez Code snippet, React, Angular, Vue, Ember ou Shopify comme méthode d'installation, vous aurez la possibilité d'installer Fin pour les visiteurs du site sans connexion.

Les instructions pour installer Code snippet, React, Angular, Vue, Ember ou Shopify se mettront à jour au fur et à mesure de votre sélection. Pour les méthodes listées qui permettent l'installation à la fois pour les Users avec connexion et les visiteurs sans, vous devrez copier le snippet de code pour chaque méthode d'installation que vous souhaitez utiliser.

Pour les Users avec connexion, vous devrez activer le bouton Enable connection to messenger pour continuer vers le code d'installation.

Suivez les instructions données

Suivez maintenant les instructions données pour la méthode que vous avez sélectionnée. Par exemple, si vous avez choisi Shopify, vous verrez les étapes requises pour cette méthode d'installation.

Si vous avez choisi la méthode Code snippet, React, Angular, Vue, ou Ember, un package NPM contenant un snippet de code à copier-coller dans la base de code de votre propre application vous sera fourni. Ce snippet est pré-rempli avec votre ID d'espace de travail unique, il est donc prêt à l'emploi.

Vous pouvez également trouver le package directement sur le site NPM.

Plusieurs autres modèles sont disponibles, comme inclure le snippet de code dans un Basic JavaScript ou une Single-page app, ou vous pouvez aussi utiliser la Rails gem pour installer le snippet.

Cliquez sur Copy code et collez-le avant la balise </body> sur chaque page où vous souhaitez que le Messenger apparaisse dans votre application.

Après avoir ajouté le code, vous pouvez visiter n'importe quelle page où vous avez installé le messenger et il devrait apparaître en bas à droite, ou vous pouvez utiliser l'option Check installation dans le processus d'installation.

Sécurisez le Fin Messenger avec les JWTs

Si vous avez installé le Fin Messenger sur votre site pour les users connectés, il est essentiel de le sécuriser et d'empêcher les acteurs malveillants d'usurper l'identité de vos users ou d'envoyer des données non autorisées. ​

Les JSON web tokens (JWTs) empêchent les tiers d'usurper l'identité de vos users connectés et de voir leurs conversations. Nous recommandons vivement à tous les clients Fin de forcer l'authentification JWT.

Avec l'authentification JWT activée, Fin synchronise automatiquement les champs utilisateur et organisation de Zendesk vers votre espace de travail Fin à chaque lancement du Fin Messenger ou réception d'un nouveau message via le Zendesk Messenger. Ce transfert de données fluide permet des interactions clients plus dynamiques et personnalisées dans vos workflows.

Évitez une dépendance excessive à la segmentation basée sur les URL : N'utilisez pas uniquement les URL pour distinguer les users connectés des déconnectés. Les URL peuvent être mises en favoris ou consultées par des utilisateurs non autorisés, ce qui les rend peu sécurisées. Combinez la segmentation basée sur les URL avec JWT pour une authentification robuste.

Installer pour mobile

Choisissez votre plateforme d'installation

Tout d'abord, vous devrez choisir votre plateforme d'installation préférée ; iOS, Android ou React Native. Toutes les plateformes choisies ont des étapes spécifiques et vous recevrez des options pour installer Fin dans vos applications mobiles ainsi que des snippets de code pour faciliter l'installation.

Initialisez Fin dans votre base de code

L'étape suivante consiste à initialiser Fin dans la base de code de votre application mobile. Vous pouvez également gérer vos clés API durant cette étape.

Les options de snippet de code pour iOS

Les options de snippet de code pour Android

Les choix pour React Native

  1. Swift

  2. Swift UI

  3. ObjectiveC

  1. Kotlin

  2. Java

  1. iOS

  2. Android

Suivez les instructions

Ensuite, suivez les instructions spécifiques à la plateforme pour intégrer Fin Messenger dans votre application mobile.

Lors de la configuration de Fin Messenger pour iOS

  1. Dans Zendesk, allez dans Admin Center > Apps and Integrations > Zendesk Sunshine.

  2. Cliquez sur Create API Key, nommez votre clé, puis cliquez sur Save.

  3. Copiez la clé générée — elle apparaîtra dans votre Zendesk Sunshine list.

  4. Dans votre Fin workspace, allez dans Deploy > Fin Messenger > Install > iOS, et collez la clé dans votre code d'initialisation.

Important :

  • Conservez votre App ID, Key ID et Secret Key en toute sécurité — ils ne seront plus affichés.

  • Vous pouvez stocker jusqu'à 10 clés au total.

  • Vous aurez besoin d'un plan Zendesk Suite Professional ou supérieur.

Vérifier l'installation

Cliquez sur Vérifier l'installation à la fin de la configuration pour vérifier le succès.
Vous verrez une confirmation si Fin Messenger a été détecté, ou un message d'erreur si quelque chose a mal tourné.

Sécurisez le Fin Messenger avec des JWT

Si vous avez installé Fin Messenger sur votre site pour les users connectés, il est essentiel de le sécuriser et d'empêcher les acteurs malveillants d'usurper vos users ou d'envoyer des données non autorisées. ​

Les JSON web tokens (JWTs) empêchent les tiers d'usurper vos users connectés et de voir leurs conversations. Nous recommandons vivement à tous les clients Fin d'appliquer l'authentification JWT.

Avec l'authentification JWT activée, Fin synchronise automatiquement les champs user et organisation de Zendesk vers votre espace de travail Fin à chaque lancement du Fin Messenger ou à la réception d'un nouveau message via le Zendesk Messenger. Ce transfert de données fluide permet des interactions client plus dynamiques et personnalisées au sein de vos workflows.

Optionnel : Configurez les notifications push

Dans cette étape, vous aurez à nouveau le choix de la plateforme d'installation ; iOS ou Android. Vous pouvez configurer les notifications push depuis cette section, mais elle ne vous guidera pas dans le processus. Utilisez plutôt notre documentation développeur pour la configuration des notifications push :

React native n'est pas proposé comme option pour les notifications push mobiles.

Cette étape optionnelle est marquée comme terminée lorsque les notifications push ont été détectées comme configurées pour une application iOS ou Android.

Important : Xcode 14 est désormais requis pour construire Fin iOS SDK v13.0.0+

Dans Xcode 14, plusieurs avertissements sont enregistrés dans la console lors de l'installation du SDK. Ces avertissements proviennent de l'utilisation par Fin de WKWebView. Il y a un bug dans Xcode 14 qui déclenche ces avertissements, et ce n'est pas un problème que Fin peut corriger.

Ce ne sont que des avertissements et Fin continue de fonctionner normalement lorsqu'ils sont présents.

Voici les messages d'avertissement :

  1. Erreur WKWebView - Voir l'article et vous voyez ceci dans la console : Error acquiring assertion : <Error Domain=RBSServiceErrorDomain Code=1 "target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit" UserInfo={NSLocalizedFailureReason=target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit}>

  2. Cette méthode ne doit pas être appelée sur le thread principal car elle peut entraîner une non-réactivité de l'interface utilisateur.

  3. [Sandbox] Impossible d'activer Mach bootstrap, errno = 22.


Testez Fin dans le Fin Messenger

Assurez-vous que Fin est prêt

Vous serez d'abord invité à vous assurer que vous avez donné suffisamment de formation à Fin. C'est important avant de commencer les tests en direct.

Nous recommandons de lire notre guide complet sur toutes les façons de former Fin afin qu'il puisse répondre aux questions de vos clients aussi précisément que possible.

Testez avant la mise en production

Une fois que vous avez vérifié que Fin est suffisamment formé et que vous avez personnalisé le messenger pour correspondre à l'image de marque de votre entreprise, vous pouvez tester Fin avant la mise en production.

C'est la meilleure façon de voir exactement comment Fin dans le Fin Messenger apparaîtra et se comportera sur le site web ou l'application où vous l'avez installé, sans que les clients ne le voient.

Pour tester Fin dans le Fin Messenger avant la mise en production :

  1. Allez dans Deploy > Fin Messenger.

  2. Cliquez sur Testez avant la mise en production en haut à droite de la page.

    Page de déploiement Fin Messenger affichant le statut Live et le bouton Testez avant la mise en production en haut à droite.
  3. Activez le bouton bascule Activer le mode test.

    Section mode test Fin Messenger avec le bouton bascule Activer le mode test et le champ URL de lancement du test.
  4. Dans le champ Lancer le test, saisissez l'URL de la page où votre Fin Messenger est installé, et démarrez le test. Vous pouvez également ajouter ?intercomTest=true à la fin de l'URL de cette page.

Important : Le mode test n'est pas disponible lorsque Fin Messenger est en direct. Si c'est le cas, Fin affiche « Fin Messenger est déjà en direct. Mettez-le en pause pour utiliser le mode test. » Mettre en pause retire Fin des chats de vos clients, donc ne mettez en pause que lorsque vous êtes prêt.

Lancement du test

Navigateur affichant une URL de page avec ?intercomTest=true ajouté, avec le lanceur Fin Messenger ouvert et des annotations pointant vers le paramètre de test et le messenger.

Test sur mobile

Pour tester sur mobile, vous devrez d'abord installer sur votre application de staging, afin de pouvoir effectuer tous les tests avant la mise en production.

Validez votre configuration dans Zendesk

Nous vous recommandons de tester que les bons users sont assignés comme demandeur du ticket dans Zendesk.

Pour confirmer cela :

  1. Commencez une conversation dans Fin Messenger en vous assurant que le bon user_id ou email est transmis.

  2. Lorsque Fin transfère la conversation, vérifiez le nouveau ticket ou chat en direct créé dans Zendesk.

  3. Vérifiez que le demandeur correspond à l'user attendu.

  4. Si le demandeur ne correspond pas, confirmez que le user_id dans Fin Messenger correspond à l'external_id dans Zendesk.


Passez en direct avec Fin pour Fin Messenger

Vous êtes maintenant prêt à mettre Fin en service pour vos clients. Allez dans Déployer > Fin Messenger > Mettre en service et sélectionnez Mettre en service.


Expérience client

Lorsqu'un client ouvre le Messenger, il verra un message de bienvenue de Fin (cela peut être personnalisé).

Lanceur Fin Messenger affichant un message de bienvenue « Salut » et le premier message, « Salut ! Qu'est-ce qui vous amène ici aujourd'hui ? »

Après qu'un client envoie un message, un ticket est créé dans Zendesk et le tag Fin-messenger sera appliqué. En utilisant les déclencheurs Zendesk, vous pouvez décider quand le ticket doit être automatiquement assigné à Fin.

Les conversations assignées à Fin appliqueront le tag fin-involved.

Si Fin dispose des connaissances pertinentes pour répondre, Fin répondra en citant les sources utilisées, marquera le ticket comme résolu et appliquera les tags suivants :

  • fin-resolved : Fin a résolu le ticket (résolution douce ou dure).

  • fin-soft-resolution : Fin a résolu la conversation, mais le client ne l'a pas confirmé.

Conversation Fin Messenger où Fin liste les sources, demande si la réponse a été utile, et propose les boutons « Ça a aidé » et « Parler à une personne ».

Ticket Zendesk avec statut Résolu et les tags fin-involved, fin-resolved et fin-soft-resolution après que Fin a répondu à une question.

Si la question est ambiguë, Fin posera des questions de clarification, marquera le ticket comme en attente et le transmettra à l'équipe si le client ne répond pas sous 3 minutes.

S'il n'a pas de réponse, il transmettra le ticket à votre équipe en se désassignant et en marquant le ticket comme ouvert.

Le client peut poser des questions de suivi et Fin suivra le même processus.

Si le client dit que cela a aidé, le tag « fin-soft-resolution » sera supprimé et « fin-hard-resolution » appliqué.

Si le client demande à parler à l'équipe, Fin se désassignera du ticket, supprimera les tags « fin-resolved » et « fin-soft/hard-resolution » et appliquera le tag « fin-routed-to-team ». Avec ce tag, vous pouvez créer des déclencheurs Zendesk supplémentaires pour rediriger le ticket. Ce comportement garantit que le statut de la conversation reflète correctement les besoins du client, permettant des transitions plus fluides vers l'équipe et réduisant le risque de tickets non résolus.

Ticket Zendesk avec statut Ouvert et le tag fin-routed-to-team après qu'un client a demandé à parler à une personne.

Lorsque l'agent répond, cela apparaîtra dans le Fin Messenger. Si le client est hors ligne et que son email est connu, une notification par email sera envoyée pour lui permettre de poursuivre la conversation par email.

Note : Vous ne pouvez pas utiliser le Fin Messenger à la fois pour Fin et pour les messages de Proactive Support (comme les chats sortants, les publications, les visites guidées de produit, les emails, etc.).

Apprenez comment configurer Fin pour les tickets Zendesk.

Avez-vous trouvé la réponse à votre question ?