Ce guide explique comment configurer Fin Messenger avec le transfert HubSpot. Les clients discutent avec Fin via Fin Messenger sur votre site ; lorsque Fin ne peut pas résoudre le problème, il le redirige vers la file d'attente de votre agent 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.
Astuce : 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 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 HubSpot Tickets et Fin Messenger — si vous êtes déjà connecté pour HubSpot Tickets, passez à l'étape suivante.
Connectez-vous avec 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.
Astuce : 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, classer 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 de 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 transmis à 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 transmet 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 votre 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 d'attente 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 iOS SDK si vous utilisez iOS
Utilisez Vérifier l'installation pour confirmer
Optionnel : configurez les notifications push
Partie 4 : Tester
Testez l'intégration
Utilisez le tableau de bord Fin Test : Naviguez vers 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 restreindre à une page de test spécifique (par exemple,
votresite.com/test) avant de le déployer à tous les visiteurs.
Partie 5 : Mettre Fin Messenger en production
Lorsque vous êtes prêt, cliquez sur Mettre 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. Lorsque 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 la conversation complète dans votre espace 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 utilisateurs (OTP) lors du transfert à un 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 configuration d'authentification existante. En savoir plus sur la vérification d'identité client avec l'étape de workflow Email OTP.
Vérification des users
Lors de l'utilisation du 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 de l'email avant le transfert à un ticket : Lorsqu'activé, les users doivent vérifier avec succès leur email 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é avec 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 poursuive. Cela empêche les users non vérifiés de créer des tickets sous l'identité d'une autre personne.
Astuce : 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 en tant que 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 chacun et attachez les extraits pertinents et synchronisations web à chaque audience.
Règles de priorité d'audience
Un public plus large (par exemple « URL contains theescapegame.com ») ne sera pas automatiquement remplacé par un public plus spécifique (par exemple « URL contains theescapegame.com/nashville ») sauf si le public spécifique est placé plus haut dans l'ordre de priorité.
Si un visiteur sur une page spécifique à un lieu reçoit du contenu du mauvais public, vérifiez que votre règle de public spécifique est classée au-dessus de la règle générale.
Important : Lors de la mise à jour des publics cibles du contenu après synchronisation, supprimez le contenu puis resynchronisez. Mettre à jour simplement le public 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 cessent de passer 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, tous les 4 workflows HubSpot créés par Fin sont définitivement supprimés, et votre configuration Fin est retirée. Vous devrez refaire toute la procédure d'installation 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. Désaffecter Fin d'abord signifie qu'il ne traitera aucun message entrant — car il n'est plus assigné.
Répondez simplement directement dans HubSpot sans changer l'assignation. Fin détecte qu'un coéquipier a répondu et se retire automatiquement — il n'enverra plus de réponses et nettoiera les tags Fin pour refléter le transfert.
FAQ
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 lorsqu'un visiteur revient sur la page. Le visiteur devra cliquer manuellement sur l'icône Messenger pour la rouvrir. Contactez votre équipe Fin accounts 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 (« Your conversation has been transferred to a support ticket. You will receive updates via 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 web et vérifiez que Messenger est réglé sur Live dans les paramètres Deploy de votre espace Fin. Un pop-out par défaut « Need Help? » apparaît 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 en même temps. Voici comment le corriger selon votre configuration : Si vous utilisez Hand-off to 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 Hand-off to ticket dans HubSpot : N'ayez pas aussi le canal Fin Messenger installé dans votre inbox HubSpot. Le canal Fin Messenger crée déjà un ticket lors du transfert — ajouter une étape Hand-off to ticket dans HubSpot duplique cela. Une seule méthode de transfert doit être active à 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 et que l'audience spécifique au lieu est classée au-dessus de toute audience générale dans l'ordre de priorité.
Confirmez que les snippets 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 récupère.