Skip to main content
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 le statut d’un compte depuis votre propre backend. Définissez le point de terminaison une seule fois dans Connexions → API (/dashboard/api-connections) ; les agents auxquels la connexion est associée peuvent ensuite l’appeler dès que la conversation le nécessite. 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’ensemble 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 mis en évidence

La configuration déduite s’ouvre avec les champs estimés mis en évidence 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 lit le modèle.
4

Valider et enregistrer

L’enregistrement exécute 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 de requête, 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 ajuster précisément une spécification d’outil directement.
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 n’enregistre qu’en cas de réussite.
Donnez aux paramètres des descriptions en langage clair (« Adresse e-mail du client, par exemple jane@example.com »). L’agent choisit les arguments à partir de ces descriptions en temps réel, pendant l’appel.

​
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. Dans 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. Son 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 que vous puissiez voir d’un coup d’œil ce qu’une modification affecte.

​
Étapes suivantes

Intégrations d'outils via API

Créez et gérez les mêmes connexions par programmation.

Connecter des applications

Connexions préconfigurées à Google, Slack, HubSpot, Salesforce et Cal.com.

Ajouter un serveur MCP

Exposez un serveur d’outils complet à vos agents.

Référence de l'API des intégrations

Chaque champ de la ressource d’intégration.