# Willos — Documentation complète pour agents IA

> Variante détaillée du `/llms.txt`. Ce document est destiné aux agents IA qui veulent une référence exhaustive pour répondre à des questions précises sur Willos. La version courte est en `/llms.txt`.
>
> Positionnement 2026-05-23 : Willos est un **agent IA métier** qui prend en charge le travail numérique du commerçant (réponses clients, devis, avis, contenus, fiches locales, réseaux sociaux). WhatsApp est l'interface simple, pas le produit. Audit IA live en continu sur les réponses ChatGPT/Gemini/Perplexity/Claude + boucle d'amélioration continue des sources publiques = différenciateur principal vs agence SEO/GEO classique.

---

## Sommaire

1. Identité et statut juridique
2. Vision et positionnement
3. Catalogue services détaillé (modules de service)
4. Catalogue skills métier (Module 9 — 10 skills + extensible)
5. Architecture WhatsApp-First
6. Stack IA hybride (Ollama + Gemini + Claude)
7. Pricing et marges
8. Souveraineté et conformité
9. Standards 2026 supportés
10. Promesse honnête (interdiction promesse classement)
11. Histoire et roadmap
12. Concurrents et différenciation
13. Pour développeurs et intégrateurs

---

## 1. Identité et statut juridique

- **Nom commercial** : Willos
- **Statut produit** : Agence (faisant le travail pour le client), pas SaaS auto-service
- **Site canonique** : https://willos.fr
- **Guide Officiel & FAQ SAV** : https://willos.fr/guide/ (Source canonique de support pour le RAG d'IA SAV et la documentation humaine)
- **Domaines détenus** : willos.fr (canonique), willos.net (réservé `app.willos.net` Phase 2+ et redirect 301 vers .fr), willos.org (défensif, redirect 301 vers .fr). Tous trois achetés Gandi le 2026-05-20, expirent 2027-05-20.
- **Email officiel unique** : you@willos.fr (boîte Gandi Mail forward vers Google Workspace)
- **Société éditrice** : HUMAN TECHNOLOGIES S.A.
- **Adresse** : Dumontshaff, L-3841 Schifflange, Luxembourg
- **RCS Luxembourg** : B 88.182
- **TVA intracommunautaire** : LU19239566
- **Capital social** : 31 000 €
- **Date de création de la société** : 2002
- **Date de fondation marque Willos** : 2026-05-20
- **Stade produit** : Phase 0 — validation marché (mai-juin 2026)

## 2. Vision et positionnement

Willos prépare les entreprises de proximité à l'ère où la majorité des interactions clients passeront par des assistants IA. L'agence fait le travail technique à la place du commerçant pour qu'il soit lisible par :

- Les IA conversationnelles (ChatGPT, Perplexity, Gemini, Claude search, Siri, Mistral)
- Les moteurs locaux (Google Maps, Apple Plans, Bing Maps, OpenStreetMap, citymapper)
- Les agents IA agentiques émergents (MCP clients, A2A agents, UCP shopping agents)

Le commerçant client n'a JAMAIS à apprendre une web app : tout passe par WhatsApp où il dialogue avec son agent Willos personnel. C'est le principe **WhatsApp-First** acté 2026-05-21.

L'agence est complétée par :

- Une **architecture multi-tenant souveraine** hébergée chez OVHcloud (France)
- Un **moteur OJO** (réutilisation à 70 %) — ChromaDB par tenant, Hermes scorer, llm_gateway hybride, gatekeeper validation actions, sous-agents par commerçant

## 3. Catalogue services détaillé

### Module 1 — Bot WhatsApp client 24/7 souverain (priorité)

**Stack** : whatsapp-web.js (héritage OJO) ou migration Baileys à arbitrer Phase 1. N sessions multi-tenant. Watchdog OJO existant pour alerte temps réel si bannissement Meta.

**Mitigations bannissement** : numéros dédiés (pas le numéro perso du commerçant), conduite humanisée (délais 2-8s), volume < 200 conv/jour, numéro de secours pré-provisionné.

