Passer au contenu principal

Fin Messenger : configuration HubSpot

Apprenez à configurer Fin Messenger avec HubSpot pour traiter les demandes du site web et transférer facilement les problèmes complexes vers votre inbox HubSpot.

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 ».

    Bouton Connect to HubSpot dans l’espace de travail Fin
  • 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.

Page Deploy › Fin Messenger montrant l’aperçu complet des étapes de configuration

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.

  1. Allez dans votre portail HubSpot.

  2. Naviguez vers CRM → Inbox → Paramètres.

    Page des paramètres Inbox CRM HubSpot montrant l’option de connexion du canal

  3. Cliquez sur Connect a channel.

  4. Sélectionnez votre compte Fin Messenger dans la liste pour commencer à recevoir les conversations Fin Messenger dans votre inbox HubSpot.

    Sélection du compte Fin Messenger dans la liste des canaux HubSpot

  5. Cliquez sur Connect with Fin messenger pour continuer la configuration.

    Bouton Connect with Fin Messenger dans la configuration du canal HubSpot

  6. Cliquez sur Connect pour finaliser la configuration et connecter votre canal Fin Messenger à votre Helpdesk HubSpot.

    Bouton Connect finalisant la connexion Fin Messenger à HubSpot
  7. Optionnellement, activez Auto assign conversations pour router automatiquement les conversations entrantes vers un collègue.

    Bascule Auto assign conversations dans les paramètres du canal Fin Messenger HubSpot
  8. 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.

Page Deploy › Fin Messenger montrant l’étape Configure your connection to HubSpot

É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.

Configurer Fin pour HubSpot Messenger page des paramètres affichant le sélecteur d'agent Fin HubSpot et la section Mapper les étapes du pipeline


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).

Quatre workflows Fin HubSpot affichés dans les paramètres d'automatisation HubSpot


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 ?

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 » ?

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

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 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

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.

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