OWAN

Flow paysagiste — du prospect au chantier réalisé

🧠 Le framework OWAN — 4 couches
1️⃣ FLOW (cette page = le cahier des charges) → 2️⃣ MCP (les outils qui exécutent) → 3️⃣ SKILLS (le savoir-faire métier) → 4️⃣ CLAUDE.md (le cerveau qui orchestre). Chaque étape ci-dessous montre son câblage réel : déplie « Sous le capot ».
✅ validation boss ⚙️ automatique 👷 étape humaine 🟢 testé réel 🧪 testé simulé 🤝 à tester à deux 🔜 à venir
🌱
Prospect
1
Nouveau lead reçu
⚙️ automatique🟢 testé réel
Le client remplit le formulaire en ligne. Le lead arrive automatiquement dans le système.
Sous le capot
⚡ Déclencheur : webhook Make → POST /lead (leads_webhook.py), 100% Python, le LLM n'est pas dans la boucle
🧩 Skill : —
🔧 MCP : —
✉️ Templates : —
📊 CRM : fiche créée (statut nouveau_lead) + message form_meta tracé
🛡️ Garde-fou : anti-doublon email/tél : lead déjà connu → pas de 2e fiche, boss prévenu
Automatique
2
Email + SMS envoyés au client
⚙️ automatique🧪 testé simulé
Message de bienvenue envoyé automatiquement pour confirmer la réception de la demande.
Sous le capot
⚡ Déclencheur : enchaîné au webhook lead, immédiat
🧩 Skill : —
🔧 MCP : —
✉️ Templates : welcome_email, welcome_sms
📊 CRM : les 2 messages sortants tracés sur la fiche
🛡️ Garde-fou : échec d'envoi = annoncé au boss, jamais masqué (email testé réel, SMS simulé)
Automatique Email SMS
3
Appel de planification de la visite
👷 étape humaine🟢 testé réel
Le paysagiste appelle le client pour fixer une date et heure de visite.
Sous le capot
⚡ Déclencheur : le paysagiste appelle ; l'appel est capté par le webhook Ringover → transcript Groq → analyse Haiku
🧩 Skill : —
🔧 MCP : —
✉️ Templates : —
📊 CRM : appel loggé (canal appel) + rattaché au client par numéro
🛡️ Garde-fou : appel raté sur un nouveau lead → séquence relance J0/J+1/J+2 automatique
Paysagiste
4
Visite ajoutée au calendrier
✅ validation boss🟢 testé réel
Le créneau est enregistré automatiquement dans Google Calendar du paysagiste.
Sous le capot
⚡ Déclencheur : clic ✅ sous le récap « VISITE PLANIFIÉE » posté après l'appel
🧩 Skill : planifier-visite
🔧 MCP : confirm_pending_visite
✉️ Templates : —
📊 CRM : intervention visite_planifiee + id de l'événement Calendar
🛡️ Garde-fou : RIEN ne part (SMS/agenda) sans le ✅ du boss
Automatique Calendrier
5
SMS de confirmation de visite
✅ validation boss🟢 testé réel
Le client reçoit un SMS confirmant la date et l'heure de la visite.
Sous le capot
⚡ Déclencheur : même clic ✅ que l'étape 4 (un seul geste)
🧩 Skill : planifier-visite
🔧 MCP : confirm_pending_visite
✉️ Templates : visite_sms
📊 CRM : SMS sortant tracé sur la fiche
🛡️ Garde-fou : échec SMS affiché ❌ dans la notif, jamais un faux ✅
Automatique SMS
6
SMS de rappel 24h avant
⚙️ automatique🟢 testé réel
Rappel automatique envoyé la veille de la visite pour limiter les oublis.
Sous le capot
⚡ Déclencheur : boucle des tâches (60 s) : rappel planté la veille à 18h à la confirmation de la visite
🧩 Skill : —
🔧 MCP : —
✉️ Templates : rappel_visite_sms
📊 CRM : tâche rappel_visite faite + SMS tracé
🛡️ Garde-fou : visite trop proche (veille 18h passée) → pas de rappel, annoncé honnêtement
Automatique SMS
7
Visite
👷 étape humaine🟢 testé réel
Le paysagiste se rend chez le client pour évaluer le chantier.
Sous le capot
⚡ Déclencheur : le paysagiste se déplace — OWAN n'intervient pas
🧩 Skill : —
🔧 MCP : —
✉️ Templates : —
📊 CRM : statut déjà à visite_planifiee
🛡️ Garde-fou : —
Paysagiste
📋
Visite
8
Visite du chantier
👷 étape humaine🟢 testé réel
Le paysagiste inspecte le terrain et prend ses notes pour établir le devis.
Sous le capot
⚡ Déclencheur : sur le terrain — OWAN n'intervient pas
🧩 Skill : —
🔧 MCP : —
✉️ Templates : —
📊 CRM : —
🛡️ Garde-fou : —
Paysagiste
9
Création du devis
✅ validation boss🟢 testé réel
Le paysagiste dicte le devis à voix haute. OWAN génère le document et propose un récap pour validation.
Sous le capot
⚡ Déclencheur : le boss dicte sur Telegram (vocal transcrit par Groq dans le plugin)
🧩 Skill : creer-devis
🔧 MCP : propose_devis · propose_offre (offre d'entretien = N devis)
✉️ Templates : —
📊 CRM : — (écrit à l'envoi)
🛡️ Garde-fou : matching anti-Audrey (ambigu → demande), montant > 10 000 € → confirmation, prix ≤ 0 refusé
Paysagiste OWAN
10
Envoi du devis (email + SMS)
✅ validation boss🟢 testé réel
Le devis est envoyé au client par email (PDF) et par SMS avec un lien de consultation.
Sous le capot
⚡ Déclencheur : clic ✅ Envoyer sous le récap
🧩 Skill : creer-devis
🔧 MCP : send_pending_devis
✉️ Templates : devis_email, devis_sms (offre_* pour une offre)
📊 CRM : devis envoye + statut client devis_envoye + relances J+7/J+11 posées
🛡️ Garde-fou : anti faux-succès Unipros ; email KO → relances NON posées (pas de harcèlement à vide)
Automatique Email SMS
11
Envoi du devis pour signature
✅ validation boss🟢 testé réel
Une fois accepté, le devis est envoyé pour signature électronique via Unipros.
Sous le capot
⚡ Déclencheur : le boss annonce « Mme X a validé » + date/heure d'intervention
🧩 Skill : signer-devis
🔧 MCP : propose_signature → send_pending_signature
✉️ Templates : intervention_email, signature_sms
📊 CRM : devis signature_envoyee + relances du devis COUPÉES
🛡️ Garde-fou : parser de dates bloquant (« Tu as dit → Je comprends ») + re-vérif du statut Unipros au clic + anti-injection
Automatique Email
12
Inscription à l'avance immédiate
⚙️ automatique🧪 testé simulé
Si éligible, le client est inscrit à l'avance immédiate (crédit d'impôt instantané).
Sous le capot
⚡ Déclencheur : le client clique le lien reçu dans l'email d'intervention → funnel web /inscription (4 étapes)
🧩 Skill : —
🔧 MCP : —
✉️ Templates : page web (adresse BAN, RIB photo → OCR Gemini)
📊 CRM : inscription tracée (JSON + message fiche si succès)
🛡️ Garde-fou : matching nom+CP+email/tél (femmes mariées ok), double-essai nom naissance/usage, jamais de faux succès URSSAF
Automatique
13
Proposition de créneau chantier
✅ validation boss🟢 testé réel
Le paysagiste propose une date de chantier. Le créneau est ajouté au calendrier.
Sous le capot
⚡ Déclencheur : le boss donne la date de chantier sur Telegram
🧩 Skill : gerer-chantier
🔧 MCP : propose_chantier → confirm_pending_chantier
✉️ Templates : —
📊 CRM : intervention chantier_planifie + événement Calendar + rappel veille posé
🛡️ Garde-fou : parser de dates bloquant ; rien n'est envoyé au client à cette étape
Paysagiste Calendrier
14
SMS de confirmation 24h avant le chantier
⚙️ automatique🧪 testé simulé
Le client reçoit un rappel automatique la veille du chantier.
Sous le capot
⚡ Déclencheur : boucle des tâches (60 s) : rappel planté la veille à 18h à la confirmation du chantier
🧩 Skill : —
🔧 MCP : —
✉️ Templates : rappel_chantier_sms
📊 CRM : tâche rappel_chantier faite + SMS tracé
🛡️ Garde-fou : chantier trop proche → pas de rappel, annoncé (même moteur que le rappel visite, testé réel)
Automatique SMS
🔨
Chantier
15
Chantier réalisé
👷 étape humaine🟢 testé réel
Le paysagiste effectue les travaux chez le client.
Sous le capot
⚡ Déclencheur : les travaux — OWAN n'intervient pas
🧩 Skill : —
🔧 MCP : —
✉️ Templates : —
📊 CRM : —
🛡️ Garde-fou : —
Paysagiste
16
Transformation du devis en facture
✅ validation boss🤝 à tester à deux
Le devis signé est automatiquement converti en facture dans Unipros.
Sous le capot
⚡ Déclencheur : le boss annonce « chantier fini chez X »
🧩 Skill : gerer-chantier
🔧 MCP : propose_facture → send_pending_facture
✉️ Templates : payment_email, payment_sms
📊 CRM : facture tracée + devis facture + relances coupées (filet)
🛡️ Garde-fou : SEUL un devis SIGNÉ est facturable ; réponse Unipros douteuse → « à vérifier », jamais un faux ✅
Automatique
17
Relance fidélisation (re-business)
⚙️ automatique🔜 à venir
Une fois le chantier payé, OWAN programme une relance calée sur le cycle naturel de la prestation (une haie repousse en 2-3 mois, une tonte en 1 mois). Le moment venu, il notifie le PAYSAGISTE — pas le client — pour qu'il recontacte et vende la prochaine intervention.
Sous le capot
⚡ Déclencheur : paiement reçu → pose une tâche à la date « chantier + cycle de la prestation » · puis la boucle des tâches (60 s) la fait remonter le jour venu
🧩 Skill : à définir (Agent Spec)
🔧 MCP : à définir (boucle des tâches + notif boss)
✉️ Templates : notif interne au boss (pas d'envoi client à ce stade)
📊 CRM : tâche relance_rebusiness posée à la bonne date + statut client « à recontacter »
🛡️ Garde-fou : cycle par type de prestation (table à fournir) · relance vers le boss, jamais le client directement
Automatique Paysagiste recontacte
⚙️ Éléments transversaux
📊 CRM — Mise à jour automatique en continu
Le CRM est mis à jour silencieusement à chaque étape clé, sans action du paysagiste.
🌱 Nouveau lead →
📞 Appel planifié →
🏡 Visite réalisée →
📄 Devis créé →
✍️ Devis signé →
🔨 Chantier réalisé
Sous le capot
⚡ Déclencheur : chaque outil écrit dans owan.db au moment où il agit (aucune saisie du paysagiste)
🧩 Skill : —
🔧 MCP : tous (helpers crm.py = la seule porte d'écriture)
✉️ Templates : —
📊 CRM : 5 tables : clients · messages · interventions · devis_factures · taches
🛡️ Garde-fou : une seule porte d'écriture, jamais de SQL sauvage — historique complet par client
🔴 Relance prospect — Pas de réponse à l'appel
Si le client ne répond pas à l'appel de planification, des relances automatiques sont envoyées.
📞 Appel sans réponse → SMS J+1 Relance 1
📱 Toujours sans réponse → SMS J+2 Relance 2
🚫 Après 3 tentatives → Marqué injoignable, coupure auto
Sous le capot
⚡ Déclencheur : appel sortant non répondu vers un nouveau lead (webhook Ringover)
🧩 Skill : planifier-visite (bouton « Envoyer juste le SMS »)
🔧 MCP : send_lead_sms + boucle des tâches
✉️ Templates : tentative_sms (J0), relance_lead_sms (J+1/J+2)
📊 CRM : taches relance_lead (3 max) → statut injoignable
🛡️ Garde-fou : contact établi (appel répondu) → séquence coupée automatiquement
🟠 Relance devis — Pas de réponse au devis envoyé
Si le client ne répond pas après réception du devis, des relances sont envoyées automatiquement.
📄 Devis envoyé sans réponse → SMS J+7 Relance 1
📱 Toujours sans réponse → SMS J+11 Relance 2
🚫 Après J+11 → Coupure automatique des relances
Sous le capot
⚡ Déclencheur : boucle des tâches (60 s) : posées à l'envoi du devis, dues à J+7 puis J+11
🧩 Skill : creer-devis (stop_relances à la voix)
🔧 MCP : stop_relances + boucle des tâches
✉️ Templates : relance_j7_email/sms, relance_j11_email/sms (+ versions offre_*)
📊 CRM : taches relance_devis → faite/annulee
🛡️ Garde-fou : signature ou facture → relances COUPÉES automatiquement (fini le client signé harcelé)