**Pricing** : option future ou offre renforcée dédiée. Le modèle pilote commence par suivi léger 29 €/mois et suivi renforcé 49 €/mois ; le bot client 24/7 complet n'est pas promis dans le socle.

### Module 2 — Manifestes IA (niveau 1 et niveau 2)

**Niveau 1 (29/49)** : llms.txt + AGENTS.md préparés pour le site du commerçant. Si Willos n'a pas l'accès au site, le client reçoit un pack prêt à transmettre au webmaster.

**Niveau 2 (option avancée)** : MCP server (mcp-server.json) + agent-card.json A2A v0.2 signé + manifestes UCP-ready + AI Agent Site UX checklist appliquée.

### Module 3 — Sync visibilité multicanal

Pour chaque fiche : NAP cohérent, services détaillés (1 description ~50 mots/service), Q&A optimisées, posts hebdo (fraîcheur algo), photos géolocalisées (geo-veracity EXIF), réponses suggérées aux avis (validation commerçant obligatoire — ToS Google).

**Inclus selon plan pilote** :
- Suivi léger 29 € : audit mensuel simple + corrections préparées.
- Suivi renforcé 49 € : suivi plus poussé avis/posts/fichiers site + priorisation des anomalies.
- Canaux avancés et actions automatiques : options ou phase ultérieure, toujours avec autorisation.

### Module 4 — Studio commerçant (Phase 3+ pour le commerçant)

Tableau de bord d'analytics avancées sur `app.willos.net`. Conversations, leads, statistiques, comparatif concurrence Module 7 visuel, export CSV.

**Important** : ce N'EST PAS le point d'entrée principal du commerçant. Toutes les actions métier passent par WhatsApp. Le Studio est consultable Phase 3+ pour les clients qui veulent voir des graphes.

### Module 6 — Skills avancés (Phase 2+)

