Aller au contenu principal
DocumentationAPI ReferenceVideo Tutorials

Intégrations

Les intégrations enrichissent vos agents vocaux en les connectant à des services externes. Cette section couvre toutes les intégrations disponibles et comment les configurer.

Intégrations disponibles​

IntégrationObjetStatutPlans
Numéros de téléphoneNuméros de téléphone et appelsDisponibleTous
SIP TrunkUtilisez votre propre opérateur (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom)DisponibleTous — nécessite une approbation de conformité
Google CalendarPrise de rendez-vous via GoogleDisponibleTous
Outlook CalendarPrise de rendez-vous via Microsoft OutlookDisponibleTous
eTerminVérifier les disponibilités et prendre/replanifier/annuler des rendez-vous en direct — voir eTerminDisponibleTous
resmioRéserver des tables de restaurant dans votre carnet de réservation en direct — voir resmioDisponibleTous
HubSpot CRMLire/écrire des contacts et des affaires depuis votre agent vocalDisponibleTous
Serveurs MCPUtilisez votre propre serveur d'outils compatible MCP et exposez ses outils aux agents — voir Serveurs MCPDisponibleTous
Clés APIAccès pour applications externesDisponibleTous
WebhooksNotifications d'événements en temps réelDisponibleTous
Tous les plans

Les intégrations de calendrier, SIP, HubSpot, les serveurs MCP, l'accès API et les webhooks sont disponibles sur tous les plans, y compris Free. Le trunking SIP nécessite une approbation de conformité unique avant que l'assistant de connexion ne se déverrouille.

Configuration des numéros de téléphone​

Les numéros de téléphone permettent à vos agents de recevoir et de passer de vrais appels téléphoniques.

Étapes de configuration​

  1. Allez dans Numéros de téléphone dans la barre latérale
  2. Cliquez sur « Acheter un numéro »
  3. Sélectionnez le pays et le type de numéro
  4. Finalisez l'achat
  5. Assignez un agent au numéro

Les numéros sont automatiquement configurés et prêts à l'emploi après l'achat.

Intégration SIP Trunk​

Utilisez votre propre opérateur SIP — HANC parle nativement le SIP et route les appels entrants vers votre agent vocal (et les appels sortants via votre trunk). Disponible sur tous les plans, y compris Free après une approbation de conformité unique.

Opérateurs pris en charge​

HANC dispose d'adaptateurs optimisés pour les opérateurs suivants, plus une option générique pour tout le reste :

OpérateurImport auto des numéros via APINotes
sipgateOui (Personal Access Token)Trunking SIP UE
PlacetelManuelVoIP allemand, identifiants Webportal
TENIOSManuelSIP européen
easybellManuelOpérateur allemand, identifiants Kundencenter
ZadarmaOui (clé API optionnelle)Numéros mondiaux
Twilio (BYO)OuiAccount SID + Auth Token
TelnyxOuiSIP et DID pilotés par API
SIP trunk personnaliséManuelTout autre fournisseur — fournissez hôte, port, transport

Approbation de conformité​

Les connexions d'opérateurs SIP partagent le même flux de conformité que les campagnes sortantes. Tant que votre compte n'est pas approuvé, le bouton Connecter SIP ouvre une fenêtre de présentation listant tous les opérateurs pris en charge, avec un CTA mailto:support@hanc.ai. L'approbation intervient généralement le jour ouvré même.

