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

# Outils HTTP

> Créez des outils personnalisés qui appellent n'importe quel point de terminaison d'API

## Vue d'ensemble

Les outils HTTP permettent à votre agent d'appeler n'importe quelle API REST pendant une conversation. Utilisez-les pour vous connecter à votre propre backend, déclencher des webhooks ou interagir avec des services qui n'ont pas d'intégration prédéfinie.

## Quand utiliser les outils HTTP

* Appeler votre propre API pour rechercher le statut d'une commande, des informations de compte, etc.
* Déclencher des automatisations dans Make, Zapier ou n8n via des webhooks
* Vous connecter à n'importe quelle API tierce disposant d'un point de terminaison REST
* Envoyer des données vers votre backend lorsque certains événements se produisent dans une conversation

## Créer un outil HTTP

<Steps>
  <Step title="Allez dans Outils">
    Dans la barre latérale du tableau de bord, cliquez sur **Outils**.
  </Step>

  <Step title="Cliquez sur Créer un outil">
    Cliquez sur **Créer un outil** et sélectionnez **HTTP** comme type d'outil.
  </Step>

  <Step title="Configurez la requête">
    Configurez la requête HTTP :

    * **Nom** — Un nom descriptif (par ex. « Vérifier le statut de la commande »)
    * **Description** — Indiquez à l'agent quand utiliser cet outil (par ex. « Utiliser ceci lorsque l'appelant demande le statut de sa commande »)
    * **Méthode** — GET, POST, PUT, PATCH ou DELETE
    * **URL** — Le point de terminaison de l'API à appeler
    * **En-têtes** — Tous les en-têtes requis (Authorization, Content-Type, etc.)
    * **Corps** — Modèle du corps de la requête (pour POST/PUT/PATCH)
  </Step>

  <Step title="Définissez les paramètres">
    Définissez les paramètres que l'agent doit extraire de la conversation et transmettre à l'API. Par exemple :

    * `order_id` — « Le numéro de commande du client »
    * `email` — « L'adresse e-mail du client »

    L'agent demandera ces valeurs à l'appelant si elles n'ont pas déjà été mentionnées dans la conversation.
  </Step>

  <Step title="Enregistrer et attribuer">
    Enregistrez l'outil et attribuez-le à votre agent dans l'onglet **Outils** de l'agent.
  </Step>
</Steps>

## Exemple : recherche du statut d'une commande

Un outil qui vérifie le statut d'une commande depuis votre backend :

| Paramètre   | Valeur                                                     |
| ----------- | ---------------------------------------------------------- |
| Nom         | Vérifier le statut de la commande                          |
| Description | Utiliser quand l'appelant demande le statut de sa commande |
| Méthode     | GET                                                        |
| URL         | `https://api.yourcompany.com/orders/{order_id}`            |
| Paramètres  | `order_id` — Le numéro de commande du client               |

Lorsqu'un appelant dit « Je voudrais vérifier le statut de ma commande, c'est la #12345 », l'agent extrait l'ID de commande, appelle votre API et lit le statut à voix haute.

## Exemple : déclencheur de webhook

Un outil qui déclenche une automatisation Make/Zapier :

| Paramètre   | Valeur                                                               |
| ----------- | -------------------------------------------------------------------- |
| Nom         | Soumettre un lead                                                    |
| Description | Utiliser quand l'appelant souhaite être contacté par les ventes      |
| Méthode     | POST                                                                 |
| URL         | `https://hook.make.com/your-webhook-id`                              |
| Corps       | `{ "name": "{name}", "phone": "{phone}", "interest": "{interest}" }` |
| Paramètres  | `name`, `phone`, `interest`                                          |

## Conseils

* Rédigez des descriptions claires pour que l'agent sache exactement quand utiliser l'outil
* Gardez des noms de paramètres simples et descriptifs
* Testez avec le bouton **Parler à l'agent** avant la mise en production
* Utilisez des points de terminaison HTTPS pour la sécurité