Répondez avec des données en direct de vos propres systèmes
L'appel d'outils permet au chatbot d'appeler votre API en cours de conversation, de lire la réponse et de l'utiliser dans sa réponse. Le client demande des informations sur sa commande, et le bot donne la réponse réelle plutôt qu'une réponse générique.
L'apprentissage enseigne au chatbot des choses qui restent fixes. L'appel d'outils couvre ce qui change à la minute : un statut de commande, un numéro de suivi, une réservation. C'est une fonctionnalité avancée qui nécessite du code personnalisé sur votre serveur, donc planifiez-la avec la personne qui gère vos systèmes.
Pas à pas
Décidez où placer la recherche
L'appel d'outils est utilisé par les Q&R et les Flows. Placez-le dans une Q&R lorsqu'une seule question nécessite une réponse en direct, et dans un flow lorsque la recherche fait partie d'un parcours de conversation plus long.
Pointez-le vers votre endpoint
Dans URL, saisissez l'adresse du endpoint API qui répondra à la requête. Dans Headers, ajoutez les paires clé:valeur dont votre endpoint a besoin. Dans les Q&R, les headers sont séparés par des virgules ; dans les flows, vous les ajoutez un par un.
Définissez ce que le client doit vous fournir
Les propriétés sont les valeurs que le chatbot doit collecter avant de pouvoir vous appeler, par exemple une ville ou un numéro de suivi. Si les valeurs possibles sont connues à l'avance, listez-les sous Valeurs autorisées pour que le bot reste dans cet ensemble.
Lisez la requête sur votre serveur
Nous envoyons à votre serveur cette structure : {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — en tant que corps JSON pour POST, et en tant qu'en-tête pour GET. Chaque clé d'argument est le nom de la propriété en kebab case, donc "Order Number" arrive sous la forme order-number. Vous pouvez également placer une valeur directement dans l'URL avec un champ de fusion, par exemple {order-number}.
Renvoie du JSON que le chatbot peut utiliser
Votre serveur doit répondre avec un JSON contenant les valeurs que vous souhaitez que le bot énonce, par exemple {"order_status":"Livré il y a 2 heures et 25 minutes","success":true}. N'incluez "success": true que si la requête a réellement réussi.
Référence des paramètres
| Paramètre | Ce qu'il fait |
|---|---|
| URL | L'adresse de votre point d'accès API que le chatbot appelle. |
| En-têtes | Paires clé:valeur envoyées avec la requête, séparées par des virgules dans les Q&R et ajoutées une par une dans les flux. |
| Propriétés | Les valeurs que l'utilisateur doit fournir avant que l'appel puisse être effectué, comme une ville ou un numéro de suivi. |
| Valeurs autorisées | Limite une propriété à un ensemble d'options connues plutôt qu'à du texte libre. |
Bon à savoir
« success: true » est une promesse, pas une formalité
Ne le renvoyez que si la requête a réellement fonctionné. Si le numéro de commande est invalide ou si rien n'a été trouvé, omettez-le pour que le chatbot ne présente pas un échec comme une réponse.
Les noms d'arguments changent de forme
Les noms de propriétés arrivent en kebab case, donc « Order Number » devient order-number. Respectez cette orthographe dans votre code et dans tout champ de fusion que vous placez dans l'URL.
GET et POST reçoivent les données différemment
Pour POST, la charge utile arrive sous forme de corps JSON. Pour GET, elle arrive sous forme d'en-tête. Vérifiez la méthode utilisée par votre point d'accès avant de commencer à lire la requête.
Vous recevez du contexte à chaque appel
La requête inclut user_id, conversation_id et user_language, afin que votre endpoint sache qui pose la question et dans quelle langue.
Ceci nécessite un développeur.
L'appel d'outils est une fonctionnalité avancée. Le panneau de configuration est simple, mais quelque chose sur votre serveur doit recevoir la requête et renvoyer le JSON.
Questions fréquentes
Où puis-je utiliser l'appel d'outils ?
Qu'envoyez-vous exactement à mon serveur ?
Comment intégrer la valeur du client dans mon URL ?
Que doit renvoyer mon serveur ?
Que se passe-t-il si le client donne un numéro qui n'existe pas ?
Puis-je limiter ce que le client est autorisé à saisir ?
Prêt à mettre fin au chaos ?
Unifiez vos messages, automatisez les questions récurrentes et transformez les conversations en revenus — dès aujourd'hui.
Commencer