Connect tools & data

Connexions API

Transformez n’importe quelle API HTTP en fonction que votre agent peut appeler en pleine conversation : collez une commande cURL et l’assistant crée la définition de l’outil, les paramètres et l’authentification.

Les connexions API sont des fonctions HTTP personnalisées que vos agents peuvent appeler pendant une conversation — rechercher une commande, créer un ticket, récupérer l’état d’un compte depuis votre propre backend. Vous définissez le point de terminaison une fois dans Connexions → API (/dashboard/api-connections) ; les agents auxquels la connexion est associée peuvent ensuite l’appeler chaque fois que la conversation l’exige.

Il existe deux façons d’en créer une : coller un élément que l’assistant peut analyser, ou configurer la connexion manuellement.

La méthode rapide : coller et analyser#

1. Cliquez sur Nouvelle connexion API

   La boîte de dialogue s’ouvre sur l’assistant. Collez un exemple de commande cURL, de spécification OpenAPI/Swagger, d’export Postman, d’interface TypeScript ou de schéma Zod dans le champ.

2. Cliquez sur Analyser

   ThunderPhone déduit l’intégralité de la connexion à partir de votre contenu — URL, méthode, en-têtes et schéma de paramètres dérivé des paramètres de requête et du corps de requête détectés. Les en-têtes que vous avez collés (y compris les en-têtes d’authentification) sont repris dans la configuration du point de terminaison.

3. Confirmez les champs surlignés

   La configuration déduite s’ouvre avec les champs estimés surlignés pour vérification. Ajustez les noms, descriptions et types de paramètres afin que l’agent comprenne quand et comment appeler la fonction — la description est ce que le modèle lit.

4. Valider et enregistrer

   L’enregistrement lance d’abord une requête de test en direct vers votre point de terminaison. Si la requête échoue, la connexion n’est pas enregistrée — corrigez l’URL, les en-têtes d’authentification ou le corps, puis réessayez. En cas de réussite, la connexion est enregistrée avec le badge Validée.

Si l’assistant ne trouve pas d’URL de requête dans votre contenu, il vous l’indiquera — incluez un point de terminaison http(s) complet et réessayez.

Configuration manuelle#

Cliquez sur Configurer manuellement → dans l’assistant (ou sur Vous voulez que l’IA le déduise ? Essayez l’assistant → pour revenir en arrière). Le générateur manuel comporte deux éditeurs :

• Visuel — champs de formulaire pour le nom d’affichage, le nom de fonction, l’ URL, la méthode (POST, GET, PUT, PATCH, DELETE), les en-têtes personnalisés et le schéma de paramètres (Ajouter une propriété pour chaque argument que l’agent peut fournir).
• JSON — la même définition au format JSON brut, pour coller ou affiner directement une spécification d’outil.

Un panneau Tester la requête (facultatif) vous permet d’exécuter la requête configurée avant l’enregistrement et affiche le statut, la latence et un aperçu de la réponse. Valider et enregistrer exécute toujours ce test et enregistre uniquement en cas de réussite.

Gérer vos connexions#

Chaque ligne de connexion affiche son statut de validation — Validée, Non testée ou Erreur — son nom de fonction et les agents qui l’utilisent. Depuis le menu d’actions de la ligne, vous pouvez :

• Modifier — rouvrir la configuration.
• Cloner — la dupliquer comme point de départ (la copie est initialement Non testée).
• Historique des révisions — afficher les versions précédentes et en restaurer une dans l’ éditeur.
• Transférer — copier ou déplacer la connexion vers une autre organisation à laquelle vous appartenez. Le déplacement la supprime ici ; les agents qui l’utilisaient peuvent nécessiter une reconfiguration.
• Supprimer — définitif ; les agents utilisant la connexion devront être reconfigurés.

L’associer à un agent#

Ajoutez la connexion à un agent dans la section des connexions API du générateur (Créer un agent). La liste indique quels agents utilisent chaque connexion, afin de voir d’un coup d’œil ce qu’une modification affecte.

Étapes suivantes#