Appel API pendant la conversation
Avec l'outil Système CRM, ton agent appelle ton système pendant l'appel pour enregistrer ou consulter des données, par exemple un lead ou le statut d'une commande.
Avec l'outil Système CRM, ton agent se connecte à ton système pendant la conversation. Il demande les informations que tu définis et les envoie en HTTP à ton URL, par exemple pour créer un lead, ouvrir un ticket ou consulter le statut d'une commande. Si ton système répond avec des données, l'agent peut les communiquer à l'appelant.
Quand utiliser cet outil, quand en utiliser un autre
| Objectif | Outil |
|---|---|
| Enregistrer ou consulter des données pendant la conversation | Système CRM dans l'onglet Outils |
| Charger du contexte quand le téléphone sonne | Incoming Webhook |
| Transmettre les données de la conversation après l'appel | Ticket CRM sous Automation, voir n8n |
Créer l'outil
L'assistant te guide dans la configuration en quatre étapes.
- Modèle : ouvre Outils › Ajouter › Système CRM. Choisis un secteur, par exemple artisanat, immobilier ou assurance, ou commence avec un outil vide.
- Paramètres dynamiques : définis les informations que l'agent demande pendant la conversation. Avec Agent IA, tu décris ton cas en une phrase et tu te fais proposer les paramètres.
- Configurer l'endpoint : saisis le nom de l'outil, le texte d'attente, la description pour l'IA et l'URL. Sous Paramètres avancés, tu règles le timeout et les headers.
- Copier le modèle de prompt : bhomy génère une section pour ton prompt. Copie-la avec Copier le prompt et colle-la dans le prompt de l'onglet Personnalité.
Paramètres
Pour chaque paramètre, tu définis :
| Information | Signification |
|---|---|
| Nom | nom du champ dans le JSON envoyé, par exemple first_name |
| Type | Texte, Nombre, E-mail, Téléphone, Date, Oui/Non ou Sélection avec des options séparées par des virgules |
| Obligatoire | L'agent n'appelle l'outil que lorsque toutes les informations obligatoires sont disponibles |
| Question | comment l'agent la pose, par exemple « Quel est votre nom complet ? » |
| Description | ce qui doit figurer dans le champ |
Endpoint
| Champ | Signification |
|---|---|
| Nom de l'outil | nom sous lequel l'agent connaît l'outil, par exemple « Créer un lead » |
| Texte d'attente | phrase que l'agent prononce pendant l'appel, par exemple « J'enregistre vos coordonnées. » |
| Description (pour l'IA) | quand l'agent appelle l'outil, par exemple « Crée un nouveau lead. N'appeler que lorsque tous les champs obligatoires sont renseignés. » |
| Endpoint Webhook | méthode POST ou GET et l'URL de ton système |
| Fire-and-Forget | activé : envoi seul, la réponse n'est pas exploitée. Désactivé : l'agent reçoit la réponse et peut l'utiliser |
| Timeout (ms) | combien de temps l'agent attend la réponse |
| Headers | par exemple Authorization: Bearer … ou X-Api-Key |
L'Aperçu du corps de requête montre ce qui est envoyé. Avec POST, les paramètres partent en JSON dans le corps, avec GET comme paramètres de requête.
{
"first_name": "Anna",
"last_name": "Berger",
"phone": "+491701234567",
"request": "Devis pour une pompe à chaleur"
}
La réponse de ton système
Avec Fire-and-Forget désactivé, bhomy transmet la réponse de ton système à l'agent. Réponds avec un objet JSON qui peut être lu à voix haute :
{ "status": "expédiée", "delivery_date": "jeudi", "carrier": "DHL" }
L'agent en tire une réponse, par exemple « Votre commande a été expédiée et arrivera jeudi avec DHL. » Si ton système répond par une erreur ou trop tard, l'agent dit à l'appelant que cela n'a pas fonctionné pour le moment et propose une autre solution. Il ne mentionne ni codes de statut ni messages d'erreur.
Sécurité et rapidité
| Point | Recommandation |
|---|---|
| Authentification | Vérifie un header secret. Il n'y a pas d'adresses IP fixes |
| Rapidité | Réponds en quelques secondes. L'appelant attend pendant que ton système travaille |
| Données | Ne renvoie que ce que l'agent a le droit de dire. Tout ce qui figure dans la réponse peut être communiqué à l'appelant |
Ce que l'agent a envoyé et reçu figure dans l'historique des appels sous Main Logs.
Cette page vous a-t-elle aidé ?