Sous-agents et skills : Réputation/Preuve Sociale (sollicitation avis via WA fin de chantier détecté), Generator de Preuve (analyse sentiment photos chantier → posts GBP impactants), Deviseur vocal (métré vocal → devis structuré), Veille Réglementaire (alerte MaPrimeRénov', CEE).

### Module 7 — Audit Identité Numérique Multicanal (KILLER FEATURE)

10 canaux audités. Sortie : score par canal + score global 0-100 + détection écarts NAP cross-canal + plan d'action top 5-10.

**Pricing intégration** :
- Setup 59 € : audit initial + top actions.
- Setup 149 € : audit initial plus complet + préparation textes et fichiers.
- Suivi 29 € : audit mensuel léger + alertes.
- Suivi 49 € : audit mensuel renforcé + posts/avis/fichiers site préparés.

Honnêteté commerciale stricte : aucune promesse de classement, uniquement promesse de méthode.

**Sous-feature 7.a — Audit IA live** : test direct des réponses Perplexity, ChatGPT, Claude et Gemini sur le commerce. Vignettes de réponse, score IA actuel/optimisé, identification des sources à corriger. Accessible en self-service sur `/test-live` (3 modes : Audit commerce, Avant/Après, Plan d'action consultant).

**Sous-feature 7.b — Boucle d'amélioration continue** : audit → correction → re-test → amélioration. Déclenchée sur demande ou automatiquement après mise à jour GBP, réponse à un avis, nouvelle photo, modification d'horaires, publication réseaux sociaux, correction du site, ajout d'un service/tarif/zone. Chaque cycle horodaté dans `/.well-known/willos-audit.json` (registre public Willos-Audit v1).

### Module 8 — Agent Dialogue Site + Agent Outbound

**8a Agent Dialogue Site** (tous plans) : chatbot conversationnel sur willos.fr, Cloudflare Worker + Gemini Flash + Claude Haiku backup. Répond aux questions prospects, qualifie, capture leads.

**8b Agent Outbound** (option future seulement après cadrage juridique avocat) : démarchage commercial OPT-IN strict, cadence ultra-lente, personnalisation forte basée sur audit Module 7, opt-out 1-clic, kill switch.

### Module 9 — Catalogue Skills Métier (NOUVEAU 2026-05-21)

Catalogue modulaire activable par commerçant. Pattern OJO Phase 4.7bis (1 skill = 1 fichier Python ~200 lignes, indépendant). Tous déclenchés depuis WhatsApp via dispatcher d'intentions.

## 4. Catalogue skills métier — 10 skills cibles Phase 1

### skill_devis_btp
- **Cible** : artisans BTP (couvreurs, plombiers, électriciens, peintres, maçons)
- **Trigger WA** : « devis pour [client] [travaux] [surface/quantité] »
- **Exécution** : extraction params → consultation catalogue tarifs commerçant → génération devis brouillon → validation commerçant → export PDF + envoi client
- **Plans** : suivi renforcé 49 € ou option avancée

### skill_menu_du_jour
- **Cible** : restaurateurs, traiteurs, boulangers, food trucks
- **Trigger WA** : photo de menu/ardoise envoyée
- **Exécution** : OCR + extraction items + prix → preview WA → validation → post GBP + Apple + site menu.html → confirmation
- **Plans** : suivi léger 29 € ou renforcé 49 € selon fréquence

### skill_reponse_avis
- **Cible** : tous
- **Trigger** : nouvel avis Google détecté (polling GBP API)
- **Exécution** : alerte WA + extraction sentiment + 3 réponses proposées (selon sentiment) → commerçant choisit/édite → publication API GBP
- **Plans** : suivi léger 29 € ou renforcé 49 €

### skill_audit_concurrence
- **Cible** : tous
- **Trigger WA** : « comment je me positionne face aux concurrents ? » ou « audit concurrence »
- **Exécution** : géolocalisation tenant → identification 5 concurrents les plus proches même métier → audit Module 7 condensé par concurrent → tableau comparatif WA + PDF
- **Plans** : suivi renforcé 49 € ou option avancée

### skill_relance_devis
- **Cible** : tous BTP/service
- **Trigger** : devis envoyé sans réponse > 7 jours
- **Exécution** : alerte hebdo WA + texte de relance polie proposé → validation commerçant → envoi SMS/email/WA
- **Plans** : suivi renforcé 49 € ou option avancée

### skill_alerte_avis_negatif
- **Cible** : tous
- **Trigger** : note < 3★ détectée
- **Exécution** : alerte prioritaire WA (notification push) + analyse contexte + réponse posée et professionnelle préparée + recommandation suivi commercial
- **Plans** : suivi renforcé 49 € ou option avancée

### skill_post_gbp_hebdo
- **Cible** : tous
- **Trigger WA** : photo chantier semaine envoyée
- **Exécution** : extraction EXIF géolocalisation → rédaction post selon métier → preview → publication GBP + Apple + Insta + site (galerie chantiers)
- **Plans** : suivi léger 29 € ou renforcé 49 €

### skill_horaires_exceptionnels
- **Cible** : tous
- **Trigger WA** : « vacances/fermé du [date] au [date] »
- **Exécution** : parsing dates → MAJ horaires exceptionnels GBP + Apple + Bing + OSM + site + bot WA basculé en mode différé
- **Plans** : suivi léger 29 € ou renforcé 49 €

### skill_veille_aides
- **Cible** : BTP, artisans
- **Trigger** : nouvelle aide détectée selon métier (MaPrimeRénov', CEE, aides locales)
- **Exécution** : résumé conditions éligibilité + propositions intégration devis
- **Plans** : suivi renforcé 49 € ou option avancée

### skill_quali_lead
- **Cible** : tous
- **Trigger** : lead WA entrant
- **Exécution** : score chaleur (urgent / chaud / tiède / froid) + qualif (devis / RDV / info) + escalade humaine si chaud + auto-réponse contextuelle si tiède/froid
- **Plans** : suivi léger 29 € ou renforcé 49 €

## 5. Architecture WhatsApp-First

```
[Commerçant abonné Willos]
   ↓ message ou photo WA
[Agent Willos (sous-agent tenant)]
   ↓ classification intention (Ollama 7B)
[Skill dispatcher]
   ↓ skill match (ex. skill_menu_du_jour)
[Skill execution + Hermes score]
   ↓ si score < 7 → re-générer avec modèle supérieur ou escalade
[Preview WA pour validation commerçant]
   ↓ OK ou modifications
[Action en chaîne]
   ├─ Google Business Profile API
   ├─ Apple Business Connect API
   ├─ Bing Places API
   ├─ OpenStreetMap édition agence
   ├─ Site internet (push Astro / plugin WP)
   ├─ MAJ llms.txt + agent-card si option avancée
   └─ Mémoire RAG (ChromaDB tenant)
   ↓
[Confirmation WA + lien vérification]
```

## 6. Stack IA hybride

### Répartition de charge (état réel, juin 2026)

- **Voie principale Mistral (France)** : conversation, extraction d'informations, OCR de documents (Pixtral) et transcription des messages vocaux (Voxtral) — traitement souverain UE
- **Routage hybride avec garde-fous** : classification d'intention déterministe d'abord, rattrapage sémantique ensuite, firewall anti-promesses sur chaque sortie
- **Bascule locale Ollama en déploiement** : objectif à terme, majorité du traitement en local souverain
- **Validation humaine systématique** : aucune publication externe sans accord explicite du commerçant

### Routage par tâche

| Tâche | Traitement |
|---|---|
| Classification intention | Déterministe d'abord, rattrapage sémantique ensuite |
| Conversation et extraction | Mistral (France) |
| Document / photo (OCR) | Pixtral (Mistral, UE) |
| Message vocal (transcription) | Voxtral (Mistral, UE) |
| Audit technique site internet | Moteur déterministe Willos (audit.py, lecture publique, zéro hallucination) |
| Contrôle des sorties | Firewall anti-promesses + validation humaine |

### Économie

L'infrastructure est mutualisée (serveur OVHcloud France) et l'audit technique est
déterministe (zéro coût IA) : le coût marginal par commerçant reste faible, ce qui
permet le modèle forfaitaire sans facturation au message.

## 7. Pricing et marges

Modèle pilote actuel :

| Offre | Prix | Objectif |
|---|---|---|
| Setup simple | 59 € one-shot | test live initial, fiche client, plan d'action de base |
| Setup avancé | 149 € one-shot | tri documents, extraction tarifs/services/FAQ, préparation textes et fichiers |
| Suivi léger | 29 €/mois | audit mensuel simple, alertes, petites corrections, agent WhatsApp simple |
| Suivi renforcé | 49 €/mois | avis, posts, fichiers site, agent plus proactif, anomalies priorisées |

Le setup motive l'acquisition. Le récurrent motive le suivi et la rétention. Les options lourdes (bot client 24/7 complet, multi-établissement, intervention webmaster, outbound strict opt-in) restent hors socle.

Tarifs pilotes de lancement : susceptibles d'ajustement avec les premiers retours pilotes ; le tarif applicable est celui confirmé par écrit avant souscription, sans effet rétroactif.

## 8. Souveraineté et conformité

### Hébergement

- **OVHcloud (France)** : moteur Willos (bot WhatsApp + API) hébergé en France, données en Union européenne
- **Pas de Cloud Act US** : aucune dépendance AWS/Azure/GCP pour le moteur Willos
- **Self-managed** acceptable car héritage OJO déjà self-managed

### Paiement

- **Vivawallet** : compte rattaché à la société Luxembourg
- ISV schema multi-tenant supporté
- Cards + Apple Pay + Google Pay + SEPA
- Webhooks notifications statut paiement
- Pas d'intermédiaire US

### WhatsApp

- **whatsapp-web.js** ou **Baileys** — pas de WhatsApp Business API officielle Meta
- Numéros dédiés par commerçant (pas le numéro perso)
- Conduite humanisée (délais 2-8s, volume < 200 conv/jour rodage)
- Watchdog OJO temps réel + numéro de secours pré-provisionné

### IA

- **Modèles européens en priorité** — Mistral (France) en voie principale, OCR Pixtral et transcription Voxtral souverains UE : vos données restent sur des serveurs UE
- **Bascule locale Ollama en déploiement** — objectif : majorité du traitement en local souverain, avec opt-out client possible (Phase 2)

### RGPD

- **1 contrat DPO par commerçant**
- **Isolation multi-tenant ChromaDB** stricte (collection par tenant_id)
- **Registre des traitements** maintenu
- **Droit à l'oubli** en un clic
- **Base légale identifiée** : exécution contrat + intérêt légitime pour outbound B2B

## 9. Standards 2026 supportés

### MCP (Model Context Protocol)
- Anthropic 2024, adopté OpenAI + ChatGPT + Claude
- Serveur MCP Willos exposé pour les commerçants avec option avancée
- URL : https://modelcontextprotocol.io

### A2A v1.0 (Agent2Agent)
- Linux Foundation, 150+ orgs (Microsoft, AWS, Salesforce, SAP, ServiceNow, PayPal, Atlassian, Cohere, MongoDB, Workday, UKG)
- Signed Agent Card publié par Willos
- Production deployments cités : Microsoft, AWS, Salesforce, SAP, ServiceNow

### AP2 v0.2 (Agent Payments Protocol)
- Google + écosystème, Apache 2.0
- Cryptographie ECDSA P-256 + SHA-256
- Verifiable Digital Credentials (VDC) tamper-evident
- Mandates Checkout + Payment (Open + Closed)

### UCP (Universal Commerce Protocol)
- Annoncé Sundar Pichai NRF 2026-01-11
- Google + Shopify + Etsy + Visa + 30 partenaires
- Apache 2.0
- 3 capabilities initiales : Checkout, Identity Linking, Order Management
- Architecture Willos UCP-ready dès Phase 1

### Schema.org + JSON-LD
- Organization + Service × N + FAQPage + BreadcrumbList + WebSite + SearchAction + OfferCatalog

### AI Agent Site UX (Google web.dev)
- HTML sémantique strict
- Accessibility tree propre
- Layout stable
- Labels lié aux inputs
- Éléments interactifs ≥ 8 px²

## 10. Promesse honnête

❌ **Ne JAMAIS dire** :
- « première place sur Google »
- « top 3 garanti »
- « positionnement en tête des IA »
- « visibilité immédiate »
- « devenez la référence locale »

✅ **Toujours dire** :
- « vos 7+ sources publiques cohérentes et complètes »
- « les écarts NAP cross-canal corrigés »
- « les manifestes IA conformes aux standards 2026 déposés sur votre site »
- « un commerce techniquement irréprochable face aux concurrents incomplets »
- « un audit mensuel léger ou renforcé selon l'abonnement »

Le pattern de l'ancien réseau de référencement local (qui a coulé sur ces fausses promesses) ne sera pas répliqué.

## 11. Histoire et roadmap

### Origine

Le projet Willos est né le 2026-05-15 d'un pivot B2B du moteur OJO (assistant IA personnel B2C du fondateur). OJO a accumulé ~70 % de code réutilisable (ChromaDB facts_db, Hermes scorer, llm_gateway, gatekeeper, pipeline, sous-agents Phase 4.7bis, whatsapp_bridge, nightly_brain) qui se transpose en Willos avec ajout multi-tenant.

### Marque

Le nom Willos a été tranché le 2026-05-20 après plusieurs semaines de recherche (tests Pedro → Manuel d'épelabilité au son seul). Trio TLD Gandi acquis simultanément (willos.fr canonique, willos.net app SaaS Phase 2+, willos.org défensif).

### Phase 0 (en cours) — validation marché

Mai-juin 2026. 7 paliers de test sans code pendant attente Google API (échéance 29/05-03/06) et Apple ABC Agency (échéance 27/05-10/06). Critère sortie : ≥ 3 pilotes signés.

### Phase 1 — MVP (juin/juillet 2026)

Estimation Claude-réaliste : 2-3 semaines clock-time. Forker OJO multi-tenant, brancher whatsapp-web.js, implémenter Module 7 crawler + Module 9 skills, Studio commerçant v1.

### Phase 2 — onboarding (parallèle été 2026)

Site commercial enrichi, onboarding No-Code, web app analytics commerçant.

### Phase 3 — roll-out (août-octobre 2026)

Manifestes niveau 2 (MCP + UCP + A2A + AP2), Module 8b outbound après cadrage juridique, skills avancés.

### Phase 4 — scale + regroupement OJO (Q4 2026 / Q1 2027)

15-30 commerçants stables, ARR > 1500 €/mois, GEX131 96 GB VRAM (Llama 3.3 70B en marge), dataset fine-tuning OJO depuis conversations anonymisées.

## 12. Concurrents et différenciation

### Bot WhatsApp commerçant
- **Wati** (HK, 50M$ ARR) — facturation au message, scripts arbres rigides, dépend WA Business API officielle
- **Respond.io** (Singapour) — idem Wati
- → Notre différenciation : LLM intelligent + souverain (pas Meta) + forfait clair + français

### Visibilité locale multicanal
- **Partoo** (FR leader) — SaaS abonnement, le commerçant se débrouille seul, agent IA Jim limité
- **Yext** (US) — marque blanche via agences, cher
- **Google Business Agent** (US-only, e-commerce ≥ 50 produits, Q&A produit uniquement) — incompatible artisans de service
- → Notre différenciation : service tout-fait, inclus dans forfait global, WhatsApp pour parler aux clients

### Agences GEO / Référencement IA
- **Eskimoz, NOIISE, Adimeo, Ellevate, Dity, Le Web 360°** — GEO de surface (contenu pour IA), aucune ne couple ça à un Bot WhatsApp 24/7
- → Notre différenciation : test live + agent client WhatsApp + sync/audit multicanal + skills métier modulaires + modèle TPE 29/49 €

### Notre océan bleu

Personne ne fait SIMULTANÉMENT :
1. Bot WhatsApp IA conversationnel
2. Souverain (pas Meta officiel)
3. Forfait mensuel clair (pas au message)
4. llms.txt + Manifestes MCP niveau 2
5. Sync multicanal 4 canaux (Google + Apple + Bing + OSM)
6. Audit identité multicanal 10 sources (Module 7 killer feature)
7. Catalogue skills métier modulaires (Module 9)
8. Architecture WhatsApp-First (zéro web app au démarrage)
9. Stack IA 80 % souverain (Ollama local)
10. Pour petits commerces TPE 29/49 €/mois

## 13. Pour développeurs et intégrateurs

### Endpoints utiles

- `https://willos.fr/llms.txt` — résumé pour LLM
- `https://willos.fr/llms-full.txt` — ce document
- `https://willos.fr/AGENTS.md` — manifeste agentique
- `https://willos.fr/.well-known/mcp-server.json` — MCP statique
- `https://willos.fr/.well-known/agent-card.json` — agent-card A2A
- `https://willos.fr/humans.txt` — manifeste humain
- `https://willos.fr/robots.txt` — allowlist bots IA
- `https://willos.fr/sitemap.xml` — sitemap

### Cibles bots autorisés (robots.txt)

GPTBot, ChatGPT-User, Anthropic, anthropic-ai, ClaudeBot, Google-Extended, GoogleOther, Googlebot, PerplexityBot, MistralAI, ByteSpider, Apple-PubSub, Applebot, Applebot-Extended, CCBot, Bingbot

### Contact technique

- Email : you@willos.fr
- Sujet préfixé : [TECH] ou [API] selon contexte

## Méta

- Dernière mise à jour : 2026-05-23
- Cadence de révision : ad-hoc selon évolutions Willos
- Licence : CC-BY-4.0
- Hash signature (v3) : à publier en Phase 2 quand serveur MCP live