> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connexions API

> Transformez n’importe quelle API HTTP en fonction que votre agent peut appeler en pleine conversation — collez une commande cURL et laissez l’assistant faire le reste.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

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.

<Tip>
  Donnez aux paramètres des descriptions en langage clair (« Adresse e-mail du client,
  par exemple [jane@example.com](mailto:jane@example.com) »). L’agent choisit les arguments à partir de ces
  descriptions en temps réel, pendant l’appel.
</Tip>

## 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](/fr/guides/build-an-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

<CardGroup cols={2}>
  <Card title="Intégrations d'outils via API" icon="code" href="/fr/guides/build-tool-integration">
    Créez et gérez les mêmes connexions par programmation.
  </Card>

  <Card title="Connecter des applications" icon="cable" href="/fr/guides/connect-apps">
    Connexions préconfigurées à Google, Slack, HubSpot, Salesforce et Cal.com.
  </Card>

  <Card title="Ajouter un serveur MCP" icon="server" href="/fr/guides/mcp-servers">
    Exposez un serveur d'outils complet à vos agents.
  </Card>

  <Card title="Référence de l'API des intégrations" icon="book" href="/api-reference/integrations">
    Chaque champ de la ressource d'intégration.
  </Card>
</CardGroup>
