Ce guide vous accompagne dans la configuration de Fin sur les tickets email HubSpot. Pour Fin Messenger avec transfert HubSpot, voir Fin Messenger HubSpot setup.

Prérequis

Avant de commencer, assurez-vous d'avoir :

HubSpot Service Hub Professional : Les tickets doivent être activés dans votre compte.
Utilisateur HubSpot dédié : Un siège de support pour représenter Fin AI (par exemple, « Fin AI Agent »). Nous recommandons un compte dédié plutôt qu'un compte personnel — c'est plus facile à déboguer quand il est clair quel administrateur agit, et cela protège contre les problèmes si le compte de cet agent est supprimé ou si ses permissions changent.
Accès administrateur : Permissions administratives complètes dans votre espace de travail Fin.

Étape 1 : Connecter HubSpot

HubSpot utilise OAuth2 pour se connecter. Les jetons se rafraîchissent automatiquement pour que la connexion reste active.

Allez à Déployer > Tickets HubSpot et cliquez sur Connect.
Complétez le flux d'autorisation OAuth HubSpot pour accorder l'accès à Fin.
Une fois terminé, votre statut affichera Connecté.

Choisissez un agent Fin HubSpot

Sélectionnez l'utilisateur HubSpot qui représente Fin AI. Cet utilisateur possédera les tickets pendant que Fin les traite.

Note : Nous recommandons un compte dédié plutôt qu'un compte personnel — c'est plus facile à déboguer quand il est clair quel administrateur agit, et cela protège contre les problèmes si le compte de cet agent est supprimé ou si ses permissions changent. Si un utilisateur HubSpot n'apparaît pas dans la liste, vérifiez qu'il dispose d'un siège de support valide et des permissions correctes dans HubSpot.

Synchroniser les données depuis HubSpot (optionnel)

Une fois connecté, vous pouvez synchroniser les attributs de HubSpot vers Fin. Fin pousse et tire ces attributs tout au long du cycle de vie de la conversation, gardant les données synchronisées entre les deux plateformes. Utilisez cela pour cibler votre contenu à différents publics, classifier automatiquement les tickets, et créer des branches dans les workflows.

Configuration automatique

Après une connexion réussie, Fin :

Crée trois propriétés personnalisées de ticket dans HubSpot (Fin Status, Fin Tags, et Fin Assignment) sous un groupe de propriétés « Fin AI Agent ».
Déploie quatre workflows HubSpot (initialement désactivés) : Assign New Tickets, Resolution, Pending, et Route to Team. Ne les supprimez pas car ils sont nécessaires pour que Fin fonctionne correctement.
Configure le workflow Fin par défaut pour le triage et les transferts.

Étape 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. Allez dans Gérer le workflow dans votre espace de travail Fin pour personnaliser l'expérience et la mettre en ligne.

Avant de passer en ligne, assurez-vous que votre knowledge base, vos directives et votre ton sont configurés dans vos paramètres Fin AI. Lorsque vous passez en ligne, le workflow Assign New Tickets commence immédiatement à acheminer tous les nouveaux tickets HubSpot vers Fin — Fin répondra et transférera selon le workflow que vous avez construit.

Note : Les options de réponse et les étapes de création de ticket ne sont pas disponibles sur le canal de conversations email HubSpot. Le seul mode de transfert pour les tickets HubSpot est Transfert à un agent dans HubSpot.

Étape 3 : Testez Fin

Avant de passer en ligne, validez que Fin répond correctement sans affecter votre file de tickets en direct. Il y a deux approches :

Option 1 : Utilisez la fonction Test de Fin

Assurez-vous d'avoir ajouté suffisamment de contenu à votre knowledge base pour que Fin puisse s'en servir.
Utilisez la fonction Test de Fin pour poser de vraies questions clients et examiner les réponses de Fin.
Affinez votre contenu et vos directives jusqu'à ce que vous soyez satisfait des réponses de Fin.

Option 2 : Déploiement par phase basé sur des critères (recommandé)

Vous pouvez restreindre les critères du workflow Assign New Tickets avant de passer complètement en ligne pour que Fin ne prenne en charge que les tickets que vous souhaitez gérer. Cela vous permet de tester le flux complet avec de vrais tickets sans que Fin ne prenne toute votre file.

Note : L'intégration doit être réglée sur Live avant que Fin ne réponde à des tickets — y compris les tickets de test. Complétez d'abord la Partie 4 : Mise en ligne, puis utilisez les critères ci-dessous pour restreindre les tickets que Fin prend en charge pendant les tests.

Dans HubSpot, allez à Automatisation > Workflows > Fin AI Agent – Assign New Tickets workflow.
Ajoutez un critère : ticket Description égal à « FIN test ».
Envoyez un email test à votre adresse support avec « FIN test » dans la description. Seul ce ticket sera acheminé vers Fin — les autres ne seront pas affectés.
Validez le flux complet incluant la résolution, le transfert et les mises à jour des propriétés.
Quand vous êtes prêt à passer complètement en ligne, supprimez ou élargissez les critères dans le workflow.

