Skip to main content

​
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

1

Allez dans Outils

Dans la barre latérale du tableau de bord, cliquez sur Outils.
2

Cliquez sur Créer un outil

Cliquez sur Créer un outil et sélectionnez HTTP comme type d’outil.
3

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)
4

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.
5

Enregistrer et attribuer

Enregistrez l’outil et attribuez-le à votre agent dans l’onglet Outils de l’agent.

​
Exemple : recherche du statut d’une commande

Un outil qui vérifie le statut d’une commande depuis votre backend : 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 :

​
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é