Actions & Outils

L'onglet Actions est l'endroit où vous gérez tout ce que votre agent peut faire au-delà de la conversation — les outils que l'agent appelle pendant une conversation en direct, les hooks de pré-récupération qui s'exécutent avant le démarrage de l'appel, et les actions post-appel qui se déclenchent une fois l'appel terminé. Les variables de récupération (les champs de données que l'agent extrait de chaque conversation) vivent dans le même onglet.

Tous les plans

Tous les outils, actions et le nouveau hook de pré-récupération sont disponibles sur tous les plans, y compris Free.

Les trois phases

Chaque entrée de l'onglet Actions appartient à l'une des trois phases du cycle de vie. Le menu déroulant Ajouter un outil les groupe pour que l'on voie clairement quand chaque chose se déclenche :

Phase	Quand	Exemples
Pré-récupération	Avant que l'agent dise bonjour	Rechercher l'appelant dans votre CRM par téléphone, récupérer la dernière commande, obtenir un accueil personnalisé depuis votre backend
Appel en direct	Pendant la conversation, déclenché par l'IA au bon moment	Transférer l'appel à un humain, vérifier la disponibilité du calendrier, transférer à un autre agent, interroger une API externe pour des données
Post-appel	Après la fin de l'appel	Envoyer un email de résumé, déclencher une confirmation SMS, pousser le payload d'appel vers votre CRM

Le menu s'ouvre avec Pré-récupération en haut parce que toutes les autres phases ont déjà beaucoup d'options — la nouvelle entrée de pré-récupération est la chose la plus probable que vous cherchez.

Pré-récupération

Les hooks de pré-récupération permettent à votre agent de démarrer l'appel en sachant déjà qui appelle. Ils s'exécutent en parallèle avec la mise en place de l'appel et injectent la réponse dans le system prompt de l'agent avant que le tout premier mot soit prononcé.

Quand l'utiliser

Reconnaître un client récurrent par numéro de téléphone et l'accueillir par son nom
Récupérer la commande ouverte de l'appelant, son dernier rendez-vous ou son niveau d'adhésion
Pré-charger un contexte métier qui dépend de la ligne composée
Injecter des notes CRM pour que l'agent connaisse le stade et l'historique du lead

Comment ça fonctionne

La plateforme résout le téléphone de l'appelant (depuis SIP pour l'entrant, depuis la cible composée pour le sortant).
Chaque action Pré-récupération active se déclenche en parallèle avec un timeout strict de 1,5 s par requête et un budget global de 2 s.
Les réponses réussies sont concaténées dans le system prompt de l'agent en blocs nommés — l'agent les lit dès son tout premier tour.
Les échecs sont silencieux — un endpoint lent ou cassé ne bloque jamais l'accueil. L'agent commence simplement à parler sans ce bloc.

Configuration

Champ	Description
Nom	Requis. Libellé interne et nom du bloc dans le prompt — gardez-le court et descriptif (par ex. `crm_lookup`, `vip_check`).
URL API	Requis. Endpoint à interroger. Supporte les placeholders `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}`.
Méthode HTTP	`GET` est le défaut et convient le mieux. `POST` / `PUT` / `PATCH` / `DELETE` fonctionnent aussi.
Headers	Optionnel. Statiques ou avec template (les placeholders fonctionnent aussi ici).
Paramètres de requête	Optionnel. Pré-rempli avec `phone={phone}` pour les nouvelles actions de pré-récupération.

Variables disponibles

Ces tokens sont substitués dans l'URL, les headers et les paramètres de query/body au moment de la requête :

Variable	Source	Exemple de valeur
`{phone}`	Téléphone de l'appelant (E.164) — pour le sortant, le numéro de destination	`+431234567890`
`{direction}`	`inbound` ou `outbound`	`inbound`
`{agent_id}`	ID interne de l'agent	`65f1a2b3c4...`
`{user_id}`	ID du propriétaire du workspace	`65e0b1c2d3...`
`{call_id}`	ID d'appel (permet à votre backend de corréler ultérieurement le payload post-appel)	`65f1f2c4d5...`

Les placeholders inconnus sont laissés tels quels — un mauvais templating ne plante jamais un appel.