Astuce : Cette approche par critères fonctionne aussi pour un déploiement progressif, par exemple, en ne routant qu'un type spécifique de ticket vers Fin avant d'étendre à toute votre file.

Étape 4 : Mise en ligne

Quand vous êtes prêt à passer en ligne, cliquez sur Go live. Cela active les quatre workflows HubSpot et Fin commence à gérer les tickets entrants.

Comment ça fonctionne

Flux des tickets HubSpot

Un ticket est créé dans HubSpot et le workflow Assign New Tickets se déclenche, l'assignant à l'agent Fin AI.
Un webhook est déclenché vers Fin. Fin récupère le ticket, le fil de discussion et le contact, puis crée une conversation Fin.
Fin traite le ticket et synchronise les réponses dans le fil du ticket HubSpot en temps réel.
Les propriétés personnalisées HubSpot sont mises à jour en continu : Fin Status (ouvert/en attente/résolu), Fin Tags (type de résolution), Fin Assignment (agent).
Les quatre workflows HubSpot réagissent à ces changements de propriété pour mettre à jour les étapes du pipeline de tickets et l'affectation en conséquence.

Synchronisation bidirectionnelle des messages

Les messages du fil de ticket HubSpot se synchronisent avec les conversations Fin
Les réponses dans Fin se synchronisent en retour comme des réponses sur le fil de ticket HubSpot
Les pièces jointes d'image sont synchronisées de HubSpot vers Fin

Rapport basé sur les propriétés

Fin met automatiquement à jour trois propriétés personnalisées HubSpot tout au long du cycle de vie de chaque ticket, vous offrant une visibilité complète sur ce que Fin fait :

Propriété	Valeurs	Ce qu'elle suit
Fin Status	ouvert, en attente, résolu	État actuel du ticket dans la gestion de Fin
Fin Tags	fin-involved, fin-soft-resolution, fin-resolved, fin-routed-to-team	Comment le ticket a été traité (par ex. résolu, routé vers une équipe)
Fin Assignment	fin, human-teammate	Si Fin ou un coéquipier humain possède actuellement le ticket

Utilisez ces propriétés dans les outils natifs de reporting et de filtrage de HubSpot pour suivre l'implication de Fin, les taux de résolution et les schémas de transfert dans votre pipeline de tickets.

Désactivation ou révocation

Désactiver

Met en pause l'intégration sans perdre la configuration. Utilisez ceci pour arrêter temporairement Fin de gérer les tickets.

Les quatre workflows HubSpot sont désactivés.
La configuration et les mappages de champs sont conservés.

Révoquer

Une suppression complète de l'intégration.

Tous les workflows HubSpot sont supprimés.
La connexion OAuth est détruite.

Important : La révocation nécessite une reconfiguration complète pour se reconnecter. Utilisez Désactiver si vous avez seulement besoin d'une pause temporaire.

Dépannage

Fin ne répond pas aux tickets HubSpot

Si Fin ne prend pas en charge les tickets, vérifiez les points suivants :

HubSpot Workflows : Dans HubSpot, allez à Automation > Workflows et confirmez que les quatre workflows Fin sont activés.
Affectation : Assurez-vous que le workflow Assign New Tickets assigne correctement les tickets à l'utilisateur agent Fin AI désigné.
Statut de la connexion : Vérifiez que la connexion OAuth est toujours active dans les paramètres Deploy de votre espace de travail Fin. Si elle a expiré, réautorisez la connexion.
Fin Workflow : Confirmez que le workflow Fin dans votre espace de travail est réglé sur Live.

L'utilisateur HubSpot n'apparaît pas dans le sélecteur

Si vous ne trouvez pas l'utilisateur dédié « Fin AI » dans la liste des agents, vérifiez que l'utilisateur dispose d'un support seat valide dans HubSpot avec les permissions correctes.

Prendre le relais d'une conversation de Fin

Si vous devez intervenir pendant que Fin gère activement un ticket, 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 affecté au ticket.

Répondez simplement directement dans HubSpot sans changer l'affectation. Fin détecte qu'un coéquipier a répondu et se retire automatiquement — il n'enverra plus de réponses et mettra à jour les Fin tags pour refléter le transfert.

FAQ

Le titre du ticket HubSpot peut-il être dynamique ?

Les titres de tickets HubSpot sont actuellement statiques. Les titres dynamiques (par ex. incluant le nom de l'audience, l'email du visiteur ou le sujet de la conversation) ne sont pas encore pris en charge en option native.

Quelles valeurs de tag Fin applique-t-il aux tickets HubSpot ?

Fin utilise les tags suivants pour suivre les états des tickets tout au long du cycle de vie de la conversation :

fin-involved — Fin a participé à la conversation.
fin-soft-resolution — Fin a fourni une réponse mais le ticket n'a pas été confirmé comme résolu.
fin-resolved — Fin a entièrement résolu le ticket.
fin-routed-to-team — Le ticket a été transmis à un coéquipier humain.

Ce sont les mêmes valeurs de tag utilisées dans toutes les intégrations Fin.

Fin pour les tickets HubSpot : Configuration