Que sont les services liés
Un service lié est un pointeur nommé vers l’un de vos endpoints HTTP. Chaque entrée comporte :
- un Service ID — l’identifiant court que les actions utilisent pour l’appeler (par exemple
orders_api) ; - une Method —
GET,POST,PUTouDELETE; - une URL — l’endpoint auquel la requête est envoyée ;
- un en-tête d’authentification facultatif et sa valeur secrète.
Lorsqu’une action invoque un service lié, le backend de Seekdown effectue la requête pour le compte de l’assistant, ajoute l’en-tête d’authentification si vous en avez configuré un, et renvoie la réponse à la conversation. Comme l’assistant ne désigne jamais le service que par son identifiant, l’URL réelle et les éventuels identifiants restent sur le serveur — ils ne font jamais partie de la configuration publique de l’assistant que télécharge le widget.
Quand utiliser un service lié
- Récupérer des données en direct que le jeu de données ne peut pas contenir — l’état d’une commande, un niveau de stock ou le solde d’un
compte — en réponse à la question d’un utilisateur.
- Soumettre une demande à vos systèmes — créer un ticket, enregistrer un intérêt, déclencher un
workflow — depuis un formulaire affiché par l’assistant.
- Garder une clé API hors de la page — vous voulez appeler un endpoint authentifié sans
exposer la clé dans le code front-end.
Documentation associée
- Personnalisation avancée — où se trouvent les actions et le helper
executeProxyRequest.
- Formulaires de l’assistant — collecter les informations que l’assistant peut envoyer à un service lié.