--- title: "Connexions API" description: "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 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. 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. 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. 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. Les valeurs des en-têtes sont accessibles en écriture uniquement. Une fois enregistrées, elles sont chiffrées et ne sont plus jamais affichées, ni dans le dashboard ni dans l’API. Lorsque vous modifiez une connexion, un en-tête enregistré affiche son nom avec des points à la place de la valeur et la mention **Enregistré** : laissez-le tel quel pour conserver la valeur enregistrée, ou saisissez-en une nouvelle pour la remplacer. Les requêtes de test et les appels en direct utilisent la valeur enregistrée. **Cloner** copie les valeurs enregistrées vers la nouvelle connexion. Donnez aux paramètres des descriptions en langage clair (« Adresse e-mail du client, par ex. 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. 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](/fr/guides/build-an-agent)). La liste indique quels agents utilisent chaque connexion, afin de voir d’un coup d’œil ce qu’une modification affecte. ## Étapes suivantes Créez et gérez les mêmes connexions par programmation. Connexions prédéfinies pour Google, Slack, HubSpot, Salesforce et Cal.com. Exposez un serveur d’outils complet à vos agents. Chaque champ de la ressource d’intégration.