Comment lire la documentation
Cette page explique comment lire un parcours chatbot quand on n'est pas développeur.
L'objectif n'est pas de comprendre chaque nœud Dify.
L'objectif est de répondre vite à une question métier : que fait le chatbot face à une demande client ?
Lecture en 5 minutes
Pour lire une page workflow, commencez toujours par ces quatre points :
- Objectif du parcours : pourquoi le client arrive ici.
- Informations demandées : ce que le chatbot doit collecter.
- Règles métier : ce qui autorise, bloque ou redirige la demande.
- Sortie du parcours : réponse simple, redirection, création de ticket ou absence de création.
Le diagramme Mermaid sert ensuite à vérifier la logique détaillée.
Ce que le client voit
Les pages sont organisées pour partir des boutons visibles dans le chatbot :
- Trouver un meuble,
- Suivi de commande,
- Infos sur la livraison & retours,
- Contacter le SAV,
- Demande de devis personnalisé,
- Je pose une question.
Si vous venez de tester le chatbot sur menzzo.fr, commencez par le même bouton dans la section Parcours vus dans le chatbot.
Comment lire le diagramme
Le diagramme montre l'ordre réel du workflow.
Quelques repères simples :
- un rectangle correspond souvent à une action du chatbot,
- un losange correspond à une décision,
- une flèche indique le chemin suivi,
- un bloc appelé depuis un autre workflow peut ouvrir une autre page.
Il n'est pas nécessaire de lire tout le diagramme en détail dès la première lecture.
Le plus important est de repérer les moments où le chatbot :
- demande une information,
- applique une règle,
- redirige vers un autre motif,
- crée ou ne crée pas une demande SAV.
Questions à se poser côté métier
Quand vous relisez un workflow, vérifiez surtout :
- Est-ce que le motif existe bien dans le chatbot ?
- Est-ce que les mots utilisés sont compréhensibles pour le client ?
- Est-ce que les preuves demandées sont réalistes ?
- Est-ce que les cas de refus ou de redirection sont acceptables ?
- Est-ce que l'équipe SAV sait quoi faire à la sortie du parcours ?
Cette lecture permet de valider le comportement produit sans devoir rentrer dans les détails techniques de Dify ou Laravel.