Ce qui arrive dans le prompt

Si votre endpoint à https://crm.example.com/lookup?phone={phone} retourne :

{ "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }

Le system prompt de l'agent est complété par un bloc enveloppé en XML nommé d'après l'action :

<call_context>
  <block name="crm_lookup">
  { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }
  </block>
</call_context>

Vous n'avez pas besoin de dire à l'agent comment l'utiliser — l'IA capte naturellement le contexte. Optionnellement, mentionnez la pré-récupération dans votre system prompt : "Si <call_context> contient un nom de client, accueillez-le par son nom."

Contraintes importantes

Appels téléphoniques uniquement. La pré-récupération ne s'exécute pas pour les appels via widget (web) — il n'y a pas de numéro de téléphone à utiliser comme template.
Cap de 8 Ko sur le corps de la réponse — au-delà, le contenu est tronqué avant l'injection. Le cap protège votre budget de tokens de prompt et limite le rayon d'impact d'un endpoint malveillant.
Pas d'évaluation de condition — la pré-récupération se déclenche toujours quand active. Il n'y a pas encore de transcription à évaluer.

astuce

Utilisez GET avec un endpoint de lookup indexé par téléphone. Gardez les réponses petites et structurées (objet JSON avec 3 à 5 champs). L'agent n'a pas besoin de tout l'historique client — juste les éléments qui changent la conversation.

Outils d'appel en direct

Ceux-ci s'exécutent pendant la conversation. L'IA décide quand appeler chaque outil selon sa description et le dialogue en cours.

Outils disponibles

Outil	Objectif	Quand l'utiliser
Transfert d'appel	Transférer à un opérateur humain	Le client demande une personne, problèmes complexes
Google Calendar	Vérifier la disponibilité et prendre des rendez-vous	Le client veut planifier une réunion
Outlook Calendar	Idem, via Microsoft Outlook	Le client veut planifier une réunion
API Tool RAG	Récupérer des données en direct depuis une API externe	Besoin d'info temps réel (commandes, stock, état de compte)
Transfert d'agent	Transférer à un autre agent vocal IA	L'appelant a besoin d'un autre service ou spécialiste
HubSpot CRM	Lire/écrire contacts et deals dans HubSpot	Enregistrer l'appel dans HubSpot, chercher un lead
Serveurs MCP	Exposer les outils de l'un de vos serveurs MCP enregistrés	Vous exécutez un serveur d'outils compatible MCP et voulez que l'agent utilise ses outils en cours de conversation

Transfert d'appel

Transférez les appels à un humain lorsque des conditions spécifiques sont remplies.

Paramètre	Description	Exemple
Nom	Requis. Nom de la personne ou du service	`"Manager des ventes"`
Numéro de transfert	Numéro de téléphone par défaut vers lequel transférer	`"+49 123 456 789"`
Condition de déclenchement	Quand l'agent doit transférer	`"Le client demande un manager ou le problème ne peut pas être résolu"`
Numéros de routage conditionnel	Mapping condition-vers-numéro pour le routage	`{"billing": "+49 111 222", "technical": "+49 333 444"}`

Comment ça fonctionne :

Pendant une conversation, l'IA évalue la Condition de déclenchement.
Si des numéros de routage conditionnel sont définis, la condition correspondante détermine quel numéro appeler.
Sinon, le Numéro de transfert est utilisé.
L'agent informe l'appelant du transfert.
L'appel est transféré — sans réponse, il revient à l'agent.

astuce

Vous pouvez ajouter plusieurs outils de Transfert d'appel pour différents services — un pour « Ventes » et un autre pour « Support technique » avec différentes conditions et numéros.

Google Calendar

Connectez votre Google Calendar pour que l'agent puisse vérifier la disponibilité et prendre des rendez-vous pendant les appels.

Configuration :

Allez dans Intégration → Calendriers et connectez votre compte Google en premier.
Ajoutez l'outil Google Calendar dans l'onglet Actions de l'agent.
Sélectionnez le calendrier à utiliser.
Configurez vos paramètres de disponibilité.

Paramètre	Description	Par défaut
Calendrier	Requis. Quel calendrier utiliser	Votre calendrier principal
Fuseau horaire	Fuseau horaire pour les rendez-vous (format IANA)	Détecté automatiquement
Heure de début de travail	Début des heures de travail	9h00
Heure de fin de travail	Fin des heures de travail	18h00
Durée du créneau	Longueur du rendez-vous en minutes	30
Jours de travail	Jours de la semaine disponibles	Lundi à vendredi
Buffer entre rendez-vous	Buffer entre rendez-vous (0 à 60 min)	0

Durées de créneau supportées : 15, 30, 45, 60, 75, 90, 105, 120 minutes.

astuce

Configurez vos horaires et jours de travail avec précision — l'agent n'offrira que des créneaux dans votre disponibilité configurée.

Outlook Calendar

Connectez votre Outlook Calendar pour la prise de rendez-vous pendant les appels. Fonctionne de la même façon que Google Calendar.

Configuration :

Allez dans Intégration → Calendriers et connectez votre compte Outlook en premier.
Ajoutez l'outil Outlook Calendar dans l'onglet Actions de l'agent.
Sélectionnez le calendrier à utiliser.
Configurez vos paramètres de disponibilité.

Les paramètres sont identiques à Google Calendar (fuseau horaire, horaires de travail, durée du créneau, jours de travail, buffer).

Transfert d'agent

Transférez un appel à un autre agent vocal IA sur votre compte. Utile lorsque vous avez des agents spécialisés pour différents services.

Paramètre	Description
Agent cible	Requis. Sélectionnez à quel agent transférer
Condition de déclenchement	Quand transférer (par ex. « L'appelant demande le support technique »)

Exemple : Un agent de réception transfère les appelants à un agent commercial quand ils posent des questions sur les prix, ou à un agent de support quand ils ont un problème technique.

HubSpot CRM

Lisez et écrivez dans votre HubSpot CRM pendant l'appel. Permet à l'agent d'enregistrer les interactions, de rechercher un contact par téléphone ou de pousser des mises à jour de deal sans avoir à scripter les appels API.

Configuration :

Allez dans la page Intégrations et connectez votre compte HubSpot.
Ajoutez l'outil HubSpot CRM dans l'onglet Actions de l'agent.
Sélectionnez quel pipeline et quelles propriétés l'agent est autorisé à toucher.

Après l'ajout de l'outil, l'IA peut faire correspondre l'appelant à un contact HubSpot par téléphone, récupérer le stade du deal et mettre à jour les champs — le tout depuis la conversation en direct.

Serveurs MCP

Exposez les outils de tout serveur compatible MCP que vous avez connecté à Hanc.AI. Un agent peut tirer de plusieurs serveurs MCP ; un serveur MCP peut servir plusieurs agents.

Configuration :

Connectez vos serveur(s) MCP une fois sous Intégration → Serveurs MCP. Voir la page dédiée Serveurs MCP pour les étapes complètes d'enregistrement.
Ajoutez l'entrée Serveurs MCP à l'onglet Actions de cet agent — elle est groupée sous Appel en direct dans le menu déroulant Ajouter une action.
Activez les connexions enregistrées auxquelles cet agent doit avoir accès.
Ajoutez une courte instruction « Quand l'utiliser » pour que l'agent sache quand recourir à ces outils.

L'agent redécouvre l'ensemble d'outils de chaque serveur MCP activé au début de chaque appel, donc les changements côté serveur apparaissent automatiquement à l'appel suivant. Les outils sont renommés avec le libellé de connexion en préfixe pour que des outils nommés de manière similaire venant de serveurs différents ne se télescopent pas.

API Tool RAG

Connectez-vous à des API externes pour récupérer des informations en temps réel pendant les appels — rechercher des commandes, vérifier l'inventaire, vérifier des comptes ou accéder à toute donnée disponible via API.

Paramètre	Description	Exemple
Nom	Requis. Nom de l'outil	`"Recherche de commande"`
Description / Quand utiliser	Requis. Quand interroger l'API	`"Le client demande l'état de sa commande"`
URL API	Requis. Endpoint API. Peut inclure des tokens `{placeholder}` qui seront substitués par des valeurs du Schéma des paramètres de corps (voir ci-dessous).	`"https://api.yourshop.com/orders/{order_id}"`
Méthode HTTP	Requis. Méthode HTTP	`GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Message de chargement	Ce que dit l'agent en attendant	`"Laissez-moi vérifier cela pour vous..."`
Timeout	Temps d'attente maximum (ms)	`5000` (par défaut)
Headers	Headers HTTP statiques envoyés avec chaque requête	`{"Authorization": "Bearer KEY"}`
Paramètres de requête	Paramètres de query string statiques ajoutés à chaque requête	`{"apiVersion": "v2"}`
Schéma des paramètres de corps	Requis. JSON Schema décrivant les arguments que l'IA doit extraire de la conversation et passer à l'outil. Voir Écrire le Schéma des paramètres de corps.	Objet JSON Schema

astuce

Définissez toujours un Message de chargement — le silence pendant les appels API donne à l'appelant l'impression que c'est cassé.

remarque

L'ancienne case « Exécuter au démarrage de l'appel » sur API Tool RAG a été remplacée par l'entrée dédiée Pré-récupération. Utilisez Pré-récupération quand vous voulez les données avant le début de la conversation ; utilisez API Tool RAG quand l'agent doit décider pendant l'appel s'il faut récupérer.

Écrire le Schéma des paramètres de corps

Malgré son nom, le Schéma des paramètres de corps n'est pas un corps de requête brut. C'est un JSON Schema décrivant ce que l'IA doit extraire de la conversation et passer à votre outil. Selon la méthode HTTP et le template d'URL, ces valeurs se retrouvent dans l'URL, la query string ou le corps JSON :

Méthode HTTP	Où vont les valeurs extraites
URL contient `{name}`	La valeur correspondante est substituée dans l'URL
`GET`, `DELETE`	Les valeurs restantes sont ajoutées à l'URL en `?key=value`
`POST`, `PUT`, `PATCH`	Les valeurs restantes sont envoyées en corps JSON

Structure minimale

{
  "type": "object",
  "properties": {
    "param_name": {
      "type": "string",
      "description": "Ce que cette valeur représente et comment l'IA doit la choisir"
    }
  },
  "required": ["param_name"]
}

Le type racine est toujours "object". properties liste chaque argument. required marque ceux que l'IA doit toujours fournir — si le client ne l'a pas encore dit, l'IA demandera avant d'appeler l'outil.

Référence des champs

Champ	Objectif
`type`	Type JSON de la valeur : `"string"`, `"number"`, `"integer"`, `"boolean"`, `"array"`, `"object"`
`description`	Le plus important. Indique à l'IA ce que signifie la valeur, quel format utiliser et quand la fournir. Ajoutez des exemples chaque fois que possible.
`enum`	Restreint la valeur à l'une d'une liste fixe. L'IA fera correspondre la parole naturelle à l'option la plus proche (par ex. `"le bleu"` → `"blue"`).
`minimum`, `maximum`	Bornes numériques. L'IA refusera/clampera les valeurs hors plage.
`default`	Valeur utilisée quand l'IA ne passe pas ce champ. Pas requis, mais documente la valeur implicite.
`format`	Indice de validation, par ex. `"email"`, `"date"` (YYYY-MM-DD), `"uri"`.

Exemples

Recherche de produit (mot-clé uniquement) :

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Mot-clé de recherche produit — par ex. \"téléphone\", \"laptop\", \"Apple\", \"Samsung\""
    }
  },
  "required": ["query"]
}

Utilisé avec l'URL https://dummyjson.com/products/search?q={query}&limit=5 et GET : la valeur query va dans le placeholder de l'URL. Rien ne se retrouve dans le corps.

Recherche de commande par ID :

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "ID de commande sur lequel le client interroge, généralement 6 à 10 chiffres. Demandez au client s'il n'est pas fourni."
    }
  },
  "required": ["order_id"]
}

Utilisé avec l'URL https://api.example.com/orders/{order_id} et GET.

Réservation avec plusieurs champs requis :

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "ID de produit retourné par un précédent appel search_products."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Combien d'articles réserver. Par défaut 1."
    },
    "delivery_method": {
      "type": "string",
      "enum": ["pickup", "home_delivery", "locker"],
      "description": "Comment le client veut recevoir l'article."
    },
    "customer_email": {
      "type": "string",
      "format": "email",
      "description": "Email du client pour la confirmation de commande. Demander si non fourni."
    }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Utilisé avec POST https://api.example.com/reservations : les quatre valeurs vont dans le corps JSON. L'IA demandera au client les champs required manquants avant d'appeler l'outil.

Outil sans paramètres :

{
  "type": "object",
  "properties": {}
}

Utilisez-le quand l'endpoint est entièrement statique (par ex. GET /store/hours) et que l'IA n'a rien à passer.

Bonnes pratiques pour les agents vocaux IA

Gardez le schéma plat. Les objets et tableaux imbriqués fonctionnent, mais l'IA peut glisser en parlant au téléphone. Préférez 3 à 5 champs racine maximum.
Écrivez toujours une description pour chaque champ. Incluez des exemples (par ex. "téléphone", "laptop") — les exemples guident l'IA plus fiablement que les définitions abstraites.
Utilisez enum chaque fois que vous avez une liste fixe de valeurs. Cela retire le risque que l'IA invente des valeurs ou envoie "Electronics" au lieu de "electronics".
Ne marquez un champ required que si l'outil ne peut pas fonctionner sans. Tout le reste est optionnel, et l'IA le sautera quand le client ne l'a pas mentionné — pas de questions supplémentaires gênantes.
Utilisez des noms en snake_case et faites correspondre exactement les tokens {placeholder} dans l'URL.
Documentez le comportement pour les valeurs manquantes dans la description — par ex. "Omettre si pas de limite de budget", "Par défaut 5".

Actions post-appel

Les actions post-appel se déclenchent une fois l'appel terminé et la chaîne d'analyse a produit le résumé, le sentiment et les variables extraites. Elles consomment les données d'appel — elles ne parlent pas au client.

Actions disponibles

Action	Objectif
Envoyer Email	Envoyer par email un résumé structuré à votre équipe ou au client
Envoyer SMS	Confirmation par SMS à l'appelant
Envoyer WhatsApp	Message ou modèle WhatsApp (fonctionne à l'intérieur et à l'extérieur de la fenêtre de 24 heures)
Appel API	Pousser le payload complet de l'appel vers une API externe (CRM, webhook, votre data warehouse)

Envoyer Email

Paramètre	Description
Nom	Requis. Identifiant de l'action
Sujet	Requis. Ligne de sujet de l'email
Corps du message	Requis. Corps de l'email — peut inclure des variables de récupération
Condition de déclenchement	Quand envoyer (vide = toujours)
Destinataires	Requis. Adresses email qui reçoivent toujours l'email
Destinataires conditionnels	Mapping condition-vers-destinataire

Utiliser des variables dans l'email :

Nouveau lead depuis un appel téléphonique :

Nom : {{customer_name}}
Email : {{customer_email}}
Intéressé par : {{selected_plan}}
Notes : {{call_notes}}

Envoyer SMS

Paramètre	Description
Nom	Requis. Identifiant de l'action
Nom de l'expéditeur	Nom d'expéditeur affiché
Message	Requis. Contenu du SMS (peut inclure des variables)
Condition de déclenchement	Quand envoyer
Destinataires	Requis. Numéros de téléphone qui reçoivent toujours le SMS
Destinataires conditionnels	Mapping condition-vers-numéro

Envoyer WhatsApp

La messagerie WhatsApp sur HANC utilise des modèles préapprouvés depuis un compte Twilio Content central — vous ne collez pas un Template SID à la main. L'éditeur d'action affiche un menu déroulant de chaque modèle actuellement actif et approuvé, et vous en choisissez un. Les placeholders à l'intérieur du modèle ({{1}}, {{2}}, …) sont ensuite remplis en ligne depuis les variables d'appel ou du texte statique que vous mappez dans l'éditeur.

Paramètre	Description
Nom	Requis. Identifiant de l'action
Condition de déclenchement	Quand envoyer
Destinataires	Requis. Numéros de téléphone qui reçoivent toujours le message
Destinataires conditionnels	Mapping condition-vers-numéro
Modèle	Requis. Sélecteur déroulant de modèles WhatsApp préapprouvés synchronisés depuis le compte Twilio Content central. Chaque entrée affiche le nom du modèle, la langue et un aperçu du corps pour que vous sachiez lequel choisir.
Variables du modèle	Pour le modèle choisi, l'éditeur liste chaque placeholder (`{{1}}`, `{{2}}`, …) et vous permet de le mapper à une variable d'appel (voir ci-dessous) ou à une chaîne statique.

Variables d'appel disponibles que vous pouvez mapper dans les placeholders du modèle :

Variable	Description
`{{call_from}}`	Numéro de téléphone de l'appelant
`{{call_to}}`	Numéro qui a été appelé
`{{call_summary}}`	Résumé d'appel généré par l'IA
`{{call_sentiment}}`	Sentiment (positif/neutre/négatif)
`{{call_task_achieved}}`	Si la tâche de l'appel a été accomplie
`{{call_transcription}}`	Transcription complète de l'appel

Pourquoi un sélecteur et non du texte libre

WhatsApp exige que chaque message initié par l'entreprise hors de la fenêtre de service client de 24 heures utilise un modèle préapprouvé. HANC synchronise la liste des modèles approuvés depuis le compte Twilio Content partagé, donc le menu déroulant affiche toujours exactement ce qui est éligible à être envoyé maintenant — vous ne pouvez pas accidentellement choisir un brouillon, un modèle rejeté ou un SID inexistant. Pour ajouter un nouveau modèle, contactez le support ; une fois approuvé par WhatsApp, il apparaît automatiquement dans le menu déroulant.

Appel API

L'action post-appel Appel API est votre webhook générique vers le reste de votre stack. Choisissez la méthode, définissez l'URL, et nous enverrons le payload complet de l'appel — votre endpoint reçoit un objet JSON structuré décrivant ce qui s'est passé.

Paramètre	Description
Nom	Requis. Identifiant de l'action
Condition de déclenchement	Quand déclencher (vide = chaque appel). Évalué par une IA contre la transcription.
URL API	Requis. URL d'endpoint API
Méthode HTTP	Requis. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Headers	Headers de requête optionnels
Paramètres de requête	Paramètres de query string optionnels

Ce que reçoit votre endpoint

Pour POST / PUT / PATCH, votre endpoint obtient un objet JSON dans le corps de la requête. Vos paramètres de corps configurés sont fusionnés avec le payload complet de l'appel :

{
  "call_from": "+431234567890",
  "call_to":   "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "ended",
  "start_timestamp": 1730000000000,
  "end_timestamp":   1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user",  "content": "Hi…",    "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": {
    "name": "John",
    "email": "john@example.com"
  },
  "collected_data": { /* in-call form submissions */ },
  "transfer_history": [ /* if any agent transfer happened */ ],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Pour GET / DELETE, les mêmes champs sont aplatis dans la query string — mais les valeurs imbriquées comme transcription, sentiment et custom_analysis_data sont supprimées (les URLs ne peuvent pas porter raisonnablement des données structurées). Utilisez POST/PUT/PATCH si vous avez besoin de la transcription.

Chaque requête reçoit aussi un header X-Correlation-Id pour le traçage, et expire après 30 secondes.

Pré-récupération vs Appel API post-appel

Pré-récupération template {phone} etc. dans URL/headers/query/body. Retourne dans le prompt, avant l'appel.
Appel API post-appel envoie le dump complet de l'appel dans le corps ou la query. Pas de templating d'URL — votre endpoint reçoit une URL statique + un corps dynamique.

Variables de récupération

Les variables de récupération sont des champs de données personnalisés que l'IA extrait automatiquement des conversations. Par exemple, l'agent peut capturer le nom, l'email, le numéro de téléphone de l'appelant ou toute autre information que vous définissez.

Variables par défaut

Chaque nouvel agent est créé avec deux variables de récupération par défaut :

Variable	Type	Description
Email	Email	Adresse email de l'appelant
Téléphone	Téléphone	Numéro de téléphone de l'appelant

Elles sont activées par défaut et affichées dans le formulaire du widget d'appel. Vous pouvez les modifier ou les supprimer, et ajouter vos propres variables personnalisées.

Types de variables

Type	Cas d'usage	Exemple
Texte	Noms, adresses, notes, saisie libre	Nom du client, adresse de livraison
Nombre	Quantités, budgets, identifiants	Quantité de commande, montant du budget
Email	Adresses email avec validation	Email client
Téléphone	Numéros de téléphone avec validation	Numéro de téléphone client
Sélecteur	Choix parmi des options prédéfinies	Plan préféré (Basic/Pro/Enterprise)
Case à cocher	Consentement ou confirmation oui/non	« J'accepte de recevoir des emails marketing »

Configurer une variable

Champ	Description	Exemple
Nom de la variable	Requis. Identifiant de la variable	`customer_email`
Instructions pour l'IA	Requis. Instructions pour l'IA sur quand et comment extraire cette valeur	`"L'adresse email du client. Demander si non fournie."`
Exemple de format	(Optionnel) Exemple du format attendu	`"john@example.com"`
Options (pour Sélecteur)	(Sélecteur uniquement) Liste des options autorisées	`["Basic", "Pro", "Enterprise"]`
Afficher dans le formulaire	Si afficher ce champ dans le formulaire du widget d'appel	Activé par défaut

Afficher dans le formulaire

Lorsque Afficher dans le formulaire est activé, la variable apparaît comme un champ de saisie visible dans le widget web avant et pendant l'appel. Cela permet aux appelants de remplir leurs informations directement, en plus de l'extraction par l'IA depuis la conversation.

astuce

L'IA demandera naturellement les informations manquantes pendant la conversation. Définissez une description claire comme « Adresse email du client, demander poliment si non fournie » et l'agent s'en chargera.

Ajouter des outils & actions

Naviguez vers l'onglet Actions de votre agent.
Cliquez sur Ajouter un outil.
Choisissez la bonne phase dans le menu déroulant — Pré-récupération, Appel en direct ou Post-appel.
Configurez les paramètres.
Enregistrez — les changements s'appliquent à l'appel suivant.

Toutes les entrées sont listées ensemble dans le tableau Actions. Cliquez sur n'importe quelle ligne pour modifier, ou utilisez l'icône corbeille pour supprimer.

Voir aussi

Vue d'ensemble des agents vocaux IA
Prompt Engineering — Référencer les outils dans votre prompt
Base de connaissances — Sources d'information
Intégrations — Systèmes externes avec lesquels vos outils peuvent dialoguer

Les trois phases​

Pré-récupération​

Quand l'utiliser​

Comment ça fonctionne​

Configuration​

Variables disponibles​

Ce qui arrive dans le prompt​

Contraintes importantes​

Outils d'appel en direct​

Outils disponibles​

Transfert d'appel​

Google Calendar​

Outlook Calendar​

Transfert d'agent​

HubSpot CRM​

Serveurs MCP​

API Tool RAG​

Écrire le Schéma des paramètres de corps​

Structure minimale​

Référence des champs​

Exemples​

Bonnes pratiques pour les agents vocaux IA​

Actions post-appel​

Actions disponibles​

Envoyer Email​

Envoyer SMS​

Envoyer WhatsApp​

Appel API​

Ce que reçoit votre endpoint​

Variables de récupération​

Variables par défaut​

Types de variables​

Configurer une variable​

Afficher dans le formulaire​

Ajouter des outils & actions​

Voir aussi​

Les trois phases

Pré-récupération

Quand l'utiliser

Comment ça fonctionne

Configuration

Variables disponibles

Ce qui arrive dans le prompt

Contraintes importantes

Outils d'appel en direct

Outils disponibles

Transfert d'appel

Google Calendar

Outlook Calendar

Transfert d'agent

HubSpot CRM

Serveurs MCP

API Tool RAG

Écrire le Schéma des paramètres de corps

Structure minimale

Référence des champs

Exemples

Bonnes pratiques pour les agents vocaux IA

Actions post-appel

Actions disponibles

Envoyer Email

Envoyer SMS

Envoyer WhatsApp

Appel API

Ce que reçoit votre endpoint

Variables de récupération

Variables par défaut

Types de variables

Configurer une variable

Afficher dans le formulaire

Ajouter des outils & actions

Voir aussi