Intégrations

Finn donne les meilleurs résultats lorsqu'il est connecté aux systèmes que vous utilisez déjà : votre CRM, votre agenda, votre opérateur téléphonique, la messagerie de votre équipe. Cette page passe en revue chacun d'eux en partant du principe que vous n'avez jamais configuré d'intégration de votre vie.

Vous n'avez pas besoin de toutes ces intégrations. La plupart des utilisateurs commencent avec un simple agenda (pour que le Finn puisse prendre des rendez-vous) et parfois un CRM. Ajoutez les autres quand un besoin précis se présente.

Toutes les connexions sont réversibles. Vous pouvez déconnecter n'importe quel service à tout moment, depuis l'écran qui a servi à le connecter. La plateforme ne retient jamais vos données en otage.

Où trouver les intégrations

Barre latérale → Paramètres → Intégrations.

Une tuile s'affiche pour chaque intégration disponible, avec une étiquette indiquant son statut : Non connectée, Connectée ou Attention requise. Cliquez sur une tuile pour la configurer ou la gérer.

CRM

Un CRM est l'endroit où vous conservez vos fiches clients et contacts. Connecter votre CRM vous permet de :

1. Importer vos contacts pour ne plus avoir à téléverser de CSV manuellement.
2. Renvoyer les résultats d'appel afin que votre équipe commerciale voie ce qui s'est passé sur chaque appel sans quitter son CRM.

HubSpot

La configuration se fait presque entièrement en quelques clics. Comptez 10 minutes.

1. Paramètres → Intégrations → HubSpot → Connecter.
2. Vous êtes redirigé vers HubSpot. Connectez-vous (si ce n'est pas déjà fait) et cliquez sur Autoriser.
3. Vous revenez dans Finn avec un badge vert « Connecté ».
4. Choisissez maintenant ce que vous voulez importer. Cliquez sur Choisir les listes. Cochez les listes HubSpot à utiliser comme audiences.
5. Définissez une fréquence de synchronisation — toutes les 15 minutes est une bonne valeur par défaut pour les campagnes actives ; quotidienne suffit pour les listes qui évoluent lentement.
6. Mappez les champs — indiquez à Finn quelle propriété HubSpot correspond au nom, au téléphone, à l'indicatif pays. Facultatif : mappez des propriétés supplémentaires vers des champs personnalisés pour que le Finn puisse les utiliser en cours d'appel.

C'est tout. Vos listes HubSpot apparaissent désormais comme audiences dans Finn.

Pour que les résultats d'appel soient réécrits dans HubSpot, activez la synchronisation des résultats pendant la configuration (ou plus tard, depuis le même écran). Chaque appel terminé devient un engagement HubSpot ; les champs d'analyse post-appel deviennent des mises à jour de propriétés.

Salesforce

Même déroulement général que pour HubSpot. Quelques particularités Salesforce :

• Vous pouvez connecter un environnement Production ou Sandbox. L'assistant de configuration vous demande lequel.
• Permissions requises — il vous faut un utilisateur disposant de « API Enabled » et des droits « Read/Write » sur les Leads, les Contacts et, le cas échéant, les objets personnalisés. La plupart des administrateurs CRM peuvent s'en charger.
• Objets personnalisés pris en charge. Si votre processus commercial utilise un objet personnalisé (par ex. « Opportunity Owner Calls »), vous pouvez effectuer le mappage vers celui-ci plutôt que vers les objets Lead/Contact standard.

Pipedrive

Pipedrive utilise un jeton API plutôt qu'OAuth.

1. Dans Pipedrive : Paramètres → Préférences personnelles → API → Générer un jeton.
2. Collez le jeton dans Finn → Paramètres → Intégrations → Pipedrive.
3. Poursuivez la configuration comme pour HubSpot.

« Mon CRM n'est pas dans la liste »

Utilisez l'intégration Webhook (plus bas sur cette page) pour envoyer les résultats d'appel vers n'importe quel service capable de recevoir des requêtes HTTP. Ou passez par un outil comme Zapier/Make pour faire le pont — voir la section Zapier ci-dessous.

Agenda — pour la prise de rendez-vous

Si vous voulez que votre Finn prenne des rendez-vous, un agenda doit être connecté.

Google Calendar

1. Paramètres → Intégrations → Google Calendar → Connecter.
2. Connectez-vous à Google et accordez les autorisations d'agenda.
3. Choisissez quel calendrier utiliser pour les réservations. La plupart des gens en ont plusieurs — choisissez le bon.
4. Définissez les règles de disponibilité :
   • Heures de travail — quand les réservations sont autorisées
   • Délai entre événements — écart minimum entre deux rendez-vous consécutifs (ex. 10 min)
   • Nombre max d'événements par jour — limite de sécurité facultative
5. Enregistrez.

Désormais, dans n'importe quel Finn, vous pouvez ajouter une tâche ou une action de workflow « Réserver un créneau » et elle utilisera ce calendrier.

Microsoft Outlook / Microsoft 365

Identique à Google. Autorisez via Microsoft, choisissez un calendrier, définissez la disponibilité.

Calendly / Cal.com

Ces services fonctionnent différemment — ils ne permettent pas la réservation directe via API comme le font Google/Outlook. À la place, le Finn dit « Je vous envoie un lien de réservation » et un SMS ou e-mail part avec l'URL.

Cela fonctionne, mais paraît moins naturel que la réservation directe. Si vous avez le choix, connectez plutôt Google ou Outlook directement.

Fournisseurs téléphoniques — si vous apportez votre propre numéro

Si vous avez déjà un numéro de téléphone chez un autre fournisseur (Twilio, Vonage, le PBX de votre bureau), vous pouvez continuer à l'utiliser via Finn.

Voir Numéros de téléphone → Apporter votre propre numéro pour le guide complet.

Fournisseurs pris en charge : Twilio, Plivo, Bandwidth, Vonage et les opérateurs génériques compatibles SIP.

Webhooks — pour envoyer des données vers vos propres systèmes

Un webhook est une URL de votre côté à laquelle Finn envoie des données lorsqu'un événement survient (fin d'un appel, fin d'un déploiement, etc.).

Utile quand :

• Vous voulez que chaque appel terminé alimente votre entrepôt de données pour des analyses personnalisées
• Vous voulez déclencher un message Slack ou un e-mail lorsqu'un événement précis se produit
• Votre CRM ou application métier n'est pas pris en charge nativement, mais peut recevoir des requêtes HTTP
• Vous voulez utiliser Zapier/Make/n8n pour automatiser des actions en aval

Configurer un webhook

1. Paramètres → Intégrations → Webhooks → Ajouter un point de terminaison.
2. Saisissez l'URL vers laquelle Finn doit envoyer les données.
3. Choisissez les événements auxquels vous abonner :
   • Appel démarré — se déclenche dès le début d'un appel
   • Appel terminé — se déclenche à la fin d'un appel (transcription prête mais pas encore analysée)
   • Appel analysé — se déclenche une fois l'analyse post-appel terminée (le plus utile pour l'automatisation en aval)
   • Déploiement lancé — se déclenche quand un déploiement passe en direct
   • Déploiement terminé — se déclenche quand un déploiement se termine, avec les métriques agrégées
