API backend

Le chatbot backend expose les endpoints métier utilisés par les workflows Dify. Pour un nouveau projet, Dify doit pouvoir appeler ce backend avec un utilisateur dédié au chatbot.

Variables utilisées par Dify

Variable	Rôle
domain_name	Endpoint API exposé par le chatbot backend.
username	Nom d'utilisateur du compte backend dédié au chatbot.
password	Mot de passe du compte backend dédié au chatbot.

Ces valeurs sont configurées dans les variables d'environnement du workflow principal Dify.

Créer l'utilisateur chatbot backend

Dans le chatbot backend :

1. Créez un utilisateur dédié au chatbot.
2. Donnez-lui les permissions nécessaires pour effectuer les requêtes API utilisées par les workflows.
3. Vérifiez que ce compte peut s'authentifier via l'endpoint attendu.
4. Stockez son mot de passe dans le gestionnaire de secrets.
5. Reportez username et password dans Dify.

Ce compte doit être technique. Il ne doit pas être le compte personnel d'un administrateur ou d'un développeur.

Permissions attendues

Les permissions exactes dépendent du backend, mais l'utilisateur doit couvrir les parcours activés dans Dify :

• lecture des informations nécessaires au suivi de commande ;
• accès aux données SAV nécessaires aux workflows ;
• création ou mise à jour de tickets si folow_up_only vaut no ;
• accès aux endpoints utilisés par le MCP SAV ou les outils de workflow ;
• accès aux actions de configuration nécessaires au chatbot, si un outil les appelle.

Si le chatbot doit uniquement donner des informations de suivi, configurez folow_up_only à yes dans Dify et limitez les permissions du compte backend en conséquence.

Configurer domain_name

domain_name doit pointer vers l'endpoint exposé par le chatbot backend et accessible depuis Dify.

Exemple de format :

https://api.example-boutique.com

À vérifier :

• l'URL est accessible depuis l'environnement Dify ;
• le certificat HTTPS est valide si l'endpoint est public ;
• les routes appelées par les workflows existent dans le nouvel environnement ;
• les logs backend permettent d'identifier les appels provenant de Dify.

Validation

Après configuration :

1. Lancez le chatbot backend.
2. Depuis Dify, exécutez un workflow qui appelle le backend.
3. Vérifiez que l'authentification réussit.
4. Vérifiez que le backend reçoit la requête avec le compte chatbot.
5. Vérifiez que la réponse backend est utilisée correctement par le workflow.
6. Testez un cas d'échec d'authentification pour confirmer que l'erreur est visible dans les logs.

Si le workflow échoue, vérifiez d'abord domain_name, username, password, puis les permissions du compte backend.