Avancé
Procédures personnalisées avec JavaScript et appels API
Version 1.0 · Dernière mise à jour le 2026-08-10
Les types de Procédures standards (question de suivi, redirection, composant, changement de Sujet, chat en direct) couvrent la plupart des cas. Quand ce n'est pas le cas, les Procédures avec JavaScript personnalisé et appel API permettent à l'agent de réaliser n'importe quelle action prise en charge par votre stack, sans quitter l'interaction.
Concepts clés
Procédures avec JavaScript personnalisé
Exécutez n’importe quel JavaScript lorsque le client clique sur la Procédure. Manipulez le DOM, appelez votre API JS sur la page, faites tout ce que le navigateur autorise. Utile pour une intégration étroite avec le produit environnant.
Procédures avec appel API
Appelez un endpoint de votre backend. Envoyez les en-têtes et champs de saisie configurés. Recevez une réponse JSON que l’agent peut utiliser directement, ou transformer avec un petit script JavaScript.
Connexions à un serveur MCP
Pour des intégrations plus larges qu’un simple endpoint, connectez votre propre serveur MCP (Model Context Protocol). L’agent lit et agit via MCP de la même façon que via n’importe quel autre connecteur. Voir Contexte dynamique pour le modèle de mise en place.
Variables
Les deux types collectent d’abord des variables auprès du client si l’agent ne les a pas déjà. Les variables peuvent dépendre de réponses précédentes.
Traitement de la réponse
Pour les appels API, la réponse JSON revient dans l’interaction. Modèles courants : messages de succès et d’erreur, texte destiné au client, Procédures de suivi.
Authentification
Les Procédures avec appel API prennent en charge les en-têtes personnalisés, les jetons bearer et les secrets par client. Gérez les secrets dans votre compte.
Ce que vous pouvez faire ici
- Construire une Procédure qui exécute du JavaScript personnalisé au clic
- Construire une Procédure qui appelle votre backend et utilise la réponse
- Collecter des variables auprès du client avant l’exécution
- Transformer les réponses API avec du JavaScript
- Définir des messages de succès et d’erreur personnalisés
- Gérer les identifiants d’authentification
Quand l’utiliser
- Les types de Procédures standards ne couvrent pas votre besoin
- Vous devez appeler votre propre backend (recherche de compte, vérification de statut, requête de facturation)
- Vous avez besoin d’une intégration poussée avec votre produit sur la page
- Vous devez faire, au sein de la session du client, quelque chose qui nécessite une logique personnalisée
Quand ne pas l’utiliser
- Les types de Procédures standards suffiraient. Commencez par là.
- Vous avez besoin d’un traitement planifié en arrière-plan. Les Procédures s’exécutent sur interaction du client, pas selon une planification.
- La logique appartient à votre backend, pas à l’agent. Dans ce cas, l’agent appelle votre backend via une Procédure avec appel API ; la logique reste là où elle doit être.
Comment ça marche
Le JavaScript personnalisé s’exécute dans le navigateur du client lorsqu’il clique sur la Procédure. Les appels API s’exécutent côté serveur, contre votre endpoint, avec les en-têtes configurés. Les deux sont enregistrés dans la trace d’audit visible sous Traçabilité.
Frequently asked questions
Comment construire une Procédure avec appel API ?
Ouvrez « Entraînement > Procédures > Créer une Procédure », choisissez « Appel API », configurez l'endpoint, les en-têtes et les champs de saisie. Ajoutez un message de succès et un message d'erreur. Enregistrez.
Comment authentifier l'appel API ?
Ajoutez un en-tête. Pour les jetons bearer, stockez le secret dans les paramètres de votre compte et référencez-le depuis l'en-tête. Évitez de coller des secrets directement dans la Procédure.
Comment utiliser la réponse de l'API dans l'interaction ?
Associez les champs de la réponse à des variables dans le message de succès. L'agent affiche le message avec les valeurs en direct.
Comment transformer une réponse API avant de l'afficher ?
Ajoutez un transformateur JavaScript à la Procédure. Il reçoit le JSON brut et renvoie la ou les valeurs à utiliser dans le message de succès.
Le JavaScript personnalisé peut-il tout faire ?
Tout ce que le navigateur du client autorise. Les règles de sécurité standards du navigateur s'appliquent (CORS, politique de même origine). Pour des actions côté serveur, utilisez une Procédure avec appel API.
Comment voir ce qu'un appel API a fait ?
Ouvrez « Analyse > Conversations », retrouvez l'interaction et examinez l'exécution de la Procédure. Vous voyez la requête, la réponse et la réaction du client.
Comment construire une Procédure avec appel API ?
Ouvrez « Entraînement > Procédures > Créer une Procédure », choisissez « Appel API », configurez l'endpoint, les en-têtes et les champs de saisie. Ajoutez un message de succès et un message d'erreur. Enregistrez.
Comment authentifier l'appel API ?
Ajoutez un en-tête. Pour les jetons bearer, stockez le secret dans les paramètres de votre compte et référencez-le depuis l'en-tête. Évitez de coller des secrets directement dans la Procédure.
Comment utiliser la réponse de l'API dans l'interaction ?
Associez les champs de la réponse à des variables dans le message de succès. L'agent affiche le message avec les valeurs en direct.
Comment transformer une réponse API avant de l'afficher ?
Ajoutez un transformateur JavaScript à la Procédure. Il reçoit le JSON brut et renvoie la ou les valeurs à utiliser dans le message de succès.
Le JavaScript personnalisé peut-il tout faire ?
Tout ce que le navigateur du client autorise. Les règles de sécurité standards du navigateur s'appliquent (CORS, politique de même origine). Pour des actions côté serveur, utilisez une Procédure avec appel API.
Comment voir ce qu'un appel API a fait ?
Ouvrez « Analyse > Conversations », retrouvez l'interaction et examinez l'exécution de la Procédure. Vous voyez la requête, la réponse et la réaction du client.
