Ce guide explique comment configurer Fin Messenger avec le transfert HubSpot. Les clients discutent avec Fin via Fin Messenger sur votre site web ; lorsque Fin ne peut pas résoudre le problème, il le redirige vers la file d’attente de vos agents HubSpot ou crée un nouveau ticket HubSpot avec la transcription complète de la conversation.
Prérequis
Avant de commencer, assurez-vous d’avoir les éléments suivants :
HubSpot connecté via OAuth : Si vous n’êtes pas encore connecté, allez dans Connect dans la navigation principale pour autoriser l’accès de Fin à HubSpot — passez cette étape si vous êtes déjà connecté.
Accès au site web : Accès au code de votre site ou application pour installer le snippet Fin Messenger.
Permissions HubSpot : Accès administrateur à votre compte HubSpot pour ajouter un canal inbox.
Conseil : Créez un utilisateur dédié — par exemple « Fin AI » — plutôt que d’utiliser un compte personnel. Cela permet de séparer la propriété des tickets Fin des files d’attente de vos collègues et facilite la gestion de l’intégration si vous devez la suspendre ou la révoquer.
Partie 1 : Connexion à HubSpot
Allez dans Connect dans la navigation principale pour vous connecter à HubSpot. La connexion est partagée entre les Tickets HubSpot et Fin Messenger — si vous êtes déjà connecté pour les Tickets HubSpot, passez à l’étape suivante.
Connectez-vous à HubSpot
Connectez votre compte HubSpot pour donner à Fin l’accès aux conversations et activer le support alimenté par l’IA.
Cliquez sur le bouton « Connect ».
Vous serez redirigé vers HubSpot pour vous authentifier
Une fois authentifié, vous serez redirigé vers Fin pour continuer.
En connectant Fin à HubSpot, vous acceptez nos conditions pour les plateformes tierces.
Sur la page Deploy › Fin Messenger, vous verrez les étapes pour configurer Fin Messenger.
Installez le canal Fin Messenger dans votre portail HubSpot
Connectez le canal Fin Messenger dans votre helpdesk HubSpot pour permettre à Fin de répondre aux questions entrantes.
Allez dans votre portail HubSpot.
Naviguez vers CRM → Inbox → Paramètres.
Cliquez sur Connect a channel.
Sélectionnez votre compte Fin Messenger dans la liste pour commencer à recevoir les conversations Fin Messenger dans votre inbox HubSpot.
Cliquez sur Connect with Fin messenger pour continuer la configuration.
Cliquez sur Connect pour finaliser la configuration et connecter votre canal Fin Messenger à votre Helpdesk HubSpot.
Optionnellement, activez Auto assign conversations pour router automatiquement les conversations entrantes vers un collègue.
Une fois installé, retournez dans votre espace de travail Fin et cliquez sur Refresh status pour continuer.
Conseil : Testez le Messenger dans un environnement QA avant de l’installer en production.
Synchronisez les données depuis HubSpot
Cette étape est optionnelle, vous devez d’abord vous connecter à HubSpot pour synchroniser les données. Utilisez ces données pour cibler votre contenu vers différents publics, classifier automatiquement les tickets et créer des branches dans les workflows.
Configurez votre connexion à HubSpot
Sur la page Deploy › Fin Messenger, cliquez sur Configure your connection to HubSpot. Cela ouvre une page de paramètres avec deux éléments à compléter : sélectionnez l’utilisateur HubSpot que Fin représente (utilisez un compte dédié — par exemple « Fin AI » — plutôt qu’un compte personnel), puis choisissez votre pipeline et mappez ses étapes aux états de Fin.
État Fin | Ce que cela signifie | Étape par défaut du pipeline Support |
Nouveau ticket | L’étape que Fin surveille pour prendre en charge les nouveaux tickets | Nouveau |
En attente du client | Fin déplace le ticket ici en attendant une réponse du client | En attente du contact |
En attente de votre équipe | Fin déplace le ticket ici lorsqu'il est transféré à un coéquipier humain | En attente de notre part |
Résolu | Fin déplace le ticket ici lorsqu'il résout une conversation | Fermé |
Note : Pour trouver vos noms de pipeline et d'étape dans HubSpot, allez dans Paramètres > Gestion des données > Objets > Tickets > Pipelines et cliquez sur le nom de votre pipeline. Cette configuration est partagée sur tous vos canaux HubSpot — si vous l'avez déjà configurée pour HubSpot Tickets, vous pouvez passer cette étape. Pour mettre à jour cette configuration ultérieurement, allez dans Paramètres > Canaux > Fin Messenger.
Partie 2 : Construisez votre workflow
Personnalisez la façon dont Fin salue et répond aux clients, ou transfère lorsqu'il ne peut pas aider. Sur la page Déployer › Fin Messenger, cliquez sur Ajouter un workflow dans votre espace Fin pour personnaliser l'expérience et la mettre en ligne.
Un workflow avec le déclencheur lorsqu'un client ouvre une nouvelle conversation dans Fin Messenger se remplira automatiquement avec un flux par défaut. Le workflow par défaut inclut :
Une étape de triage Fin — Fin tente de résoudre la question du client en utilisant votre knowledge base et contenu
Un chemin de résolution — si Fin résout la requête, la conversation est fermée
Un chemin de transfert — si Fin ne peut pas résoudre, la conversation est escaladée vers votre file d'attente d'agents HubSpot ou un nouveau ticket HubSpot est créé avec la transcription complète
Dans le workflow, vous pouvez personnaliser :
Le message de bienvenue que Fin envoie lorsqu'un client ouvre une conversation
Les conditions de transfert — quand Fin redirige vers un coéquipier vs. crée un ticket, et vers quelle inbox ou file HubSpot diriger. Il y a deux modes de transfert à choisir : Transfert à un agent dans HubSpot (lorsque le canal Fin Messenger est installé dans votre inbox HubSpot) ou Transfert à un ticket dans HubSpot (lorsqu'il ne l'est pas).
Partie 3 : Installer Fin Messenger
Installer Fin Messenger pour le web
Pour l'installation web :
Choisissez votre méthode d'installation (Code snippet, React, Angular, Vue, Ember, Shopify)
Suivez les instructions spécifiques à la méthode — copiez le package NPM/code snippet et collez-le avant la balise sur chaque page où vous voulez que le Messenger apparaisse
Utilisez Vérifier l'installation pour confirmer que cela fonctionne
Installer Fin Messenger pour mobile
Pour l'installation mobile :
Choisissez votre plateforme (iOS, Android ou React Native)
Initialisez Fin dans votre base de code et suivez les étapes spécifiques à la plateforme
Générez votre clé API SDK iOS si vous utilisez iOS
Utilisez Vérifier l'installation pour confirmer
Optionnel : configurez les notifications push
Partie 4 : Testez
Testez l'intégration
Utilisez le tableau de bord Fin Test : Allez à l'onglet Test dans la barre latérale Fin pour prévisualiser la qualité des réponses et vérifier les chemins d'escalade sans affecter votre site en direct.
Contrôlez où le Messenger est affiché : Le Fin Messenger n'apparaît que là où vous installez le code snippet. Pour les tests, installez-le sur une URL de staging ou utilisez les règles d'URL dans la section Déployer pour le limiter à une page de test spécifique (par exemple,
votresite.com/test) avant de le déployer à tous les visiteurs.
Partie 5 : Passez en production avec Fin Messenger
Lorsque vous êtes prêt, cliquez sur Passer en production dans le flux de déploiement. Cela active les quatre workflows HubSpot et Fin commencera immédiatement à gérer les conversations selon le workflow et la knowledge base que vous avez configurés. Votre configuration d'escalade dépend de la présence du canal Fin Messenger dans votre inbox HubSpot.
Transfert à un agent dans HubSpot
Utilisez cette option lorsque le canal Fin Messenger est installé dans votre inbox HubSpot. Quand Fin ne peut pas résoudre une conversation, il met à jour le ticket vers votre étape waiting-on-team mappée et désaffecte Fin pour qu'un coéquipier puisse le prendre en charge dans HubSpot.
Transfert à un ticket dans HubSpot
Utilisez cette option lorsque le canal Fin Messenger n'est pas installé dans votre inbox HubSpot. Fin gère toute la conversation dans votre espace de travail sans synchronisation avec HubSpot. Lors de l'escalade, un nouveau ticket HubSpot est créé avec la transcription complète.
Important : Si vous désactivez la vérification des users (OTP) lors du transfert à ticket, les users connectés ne seront plus vérifiés avant la création d'un ticket HubSpot. Sans la vérification d'identité JSON Web Token (JWT), un client pourrait usurper l'identité d'un autre user dans HubSpot — c'est un risque de sécurité sérieux. Désactivez OTP uniquement si vous avez pleinement confiance en votre système d'authentification actuel. En savoir plus sur la vérification d'identité client avec l'étape de workflow Email OTP.
Vérification des users
Lorsque vous utilisez Transfert à un ticket dans HubSpot, vous pouvez exiger que les users vérifient leur adresse email avant la création d'un ticket. Cela ajoute une couche supplémentaire de confirmation d'identité au moment de l'escalade.
Exiger la vérification email avant le transfert à ticket : Lorsqu'activé, les users doivent vérifier leur email avec succès avant qu'un ticket HubSpot soit créé en leur nom.
Exiger OTP lorsque le Messenger n'est pas sécurisé : Si le Messenger n'est pas sécurisé par la vérification d'identité JSON Web Token (JWT), les users doivent vérifier leur adresse email avec un mot de passe à usage unique (OTP) avant que le transfert ne se fasse. Cela empêche les users non vérifiés de créer des tickets sous l'identité d'une autre personne.
Conseil : La configuration la plus sécurisée est d'implémenter la vérification d'identité JWT sur votre Messenger. OTP est une solution de secours pour les installations Messenger non sécurisées — pas un substitut à une vérification d'identité appropriée.
Note : Lors du transfert dans Messenger, si le client n'existe pas encore comme contact dans HubSpot, un nouveau contact est automatiquement créé avec les informations collectées pendant la conversation.
Ciblage d'audience et de contenu
Si vous servez plusieurs emplacements ou marques, configurez des Audiences séparées dans Fin pour chacune et attachez les extraits et synchronisations web pertinents à chaque audience.
Comment les audiences se combinent
Les audiences n'ont pas d'ordre de priorité, et une audience plus spécifique ne remplace pas une audience plus large. Fin peut utiliser un contenu pour tout visiteur correspondant à au moins une des audiences qui y sont attachées.
Par exemple, si l'audience d'un extrait général est « URL contient example.com », cela correspond aussi aux visiteurs sur example.com/london, donc Fin peut l'utiliser avec votre contenu spécifique à Londres.
Pour empêcher le contenu général d'apparaître sur des pages spécifiques à un lieu, ajoutez une condition à l'audience générale qui les exclut, comme « URL ne contient pas /london ».
Important : Lors de la mise à jour des audiences cibles du contenu après synchronisation, supprimez le contenu puis resynchronisez-le. Mettre simplement à jour l'audience sur un contenu déjà synchronisé peut ne pas s'appliquer correctement. C'est un comportement connu — pas une limitation permanente — donc vérifiez les mises à jour.
Note : Fin peut synchroniser le contenu directement depuis les URL de votre site web. Si vous mettez à jour le contenu d'une page synchronisée, vous devrez la resynchroniser pour que Fin prenne en compte les modifications — Fin ne détecte pas automatiquement les mises à jour de page.
Désactiver vs. révoquer
Lorsque vous devez mettre en pause ou supprimer l'intégration HubSpot, vous avez deux options, et il est important de comprendre la différence.
Désactiver met l'intégration en pause sans détruire votre configuration. Tous les workflows HubSpot créés par Fin sont désactivés, et les conversations ne passent plus par Fin. Votre configuration, connexion OAuth et propriétés HubSpot sont conservées. Vous pouvez réactiver à tout moment et reprendre là où vous vous êtes arrêté.
Révoquer est une suppression complète. La connexion OAuth est détruite, les 4 workflows HubSpot créés par Fin sont définitivement supprimés, et votre configuration Fin est effacée. Vous devrez refaire toute la configuration si vous souhaitez vous reconnecter.
Prendre le relais d'une conversation depuis Fin
Si vous devez intervenir pendant que Fin gère activement une conversation Messenger, ne désaffectez pas manuellement Fin avant de répondre. Le désaffecter d'abord signifie qu'il ne traitera plus les messages entrants — car il n'est plus assigné.
Répondez directement dans HubSpot sans changer l'assignation. Fin détecte qu'un collègue a répondu et se retire automatiquement — il n'enverra plus de réponses et supprimera les tags Fin pour refléter le transfert.
FAQs
Puis-je empêcher Fin Messenger de s'ouvrir automatiquement lorsqu'un visiteur revient ?
Puis-je empêcher Fin Messenger de s'ouvrir automatiquement lorsqu'un visiteur revient ?
Il n'existe actuellement aucun paramètre natif pour empêcher Fin de se rouvrir quand un visiteur revient sur la page. Le visiteur doit cliquer manuellement sur l'icône Messenger pour la rouvrir. Contactez votre équipe Fin pour suivre la demande de cette fonctionnalité.
Puis-je personnaliser le message « Votre conversation a été transférée » ?
Puis-je personnaliser le message « Votre conversation a été transférée » ?
Le message de confirmation de transfert (« Votre conversation a été transférée à un ticket de support. Vous recevrez des mises à jour par email. ») est un message système et ne peut pas être modifié.
Fin Messenger ne s'affiche pas sur le site web
Fin Messenger ne s'affiche pas sur le site web
Confirmez que le snippet de code Messenger est correctement installé sur votre site et vérifiez que Messenger est réglé sur Live dans les paramètres Deploy de votre espace Fin. Un pop-out « Need Help? » apparaît par défaut après 6 secondes. Ce comportement ne peut pas encore être complètement désactivé.
Des tickets en double sont créés dans HubSpot
Des tickets en double sont créés dans HubSpot
Des tickets en double sont créés lorsque les deux modes de transfert sont actifs simultanément. Voici comment corriger selon votre configuration : Si vous utilisez Transfert à un agent dans HubSpot : Supprimez l'application Fin Messenger de votre inbox HubSpot (allez dans Settings → Inboxes dans HubSpot). Avoir le canal Fin Messenger installé dans HubSpot en même temps provoque la création de deux tickets à chaque escalade. Si vous utilisez Transfert à un ticket dans HubSpot : N'installez pas aussi le canal Fin Messenger dans votre inbox HubSpot. Le canal Fin Messenger crée déjà un ticket lors du transfert — ajouter un transfert à ticket dans HubSpot duplique cela. Un seul mode de transfert doit être actif à la fois.
Fin donne des réponses incorrectes pour un lieu spécifique
Fin donne des réponses incorrectes pour un lieu spécifique
Vérifiez les points suivants :
Confirmez que vos Audiences sont correctement configurées. Les audiences n'ont pas d'ordre de priorité, donc si une audience générale correspond aussi aux pages du lieu, ajoutez une condition qui exclut ces pages (comme « URL ne contient pas /london »).
Confirmez que les extraits et synchronisations web pertinents sont attachés à la bonne audience, pas à l'audience générale.
Utilisez la fonction Test de Fin pour simuler un visiteur depuis une URL spécifique et vérifier quel contenu Fin utilise.











