Appeler un service lié
Les services liés sont invoqués depuis les actions côté client de l’assistant — un formulaire relié au proxy, ou une action de template personnalisée — à l’aide du helper executeProxyRequest :
executeProxyRequest(id, body, callback, params)id— le Service ID que vous avez enregistré.body— la charge utile JSON à envoyer. Elle sert de corps de requête pourPOSTetPUT;
les requêtes GET et DELETE sont envoyées sans corps.
callback— reçoit la réponse de l’endpoint pour que votre action puisse l’afficher.params(facultatif) — des valeurs qui remplissent les espaces réservés{{params.x}}dans l’URL et
les en-têtes du service. Voir Transmettre des valeurs dynamiques.
Depuis un formulaire
Pour un formulaire destiné à appeler un endpoint, reliez son envoi à sendProxyForm, qui sérialise les champs et appelle executeProxyRequest pour vous :
sendProxyForm(proxyId, event, callback)Passez le Service ID en tant que proxyId. Les champs soumis deviennent le corps de la requête, et la réponse est ajoutée à la conversation. Consultez Formulaires de l’assistant pour construire le formulaire et Personnalisation avancée pour relier son gestionnaire.
Depuis une action personnalisée
Dans un helper de template personnalisé, vous pouvez appeler directement executeProxyRequest(id, body, callback) — par exemple pour récupérer des données lorsque l’utilisateur clique sur un bouton — et utiliser la réponse pour mettre à jour la conversation. Le helper est documenté dans Personnalisation avancée.
Documentation associée
- Personnalisation avancée — helpers, actions et templates.
- Formulaires de l’assistant — capturer les informations dont un appel de service a besoin.