4. Enregistrez. Finn affiche un secret de signature — copiez-le en lieu sûr (vous ne le verrez qu'une seule fois).
5. Vérifiez le secret de signature sur votre point de terminaison pour confirmer que les requêtes viennent bien de Finn.

À quoi ressemblent les données

Chaque événement envoie du JSON à votre URL. Un événement call.analyzed ressemble à peu près à ceci :

{
  "event": "call.analyzed",
  "call": {
    "id": "call_abc123",
    "deployment_id": "deploy_xyz",
    "started_at": "2026-06-15T10:30:00Z",
    "duration_seconds": 142,
    "contact": { "name": "Alice Chen", "phone_number": "+15551234567" },
    "transcript": [ ...turn-by-turn... ],
    "post_call_analysis": {
      "appointment_booked": true,
      "appointment_time": "2026-06-22 14:00"
    },
    "sentiment": "positive"
  }
}

Le schéma complet se trouve dans notre référence développeur sur api.hirefinn.ai/docs.

Quand les webhooks ne fonctionnent pas

Si Finn ne parvient pas à joindre votre endpoint (erreur DNS, timeout, réponse 5xx), il réessaie avec backoff pendant 24 heures maximum. Chaque échec de livraison apparaît dans Paramètres → Intégrations → Webhooks → Journal de livraison avec le message d'erreur — utile pour le débogage.

Webhooks pendant un appel (recherche de données en direct)

Il existe un autre type de webhook : celui que votre Finn appelle pendant une conversation pour rechercher des données en direct.

Exemple : un client appelle au sujet de sa commande. Le Finn doit connaître le statut de la commande, mais celui-ci se trouve dans votre système, pas dans Finn. Le Finn appelle votre endpoint /lookup avec le numéro de téléphone du client, votre endpoint renvoie { "order_status": "shipped", "tracking": "1Z..."}, et le Finn l'utilise dans sa réponse : « Votre commande a été expédiée hier — le numéro de suivi se termine par... »

Pour configurer cela : dans le Workflow de votre Finn, ajoutez un nœud Action → Webhook. Configurez l'URL et les données à envoyer. La réponse devient disponible sous forme de variables de workflow.

API REST — pour un contrôle programmatique

Certaines équipes souhaitent piloter Finn depuis leur propre code — lancer des déploiements par programmation, récupérer les données d'appel dans des tableaux de bord personnalisés, etc.

Paramètres → Intégrations → Clés API → Générer une nouvelle clé. Copiez et stockez la clé en lieu sûr.

Utilisez ensuite l'API :

POST https://api.hirefinn.ai/v1/deployments
Authorization: Bearer your_api_key

{
  "finn_id": "finn_abc",
  "audience_id": "aud_xyz",
  "from_number": "+15551234567"
}

Nous proposons des SDK officiels pour Node, Python, Go et Ruby. Référence complète sur api.hirefinn.ai/docs.

Si vous n'êtes pas développeur et que cette section vous semble intimidante : vous n'en avez pas besoin. Le tableau de bord fait tout ce que fait l'API. L'API sert uniquement aux équipes qui veulent automatiser par script.

Slack — recevez des notifications dans votre messagerie d'équipe

Utile pour la visibilité des opérations — « le déploiement X est terminé, voici les chiffres » — sans obliger chacun à se connecter à Finn.

1. Paramètres → Intégrations → Slack → Ajouter à l'espace de travail.
2. Autorisez dans Slack.
3. Choisissez un canal pour les notifications.
4. Choisissez les événements à notifier :
   • Déploiement lancé
   • Déploiement terminé (avec statistiques récapitulatives)
   • Déploiement échoué
   • Récapitulatif matinal quotidien
   • Alertes de seuil (p. ex. « taux de réussite passé sous X »)

Vous pouvez connecter plusieurs canaux — différentes équipes peuvent vouloir différents types de notifications.

Zapier / Make / n8n

Pour l'automatisation no-code, utilisez l'intégration Webhook ci-dessus comme source de déclenchement dans votre outil d'automatisation préféré.

Nous travaillons aussi sur une application Zapier native — demandez un accès anticipé via Paramètres → Intégrations → Zapier.

SSO (Enterprise)

L'authentification unique permet à votre équipe de se connecter avec son identité d'entreprise existante (Okta, Azure AD, Google Workspace, etc.) au lieu de mots de passe Finn distincts.

Disponible sur les forfaits Enterprise.

• SAML 2.0 — compatible avec tous les principaux fournisseurs d'identité.
• SCIM — provisionnement automatisé des utilisateurs. Quand vous ajoutez quelqu'un au bon groupe dans votre IdP, un compte Finn lui est créé automatiquement. Quand vous le retirez, son accès est révoqué.

La configuration se fait dans Paramètres → Sécurité → SSO. Les équipes informatiques de la plupart des entreprises l'ont déjà fait — la procédure est standard.

Conformité et résidence des données

Pas vraiment une intégration, mais bon à savoir :

• GDPR — entièrement pris en charge. Droit à l'effacement, export, résidence des données dans l'UE.
• HIPAA — Entreprise uniquement, avec BAA signé.
• SOC 2 Type II — en cours de validité. Rapports d'audit disponibles sous NDA.
• Résidence des données — choisissez la région États-Unis, UE ou Inde à la création du compte. (Impossible à changer ensuite sans migration manuelle — choisissez avec soin à l'inscription.)

Plus d'informations sur hirefinn.ai/platform/security.

Questions fréquentes

Q : Puis-je synchroniser plusieurs CRM à la fois ? R : Oui. Chaque connexion CRM est indépendante. Différentes audiences peuvent se synchroniser depuis différents CRM.

Q : Mon webhook se déclenche, mais mon système ne reçoit pas les données. R : Consultez Paramètres → Intégrations → Webhooks → Journal de livraison pour voir l'erreur. Les causes les plus fréquentes : problème de certificat SSL, blocage d'IP, ou point de terminaison renvoyant un code différent de 200.

Q : J'ai déconnecté mon CRM par erreur. Ai-je perdu des données ? R : Non. La déconnexion arrête uniquement les synchronisations futures. Toutes les données d'audience existantes, l'historique des appels, etc. sont conservés. Reconnectez-vous quand vous le souhaitez.

Q : Puis-je utiliser l'API et le tableau de bord pour le même compte ? R : Oui. De nombreuses équipes utilisent l'API pour l'automatisation et le tableau de bord pour les opérations manuelles. Les deux reflètent le même état sous-jacent.

Suite

• Workflows → — utiliser les intégrations comme nœuds Action dans un Finn.
• Facturation → — quotas d'API et de webhooks par forfait.
• Conformité → — les exigences de conformité de vos intégrations.