Créer un service lié

Les services liés se configurent par assistant, à côté de ses autres paramètres.

Avant de commencer

• Disposez d’un assistant déjà créé. Consultez [Créez un assistant

parfait](build-assistant.md) si vous n’en avez pas encore.

• Connaissez l’endpoint à appeler — son URL, sa méthode et (si nécessaire) l’en-tête

et la valeur utilisés pour l’authentification.

Étapes

1. Ouvrez votre assistant et accédez à l’onglet Linked services.
2. Choisissez Add linked service.
3. Dans la boîte de dialogue, renseignez :

• Service ID — un identifiant court et unique que vos actions utiliseront (par ex. orders_api).
• Method — GET, POST, PUT ou DELETE.
• URL — l’endpoint complet, commençant par https://.

1. (Facultatif) Sous Authentication, définissez un Header name (comme Authorization)

et sa Secret value. Voir Authentifier les requêtes.

1. (Facultatif) Sous Headers, ajoutez des en-têtes de requête dont les valeurs peuvent contenir des espaces réservés {{params.x}}.

Voir Transmettre des valeurs dynamiques.

1. Cliquez sur Save service, puis appliquez (Apply) la configuration de l’assistant.

Vérifier le résultat

Le service apparaît dans la liste avec sa méthode, son endpoint et — si vous en avez ajouté un — un badge Auth. Déclenchez l’action qui l’appelle (ou le formulaire qui y est relié) et vérifiez que la réponse apparaît dans la conversation.

Dépannage

• L’enregistrement est désactivé — un champ obligatoire (Service ID ou URL) est vide, ou l’URL ne

commence pas par http:// ou https://.

• « Set an auth header name to attach the secret to. » — vous avez saisi une valeur secrète mais

laissé le nom de l’en-tête vide. Ajoutez le nom de l’en-tête ou effacez le secret.

Documentation associée

• Appeler un service lié — y relier une action.
• Authentifier les requêtes — ajouter un identifiant qui reste côté serveur.