Intégrations
Les intégrations étendent vos agents vocaux en les connectant à des services externes. Cette section couvre toutes les intégrations disponibles et leur configuration.
Intégrations disponibles
| Intégration | Objectif | Statut | Plans |
|---|---|---|---|
| Numéros de téléphone | Numéros et appels | Disponible | Tous |
| Trunk SIP | Apportez votre opérateur (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, personnalisé) | Disponible | Tous — nécessite approbation conformité |
| Google Calendar | Prise de rendez-vous via Google | Disponible | Tous |
| Outlook Calendar | Prise de rendez-vous via Microsoft Outlook | Disponible | Tous |
| HubSpot CRM | Lire/écrire des contacts et deals depuis votre agent vocal | Disponible | Tous |
| Serveurs MCP | Apportez votre serveur d'outils compatible MCP et exposez ses outils aux agents — voir Serveurs MCP | Disponible | Tous |
| Clés API | Accès depuis vos applications externes | Disponible | Tous |
| Webhooks | Notifications d'événements en temps réel | Disponible | Tous |
Les intégrations calendrier, SIP, HubSpot, serveurs MCP, accès API et webhooks sont disponibles sur tous les plans, y compris Free. Le trunking SIP nécessite une approbation conformité unique avant que l'assistant de connexion ne se débloque.
Configuration de numéro de téléphone
Les numéros de téléphone permettent à vos agents de recevoir et passer de vrais appels.
Étapes de configuration
- Allez dans Numéros de téléphone dans la barre latérale
- Cliquez sur « Acheter un numéro »
- Sélectionnez le pays et le type de numéro
- Finalisez l'achat
- Attribuez un agent au numéro
Les numéros sont configurés automatiquement et prêts à l'emploi après achat.
Intégration trunk SIP
Apportez votre propre opérateur SIP — HANC parle SIP nativement et route les appels entrants vers votre agent vocal (et les appels sortants à travers votre trunk). Disponible sur tous les plans y compris Free après une approbation conformité unique.
Opérateurs pris en charge
HANC a des adaptateurs réglés pour les opérateurs suivants, plus une option générique pour tout autre :
| Opérateur | Auto-import des numéros via API | Notes |
|---|---|---|
| sipgate | Oui (Personal Access Token) | Trunking SIP UE |
| Placetel | Manuel | VoIP allemand, identifiants Webportal |
| TENIOS | Manuel | SIP européen |
| easybell | Manuel | Opérateur allemand, identifiants Kundencenter |
| Zadarma | Oui (clé API optionnelle) | Numéros mondiaux |
| Twilio (BYO) | Oui | Account SID + Auth Token |
| Telnyx | Oui | SIP et DIDs pilotés par API |
| Trunk SIP personnalisé | Manuel | Tout autre fournisseur — fournissez hôte, port, transport |
Approbation conformité
Les connexions d'opérateur 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 est généralement dans la journée ouvrée.
Étapes de configuration (après approbation)
- Allez dans Numéros de téléphone → Connecter SIP.
- Choisissez votre opérateur.
- Saisissez les identifiants SIP (et clé API/secret optionnelle si votre opérateur prend en charge l'auto-import).
- Pour SIP personnalisé, fournissez aussi hôte, port (par défaut 5060) et transport (UDP / TCP / TLS).
- Cliquez sur Connecter — HANC enregistre votre utilisateur SIP et, lorsque pris en charge, liste vos numéros.
- Sélectionnez les numéros à importer (ou ajoutez manuellement par E.164).
- Attribuez un agent entrant et/ou sortant sur chaque numéro.
Quand utiliser SIP vs. acheter un numéro
| Scénario | Recommandation |
|---|---|
| Nouveau service téléphonique | Achetez les numéros via HANC (plus simple — pas d'étape de conformité) |
| PBX existant ou contrat opérateur | Connectez via SIP — gardez votre numéro |
| Téléphonie d'entreprise avec exigences opérateur strictes | SIP pour le contrôle complet |
| Plusieurs régions / pools de numéros | SIP pour la flexibilité |
Intégration Google Calendar
Connectez Google Calendar pour permettre à vos agents vocaux de vérifier les disponibilités et prendre des rendez-vous pendant les appels.
Étapes de configuration
- Allez dans Intégration → Calendriers
- Cliquez sur « Connecter Google Calendar »
- Connectez-vous avec Google
- Autorisez l'accès Hanc.AI
Permissions demandées :
- Voir les événements du calendrier (pour vérifier la disponibilité)
- Créer des événements (pour prendre des rendez-vous)
Configuration du calendrier
Après connexion, configurez l'outil calendrier sur votre agent :
| Paramètre | Description |
|---|---|
| calendar_id | Quel Google Calendar utiliser pour la planification |
| timezone | Fuseau horaire pour la planification (par ex. Europe/Vienna) |
| work_hours | Heures disponibles pour la réservation (par ex. lun-ven 9h00-18h00) |
| slot_duration | Longueur de rendez-vous par défaut (par ex. 30 minutes) |
| buffer | Temps tampon entre les rendez-vous (par ex. 15 minutes) |
Utilisation du calendrier dans les agents
Une fois connecté et configuré, les agents peuvent :
- Vérifier la disponibilité pour des dates et heures spécifiques
- Prendre automatiquement des rendez-vous
- Respecter les heures de travail et les temps tampons
- Gérer les demandes de reprogrammation
Exemple de conversation :
Client : « Puis-je prendre un rendez-vous mardi à 15h ? »
Agent : [Vérifie le calendrier]
« Oui, mardi à 15h est disponible.
Puis-je avoir votre nom pour finaliser la réservation ? »
Intégration Outlook Calendar
Connectez Microsoft Outlook Calendar pour permettre la prise de rendez-vous via vos agents vocaux.
Étapes de configuration
- Allez dans Intégration → Calendriers
- Cliquez sur « Connecter Outlook Calendar »
- Connectez-vous avec votre compte Microsoft
- Autorisez l'accès Hanc.AI
Permissions demandées :
- Voir les événements du calendrier (pour vérifier la disponibilité)
- Créer des événements (pour prendre des rendez-vous)
Configuration du calendrier
Après connexion, configurez l'outil calendrier sur votre agent :
| Paramètre | Description |
|---|---|
| Calendrier | Quel calendrier Outlook utiliser pour la planification |
| Fuseau horaire | Fuseau horaire pour la planification (par ex. Europe/Vienna) |
| Heures de travail | Heures disponibles pour la réservation (par ex. lun-ven 9h00-18h00) |
| Durée du créneau | Longueur de rendez-vous par défaut (par ex. 30 minutes) |
| Tampon | Temps tampon entre les rendez-vous (par ex. 15 minutes) |
Différences par rapport à Google Calendar
Les deux intégrations calendrier fonctionnent de manière identique du point de vue de l'agent. La seule différence est le processus de connexion — choisissez le service de calendrier que vous utilisez déjà.
Vous pouvez connecter Google et Outlook en même temps, mais chaque agent ne peut utiliser qu'un seul outil calendrier.
Annulation de rendez-vous
Les appelants qui ont réservé un rendez-vous reçoivent un lien d'annulation. Ils peuvent annuler leur rendez-vous directement sans avoir à rappeler.
Intégration HubSpot CRM
Connectez votre espace HubSpot pour que vos agents vocaux puissent lire et écrire des contacts et deals pendant l'appel, et pour que le CRM intégré de HANC puisse mirrorer vos pipelines HubSpot.
Ce qu'elle active
- Outil en direct —
HubSpot CRMdans l'onglet Actions de l'agent. L'agent peut matcher l'appelant à un contact HubSpot par téléphone, récupérer le stage de deal et mettre à jour des propriétés depuis la conversation en direct. Voir Actions et outils. - Mirroring de pipeline dans le CRM HANC. Vos étapes de deal HubSpot apparaissent dans le kanban Deals pour voir les appels et le contexte HubSpot côte à côte.
- Toggle 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
- Ouvrez la page Intégrations et cliquez sur Connecter HubSpot.
- Autorisez HANC dans votre compte HubSpot.
- Choisissez quels pipelines doivent être mirrorés (visibles dans CRM → Paramètres Pipeline) et lesquels doivent autoriser les mises à jour d'étape par l'agent.
- Ajoutez l'outil HubSpot CRM à tout agent qui doit toucher HubSpot pendant l'appel.
Vous n'avez pas à utiliser HubSpot pour utiliser le CRM de HANC. Le CRM intégré fonctionne en autonome — l'intégration HubSpot est purement pour les organisations qui vivent déjà dans HubSpot et veulent les deux mondes synchronisés.
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 fois sur la page Intégration et faire en sorte que vos agents appellent ses outils en cours de conversation.
Étapes de configuration (vue d'ensemble)
- Allez dans Intégration → Serveurs MCP.
- 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.
- Ouvrez l'agent qui doit utiliser les outils, allez dans Actions → Ajouter une action → Serveurs MCP, et activez les connexions à utiliser pour cet agent.
L'agent découvrira et utilisera les outils du serveur au début de chaque appel.
Voir la page complète Serveurs MCP pour la configuration détaillée, le dépannage et comment MCP s'intègre aux outils embarqué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.
- Allez dans Intégration → Clés API
- Cliquez sur « Créer une clé API »
- Saisissez un nom (par ex. « Intégration CRM »)
- Définissez les permissions (lecture, écriture, admin)
- Copiez la clé immédiatement (affichée une seule fois)
Sécurité des clés API
- Stockez les clés de manière sécurisée (variables d'environnement, gestionnaire de secrets)
- Ne commitez jamais de clés dans le contrôle de version
- Faites tourner les clés périodiquement
- Supprimez les clés inutilisées
Utiliser les clés API
Incluez 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
| Permission | Accès |
|---|---|
| Lecture | Voir les agents, appels, analytique |
| Écriture | Créer/modifier les agents, importer BC |
| Admin | Toutes les opérations, suppression, paramètres |
Endpoints disponibles
La liste complète des endpoints API, groupés par ressource (Appels, Agents, Base de connaissances, Numéros de téléphone, Voix, Abonnement, Clients, Espaces de travail) vit sur sa propre page :
Webhooks
Configurez des webhooks pour recevoir des notifications en temps réel sur les événements de votre compte Hanc.AI.
Configuration
- Allez dans Intégration → Webhooks
- Saisissez l'URL de votre endpoint webhook
- Sélectionnez les événements à souscrire
- Enregistrez la configuration
Les webhooks envoient des requêtes HTTP POST à votre endpoint avec les données d'événement au format JSON.
Actions post-appel
Les actions post-appel se déclenchent automatiquement après la fin d'une conversation. Configurez-les sur les agents individuels.
Types d'action disponibles
| Action | Description |
|---|---|
| Envoyer un résumé d'appel par e-mail (au dirigeant, au client ou les deux) | |
| SMS | Envoyer une notification SMS après l'appel |
| Envoyer un message WhatsApp après l'appel | |
| Appel API | Faire une requête HTTP vers un endpoint externe avec les données de l'appel |
Configuration
- Allez dans Agents vocaux → sélectionnez votre agent
- Ouvrez l'onglet Actions
- Cliquez sur « Ajouter une action »
- Sélectionnez le type d'action et configurez :
- Déclencheur : Quand l'action se déclenche (par ex. après chaque appel, uniquement sur certains résultats)
- Destinataires : Qui reçoit la notification
- Contenu : Modèle de message avec variables de données d'appel
Intégrations personnalisées
Utiliser l'API
Construisez des intégrations personnalisées avec l'API Hanc.AI :
URL de base : https://api.hanc.ai/v1
Authentification : Bearer token (clé API)
Format : JSON
Documentation API
Voir la Référence API pour la liste complète des endpoints disponibles.
Bonnes pratiques d'intégration
Sécurité
- Stockez les identifiants de manière sécurisée
- Faites tourner les clés API régulièrement
- Limitez les permissions au minimum nécessaire
Fiabilité
- Loggez tous les événements d'intégration
- Surveillez la santé des intégrations
Tests
- Testez les intégrations d'abord en staging
- Vérifiez le flux de données dans les deux sens
- Testez les scénarios d'erreur
- Documentez la configuration d'intégration
Dépannage
L'intégration ne se connecte pas
- Vérifiez que les identifiants sont corrects
- Cherchez les fautes de frappe
- Assurez-vous que le compte tiers est actif
- Essayez de déconnecter et reconnecter
Le calendrier ne se synchronise pas
- Ré-autorisez l'accès au calendrier
- Vérifiez les permissions du calendrier
- Vérifiez que le calendrier sélectionné est correct
- Vérifiez les retards de synchronisation (jusqu'à 5 minutes)
Sujets connexes
- Numéros de téléphone — Gestion des numéros de téléphone
- Agents vocaux — Utiliser les intégrations dans les agents
- Analytique — Suivi des événements d'intégration