Avancé

Procédures personnalisées avec JavaScript et appels API

Version 1.0 · Dernière mise à jour le 2026-08-19

Des Procédures qui vont au-delà des types standards. Exécutez du JavaScript arbitraire ou appelez votre API backend pour faire des choses que seul votre métier sait faire.

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 la conversation.

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 Living Context 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 la conversation. 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 propres à chaque compte. 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
  • Dans la session du client, vous devez exécuter une action 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 lorsque le client interagit, 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 traçabilité d’audit visible sous Traçabilité.

Questions courantes

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 la conversation ?

Associez les champs de la réponse à des espaces réservés 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 la conversation et examinez l'exécution de la Procédure. Vous voyez la requête, la réponse et la réaction du client.
Ciblage avancé des audiences
Living Context : connecteurs per...