Étapes de configuration (après approbation)​

  1. Allez dans Numéros de téléphone → Connecter SIP.
  2. Choisissez votre opérateur.
  3. Saisissez les identifiants SIP (et une clé/secret API optionnels si votre opérateur prend en charge l'import automatique).
  4. Pour le SIP personnalisé, fournissez également l'hôte, le port (5060 par défaut) et le transport (UDP / TCP / TLS).
  5. Cliquez sur Connecter — HANC enregistre votre utilisateur SIP et, lorsque c'est pris en charge, liste vos numéros de téléphone.
  6. Sélectionnez les numéros à importer (ou ajoutez-les manuellement au format E.164).
  7. Assignez un agent entrant et/ou sortant à chaque numéro.

Quand utiliser le SIP plutôt qu'acheter un numéro​

ScénarioRecommandation
Nouveau dans la téléphonieAchetez des numéros via HANC (plus simple — pas d'étape de conformité)
PBX ou contrat opérateur existantConnectez via SIP — conservez votre numéro
Téléphonie d'entreprise avec exigences strictes d'opérateurSIP pour un contrôle total
Plusieurs régions / pools de numérosSIP pour la flexibilité

Intégration Google Calendar​

Connectez Google Calendar pour permettre à vos agents vocaux de vérifier les disponibilités et de prendre des rendez-vous pendant les appels.

Étapes de configuration​

  1. Allez dans Intégration → Calendriers
  2. Cliquez sur « Connecter Google Calendar »
  3. Connectez-vous avec Google
  4. Autorisez l'accès de Hanc.AI

Permissions demandées :

  • Consulter les événements de calendrier (pour vérifier les disponibilités)
  • Créer des événements de calendrier (pour prendre des rendez-vous)

Configuration du calendrier​

Après la connexion, configurez l'outil de calendrier sur votre agent :

ParamètreDescription
calendar_idLe Google Calendar à utiliser pour la planification
timezoneFuseau horaire pour la prise de rendez-vous (par ex. Europe/Vienna)
work_hoursHeures disponibles pour la réservation (par ex. lundi-vendredi 9:00-18:00)
slot_durationDurée de rendez-vous par défaut (par ex. 30 minutes)
bufferTemps tampon entre rendez-vous (par ex. 15 minutes)

Utilisation du calendrier par les agents​

Une fois connecté et configuré, les agents peuvent :

  • Vérifier les disponibilités pour des dates et heures précises
  • Prendre des rendez-vous automatiquement
  • Respecter les heures de travail et les temps tampons
  • Gérer les demandes de replanification

Exemple de conversation :

Customer: "Can I book an appointment for Tuesday at 3pm?"

Agent: [Checks calendar]
       "Yes, Tuesday at 3pm is available.
        May I have your name to complete the booking?"

Intégration Outlook Calendar​

Connectez Microsoft Outlook Calendar pour permettre la prise de rendez-vous via vos agents vocaux.

Étapes de configuration​

  1. Allez dans Intégration → Calendriers
  2. Cliquez sur « Connecter Outlook Calendar »
  3. Connectez-vous avec votre compte Microsoft
  4. Autorisez l'accès de Hanc.AI

Permissions demandées :

  • Consulter les événements de calendrier (pour vérifier les disponibilités)
  • Créer des événements de calendrier (pour prendre des rendez-vous)

Configuration du calendrier​

Après la connexion, configurez l'outil de calendrier sur votre agent :

ParamètreDescription
CalendrierLe calendrier Outlook à utiliser pour la planification
Fuseau horaireFuseau horaire pour la prise de rendez-vous (par ex. Europe/Vienna)
Heures de travailHeures disponibles pour la réservation (par ex. lundi-vendredi 9:00-18:00)
Durée du créneauDurée de rendez-vous par défaut (par ex. 30 minutes)
MargeTemps tampon entre rendez-vous (par ex. 15 minutes)

Différences avec Google Calendar​

Les deux intégrations de calendrier fonctionnent de manière identique du point de vue de l'agent. La seule différence réside dans le processus de connexion — choisissez le service de calendrier que vous utilisez déjà.

astuce

Vous pouvez connecter les calendriers Google et Outlook en même temps, mais chaque agent ne peut utiliser qu'un seul outil de calendrier.

Annulation de rendez-vous​

Les appelants ayant pris un rendez-vous reçoivent un lien d'annulation. Ils peuvent annuler leur rendez-vous directement sans avoir à rappeler.

Prise de rendez-vous eTermin​

Connectez eTermin pour que vos agents puissent vérifier les disponibilités et prendre, replanifier ou annuler des rendez-vous en direct pendant l'appel, directement dans vos calendriers et services eTermin — avec une protection intégrée contre les doubles réservations. Utilisez eTermin plutôt qu'un simple calendrier lorsque vos rendez-vous vivent déjà dans eTermin et que vous proposez des services distincts avec leurs propres durées et règles.

Consultez la page complète eTermin pour les étapes de connexion, la configuration par agent et la protection contre les doubles réservations.

Réservations de tables resmio​

Connectez resmio pour que vos agents puissent réserver des tables de restaurant directement dans votre carnet de réservation pendant un appel — en vérifiant la disponibilité réelle par horaire et nombre de convives, et en gérant les replanifications et annulations. Utilisez resmio lorsque votre restaurant prend déjà ses réservations avec.

Consultez la page complète resmio pour les étapes de connexion et les détails.

Agir via des comptes connectés dans les workflows​

Au-delà des outils toujours actifs qu'un agent utilise pendant un appel en direct, les workflows disposent d'une étape Intégration dédiée (ajoutée en v2.8). Déposez une étape Intégration dans un workflow pour qu'il agisse via un compte Google Calendar, Outlook ou HubSpot connecté en une seule étape — par exemple, créer un événement de calendrier ou mettre à jour une affaire HubSpot dans le cadre d'un flux automatisé plus large. L'étape utilise les mêmes connexions au niveau du compte que vous configurez sur cette page, il n'y a donc rien de plus à autoriser.

Intégration HubSpot CRM​

Connectez votre espace de travail HubSpot pour que vos agents vocaux puissent lire et écrire des contacts et des affaires pendant l'appel, et pour que le CRM intégré de HANC puisse refléter vos pipelines HubSpot.

Ce que cela permet​

  • Outil en direct — HubSpot CRM dans l'onglet Actions de l'agent. L'agent peut faire correspondre l'appelant à un contact HubSpot par téléphone, récupérer l'étape de l'affaire et mettre à jour des propriétés depuis la conversation en direct. Voir Actions & Outils.
  • Miroir de pipeline dans le CRM de HANC. Vos étapes d'affaires HubSpot apparaissent dans le kanban Affaires pour que vous voyiez les appels et le contexte HubSpot côte à côte.
  • Bascule IA par pipeline — décidez sur quels pipelines HubSpot l'IA est autorisée à agir ; tout le reste reste en lecture seule.

Étapes de configuration​

  1. Ouvrez la page Intégrations et cliquez sur Connecter HubSpot.
  2. Autorisez HANC dans votre compte HubSpot.
  3. Choisissez quels pipelines doivent être reflétés (visibles dans les paramètres CRM → Pipeline) et lesquels autorisent les mises à jour d'étape par l'agent.
  4. Ajoutez l'outil HubSpot CRM à tout agent qui doit toucher à HubSpot pendant l'appel.
astuce

Vous n'êtes pas obligé d'utiliser HubSpot pour utiliser le CRM de HANC. Le CRM intégré fonctionne de manière autonome — l'intégration HubSpot sert uniquement aux organisations qui vivent déjà dans HubSpot et veulent synchroniser les deux mondes.

Serveurs MCP​

Le Model Context Protocol (MCP) est un standard ouvert pour connecter les assistants IA à des outils externes. Si vous exploitez un serveur compatible MCP, vous pouvez l'enregistrer une seule fois sur la page Intégration et laisser vos agents appeler ses outils en pleine conversation.

Étapes de configuration (aperçu)​

  1. Allez dans Intégration → Serveurs MCP.
  2. Cliquez sur Connecter un serveur MCP, saisissez un libellé et l'URL HTTPS de votre serveur, choisissez l'authentification (Aucune ou Bearer token) et enregistrez.
  3. Ouvrez l'agent qui doit utiliser les outils, allez dans Actions → Ajouter une action → Serveurs MCP, et activez les connexions que cet agent doit utiliser.

L'agent découvrira et utilisera les outils du serveur au début de chaque appel.

Consultez la page complète Serveurs MCP pour la configuration détaillée, le dépannage et la manière dont MCP s'articule avec les outils intégrés.

Clés API​

Générez des clés API pour intégrer Hanc.AI à vos propres applications.

Créer une clé API​

Vous pouvez créer jusqu'à 3 clés API par utilisateur.

  1. Allez dans Intégration → Clés API
  2. Cliquez sur « Créer une clé API »
  3. Saisissez un nom (par ex. « Intégration CRM »)
  4. Définissez les permissions (lecture, écriture, admin)
  5. Copiez la clé immédiatement (affichée une seule fois)

Sécurité des clés API​

Important
  • Stockez les clés en toute sécurité (variables d'environnement, gestionnaire de secrets)
  • Ne validez jamais de clés dans le contrôle de version
  • Effectuez une rotation périodique des clés
  • Supprimez les clés inutilisées

Utiliser les clés API​

À inclure dans les requêtes API :

curl -X GET "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

Permissions des clés API​

PermissionAccès
ReadConsulter les agents, appels, analyses
WriteCréer/modifier des agents, importer une KB
AdminToutes les opérations, suppression, paramètres

Points de terminaison disponibles​

La liste complète des points de terminaison de l'API, groupés par ressource (Appels, Agents, Base de connaissances, Numéros de téléphone, Voix, Abonnement, Clients, Espaces de travail), figure sur sa propre page :

→ Référence API complète

Webhooks​

Configurez des webhooks pour recevoir des notifications en temps réel sur les événements de votre compte Hanc.AI.

Configuration​

  1. Allez dans Intégration → Webhooks
  2. Saisissez l'URL de votre point de terminaison webhook
  3. Sélectionnez les événements auxquels vous abonner
  4. Enregistrez la configuration

Les webhooks envoient des requêtes HTTP POST à votre point de terminaison avec les données d'événement au format JSON.

Actions post-appel​

Les actions post-appel se déclenchent automatiquement une fois qu'une conversation d'agent vocal se termine. Configurez-les sur chaque agent individuellement.

Types d'actions disponibles​

ActionDescription
E-mailEnvoyer un résumé de l'appel par e-mail (au propriétaire de l'entreprise, au client, ou aux deux)
SMSEnvoyer une notification SMS après l'appel
WhatsAppEnvoyer un message WhatsApp après l'appel
Appel APIEffectuer une requête HTTP vers un point de terminaison externe avec les données de l'appel

Configuration​

  1. Allez dans Agents vocaux → sélectionnez votre agent
  2. Ouvrez l'onglet Actions
  3. Cliquez sur « Ajouter une action »
  4. Sélectionnez le type d'action et configurez :
    • Déclencheur : Quand l'action se déclenche (par ex. après chaque appel, uniquement sur des résultats précis)
    • Destinataires : Qui reçoit la notification
    • Contenu : Modèle de message avec des variables de données d'appel

Intégrations personnalisées​

Utiliser l'API​

Créez des intégrations personnalisées avec l'API Hanc.AI :

Base URL: https://api.hanc.ai/v1
Authentication: Bearer token (API key)
Format: JSON

Documentation de l'API​

Consultez la Référence API pour la liste complète des points de terminaison disponibles.

Bonnes pratiques d'intégration​

Sécurité​

  • Stockez les identifiants en toute sécurité
  • Effectuez une rotation régulière des clés API
  • Limitez les permissions au strict nécessaire

Fiabilité​

  • Journalisez tous les événements d'intégration
  • Surveillez la santé des intégrations

Tests​

  • Testez d'abord les intégrations en environnement de préproduction
  • Vérifiez le flux de données dans les deux sens
  • Testez les scénarios d'erreur
  • Documentez la configuration de l'intégration

Dépannage​

L'intégration ne se connecte pas​

  1. Vérifiez que les identifiants sont corrects
  2. Recherchez les fautes de frappe
  3. Assurez-vous que le compte tiers est actif
  4. Essayez de vous déconnecter puis de vous reconnecter

Le calendrier ne se synchronise pas​

  1. Ré-autorisez l'accès au calendrier
  2. Vérifiez les permissions du calendrier
  3. Vérifiez que le calendrier sélectionné est le bon
  4. Vérifiez les délais de synchronisation (jusqu'à 5 minutes)

Sujets connexes​