L'outil est disponible pour tous les canaux : Chat, Téléphone et E-mail.
Ne le confondez pas avec la requête HTTP dans les Automatisations. Dans les Automatisations, la requête HTTP est une étape du flux qui s'exécute à un moment fixe. Cet outil appartient à l'Agent IA lui-même : c'est lui qui décide, pendant la conversation, s'il faut effectuer la requête et quand, et qui continue à travailler avec la réponse.
Prérequis : un Agent IA dans Superchat et une API que vous souhaitez appeler (URL, méthode et, si nécessaire, identifiants).
Ajouter l'outil
Ouvrez votre Agent IA et passez à la zone Outils et Actions à gauche.
Cliquez sur Ajouter un outil en haut à droite.
Sélectionnez la carte Requêtes HTTP et cliquez sur Ajouter.
L'éditeur de l'outil s'ouvre avec six onglets : Général, Paramètres, Requête, Corps, Identifiants et Test.
Général : nom et règle d'utilisation
Nom de l'outil : Un nom court décrivant ce que fait l'outil, par exemple « Vérifier le statut d'une commande » ou « Créer un rendez-vous ». Le nom apparaît dans la liste sous Outils et Actions.
Quand l'agent doit-il utiliser l'outil ? Cette description est la partie la plus importante de l'outil. L'Agent IA décide d'effectuer ou non la requête en fonction de ce texte. Décrivez précisément dans quelle situation il doit utiliser l'outil, ce qu'il trouvera dans la réponse et comment l'exploiter. Indiquez aussi quand il ne doit pas l'utiliser.
Exemple : « Utilise cet outil lorsque le client demande le statut de sa commande. La réponse contient le statut actuel et la date de livraison prévue, que tu dois communiquer au client. N'utilise pas cet outil si le client n'a pas fourni de numéro de commande. »
Paramètres : quelles valeurs l'agent fournit
Les paramètres sont les valeurs qui changent d'une requête à l'autre, comme un numéro de commande ou le numéro de téléphone du contact. Vous les définissez ici, puis vous les insérez via le bouton { } dans l'URL, les paramètres de requête, les en-têtes ou le corps.
Cliquez sur Ajouter et renseignez pour chaque paramètre :
Nom : Le nom que vous utiliserez plus tard pour insérer la valeur.
Source : D'où vient la valeur.
Agent IA : L'agent récupère la valeur dans la conversation, par exemple un numéro de commande mentionné par le client.
Attribut de contact : La valeur provient des données existantes du contact dans Superchat, par exemple le numéro client.
Type : Type de données de la valeur, par exemple texte.
Description : Ce qu'est la valeur et d'où elle vient. Pour la source « Agent IA », la description aide l'agent à extraire la bonne valeur de la conversation.
Obligatoire : Si la requête a absolument besoin de la valeur.
La colonne Utilisation indique si le paramètre a déjà été inséré quelque part dans la requête. Si elle indique « Non lié », la valeur n'est encore envoyée nulle part.
Astuce sur « Obligatoire » : Désactivez « Obligatoire » pour tout ce qui provient de la conversation. Si la valeur n'est pas disponible, l'agent omet simplement le champ, au lieu de bloquer la requête ou de poser inutilement la question au client.
Requête : méthode, URL, paramètres de requête et en-têtes
Méthode et URL : Choisissez la méthode HTTP à gauche (par exemple POST) et saisissez à droite l'URL de votre API ou de votre webhook.
Paramètres de requête : Paires nom-valeur ajoutées à l'URL. Utilisez Ajouter pour en créer d'autres.
En-têtes : Paires nom-valeur pour les en-têtes HTTP, par exemple
Content-Type. Les identifiants n'ont rien à faire ici : utilisez plutôt l'onglet Identifiants.Délai d'attente : Nombre de secondes après lequel la requête est annulée (par défaut : 30). Au téléphone, l'appelant attend pendant ce temps : gardez la valeur aussi basse que votre API le permet.
Dans tous les champs, vous pouvez insérer un paramètre via le bouton { }.
Corps : contenu de la requête
Choisissez ce que la requête envoie :
Aucun corps : La requête n'envoie aucun contenu. Convient aux requêtes simples.
JSON : Données structurées, le standard de la plupart des API et webhooks.
Données de formulaire : Champs de formulaire classiques.
Texte brut : Contenu textuel libre.
Ici aussi, vous insérez les paramètres via { }, par exemple {"order_number": {{order_number}}}.
Identifiants : authentifiez votre API en toute sécurité
Si votre API nécessite une clé d'API ou un jeton, enregistrez-le ici. Sélectionnez des identifiants existants dans la liste déroulante ou cliquez sur Créer de nouveaux identifiants. Une fois créés, les identifiants sont de nouveau disponibles pour d'autres outils.
Les identifiants sont stockés de manière sécurisée. L'Agent IA ne voit ni ne définit jamais ces valeurs, il ne peut donc pas non plus les révéler par accident dans une conversation.
Test : exécutez la requête pour de vrai une fois
Avant d'enregistrer, vérifiez la requête dans l'onglet Test. Saisissez une valeur d'exemple pour chaque paramètre et cliquez sur « Envoyer la requête de test ». La requête part réellement vers votre API, utilisez donc des données de test.
La mention « Aucun paramètre n'est utilisé nulle part : cet outil appelle toujours la même requête » signifie que vous avez créé des paramètres mais ne les avez insérés nulle part via { }, ou que l'outil fonctionne sans aucun paramètre. Ce n'est pas un problème pour une requête fixe ; dès que l'agent doit envoyer des valeurs issues de la conversation, insérez-les dans l'URL, l'en-tête ou le corps.
Cliquez ensuite sur Enregistrer. L'outil apparaît dans la liste sous Outils et Actions sous la forme Requêtes HTTP : <Nom>.
Tester en conversation
Ouvrez l'Environnement de test à droite, choisissez le canal (Chat, Téléphone ou E-mail) et posez à votre Agent IA la question qui doit déclencher l'outil. Vous voyez ainsi s'il l'utilise au bon moment et s'il exploite la réponse de façon pertinente.
Si l'agent n'utilise pas l'outil, commencez par affiner le texte sous Quand l'agent doit-il utiliser l'outil ? et mentionnez aussi l'outil dans Tâche et Règles, sous « Que doit faire votre agent ? », par exemple : « Si un client demande des nouvelles de sa commande, consulte le statut de la commande via l'outil et indique-lui le statut et la date de livraison. »
Important : Les attributs de contact ne sont pas partagés dans l'Environnement de test. Dans l'Environnement de test, vous ne pouvez travailler qu'avec des paramètres que l'agent tire de la conversation en cours. Pour tester avec des attributs de contact, utilisez une vraie conversation, déclenchée par vous-même.
Bonnes pratiques
Formulez la règle d'utilisation de façon positive et négative. Quand l'utiliser, quand ne pas l'utiliser.
Gardez des réponses concises. L'agent lit la réponse de votre API. Plus elle est claire et courte, plus sa réponse au client sera précise.
Gardez le délai d'attente aussi bas que possible. Le contact remarque chaque seconde d'attente. Au téléphone, nous recommandons 10 secondes au maximum, et 30 secondes dans le chat.
Testez avec des données de test. La requête de test et les tests dans l'Environnement de test appellent réellement votre API.