External Tools

Les External Tools sont des webhooks HTTP que vous configurez : l’agent vocal les appelle en temps réel pour récupérer des données ou déclencher des actions dans vos systèmes (CRM, logiciel de gestion, automatisations sur mesure).

Ce qu’ils sont

Un External Tool est une fonction qui vit sur votre serveur. yourang.ai l’enregistre comme outil disponible pour l’agent IA : quand le modèle estime que cette action est nécessaire (par exemple chercher un client dans le CRM, vérifier la disponibilité d’une chambre), il envoie une requête HTTP à l’URL que vous avez configurée.

Comment les configurer

1. 1

   Ouvrir le panneau outils de l’agent

   Allez sur /ai-agents → sélectionnez l’agent → onglet Outils → External tools.

2. 2

   Définissez nom et description

   Le nom interne (tool_name) est un identifiant technique (ex. lookup_customer). La description explique à l’IA quand utiliser l’outil : claire, concrète, centrée sur l’intention utilisateur.

3. 3

   Paramétrez le webhook

   URL HTTPS qui recevra les appels, méthode (GET/POST/PUT), schéma des paramètres (JSON Schema) que l’IA transmettra dans le payload.

4. 4

   Configurez l’authentification

   Aucune, Bearer token, API key dans un header, Basic auth ou plusieurs headers personnalisés. Les identifiants sont chiffrés au repos.

5. 5

   Testez avec un appel d’essai

   Démarrez l’agent en playground et demandez quelque chose qui devrait déclencher l’outil. Le journal d’appel montre requête, réponse et temps.

Authentification

Aucune

Endpoint public, aucun header. Déconseillé en production.

API key

Envoyée dans le header HTTP de votre choix (par ex. X-API-Key).

Bearer

Header Authorization: Bearer <token>.

Basic

Authorization: Basic <base64(user:pass)>.

Header personnalisé

Un ou plusieurs headers arbitraires (par ex. X-Tenant, X-Signature).

Quand les utiliser

• Recherche CRM. L’agent cherche un client par numéro de téléphone et personnalise la réponse avec ses données.
• Disponibilité gestion. L’agent demande au PMS s’il y a des chambres libres à une date donnée.
• Création de ticket. L’agent enregistre une réclamation comme ticket dans votre outil de support.
• Mise à jour de commande. L’agent change l’état d’une commande déjà gérée dans votre e-commerce.

Exemple de requête

{
 "phone": "+33 6 12 34 56 78",
 "call_id": "cl_abc123",
 "organization_id": "org_xyz"
}

# Réponse attendue (200 OK) :
{
 "found": true,
 "customer": {
 "name": "Marie Dupont",
 "tier": "gold",
 "last_order_date": "2026-03-12"
 }
}