Action de l'Agent IA : Make HTTP requests

Éligibilité du forfait : Disponible sur les forfaits Advanced, Enterprise et certains forfaits Legacy. Les tests sont disponibles pour tous les utilisateurs, mais la publication nécessite un forfait éligible.

L'action Make HTTP requests permet à ton Agent IA d'appeler des API externes pendant une conversation. Cela permet à ton Agent IA de récupérer des données en temps réel ou de déclencher des actions dans des systèmes externes en fonction de la demande du Contact. Par exemple, il peut vérifier le statut d'une commande, récupérer les informations de compte ou créer des enregistrements dans un autre système. Dans cet article, tu apprendras comment configurer l'action de requête HTTP et la tester avec ton Agent IA.

L'Agent IA :

1. Analyse le message du Contact pour déterminer s'il correspond à l'intention définie dans les instructions de ton action.

2. Collecte les informations requises.

3. Envoie la requête HTTP.

4. Interprète la réponse de l'API.

5. Répond naturellement au Contact.

Ajoute une action Make HTTP requests

Active l'action et clique sur le bouton « Ajouter une action » pour commencer à configurer ta requête HTTP.

Définis quand l'action doit s'exécuter

Donne un nom descriptif à l'action dans le champ Nom de l'action.

Dans le champ Quand et comment cette action doit-elle être effectuée ? champ, décris :

• Quand ton Agent IA doit utiliser cette action

• Ce qu'il récupère ou envoie

• Toute condition ou résultat à gérer

Exemple :

Utilise cette action pour récupérer le statut de commande d'un Contact lorsqu'il demande des informations sur sa commande. Si l'API renvoie une erreur 404, informe le Contact que la commande n'a pas été trouvée.

Ton Agent IA utilise cette description pour décider quand déclencher la requête.

Informations dont ton Agent IA peut avoir besoin (facultatif)

Définis ici les entrées requises avant d'appeler ton API.

Ce sont des variables structurées que ton Agent IA doit collecter. La requête n'est déclenchée qu'une fois que toutes les entrées requises sont disponibles.

Si une valeur est :

• Déjà mentionnée dans la conversation → ton Agent IA l'utilise.

• Manquante → ton Agent IA demande au Contact de la fournir.

Les variables créées ici peuvent être utilisées dans la configuration de l'API. Les variables de Contact (comme $contact.email) sont disponibles automatiquement et n'ont pas besoin d'être ajoutées.

Paramètres du champ

Configuration de l'API

Définis comment ton Agent IA doit appeler ton API.

Tu peux configurer :

• Méthode

• URL

• Paramètres de requête

• En-têtes

• Corps JSON (pour POST, PUT, PATCH)

Référence des variables

Tu peux insérer des variables dans l'URL, les paramètres, les en-têtes ou le corps en utilisant $.

Il existe deux types :

• Variables de contact — champs de contact existants

  • $contact.email

• Variables de l'Agent IA — champs définis dans Informations dont ton Agent IA peut avoir besoin

  • $agent.order_id

Les variables sont remplacées par des valeurs réelles lors de l'exécution de la requête. Si une variable requise de l'Agent IA est manquante, l'IA la demandera avant de déclencher l'appel API.

Comment l'IA gère les réponses de l'API

Exemple de corps :

{
  "order_id": "$agent.order_id",
  "email": "$contact.email"
}

L'Agent IA interprète automatiquement la réponse JSON de l'API et génère une réponse naturelle.

Exemple de réponse API :

{
  "status": "shipped",
  "eta": "2025-12-12"
}

Réponse de l'IA : « Bonne nouvelle ! » Ta commande a été expédiée et devrait arriver le 12 décembre 2025.»

Tests

Tu peux tester ton action de requête HTTP dans le panneau Tester l'Agent IA avant de publier.

Comment tester

1. Démarre une conversation de test qui correspond aux conditions de ton action.

   

2. Quand l'intention est détectée et que les entrées requises sont disponibles, l'Agent IA exécute la requête HTTP.

3. Un événement d'exécution apparaît dans le panneau de test :

   

   1. {AI Agent name} a exécuté {Action name}

   2. Les réponses 2xx sont affichées comme réussies

   3. Tous les autres codes de statut sont affichés comme des échecs

4. Clique sur l'événement pour voir :

   1. Response onglet (par défaut) — corps complet de la réponse de l'API

   2. Onglet Request — charge utile complète de la requête cURL

   3. Option de copie pour le débogage

5. Après avoir reçu la réponse de l'API, l'Agent IA génère une réponse basée sur les données renvoyées.

Notes importantes

• Les événements d'exécution apparaissent uniquement dans le panneau Test AI Agent. Ils n'apparaissent pas dans la boîte de réception ni dans l'Activité du contact.

• Si des entrées requises manquent, l'Agent IA les demandera avant de déclencher la requête.

Meilleures pratiques

• Sois précis dans la description de ton action. Des instructions vagues entraînent des déclenchements vagues.

• Définis clairement les entrées requises. Si l'IA doit demander quelque chose, rends-le évident.

• Prends en charge les cas d'erreur dans tes instructions.

• Teste toujours avant de publier.

• Évite de dupliquer la logique déjà gérée par les Workflows, sauf si c'est intentionnellement prévu.

Limitations

• Maximum : 10 actions de requête HTTP par Agent IA.

• Maximum par action :

  • 20 champs de saisie de données

  • 50 paramètres

  • 50 en-têtes

• L'Agent IA détermine quand appeler l'API en se basant sur ta description écrite. Des instructions mal rédigées peuvent provoquer des déclenchements inattendus.

• Le traitement des réponses de l'API est automatique. Tu ne peux pas mapper manuellement les champs de réponse — l'IA interprète le JSON de façon contextuelle.

• Les événements d'exécution des requêtes HTTP apparaissent uniquement dans le panneau Test AI Agent et non dans Contact Activity.

• Les Agents IA vocaux peuvent déclencher l'action « Effectuer des requêtes HTTP ». Cependant, la réponse renvoyée par l'API n'est pas transmise à l'Agent IA vocal pour la génération de la réponse, ce qui signifie que les conversations vocales ne peuvent pas répondre dynamiquement en fonction du résultat de l'API.