# 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`.

---

## Sommaire

1. Identité et statut juridique
2. Vision et positionnement
3. Catalogue services détaillé (Modules 1-9)
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
- **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** : Dumonshatf, 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 **apporteuse d'affaires** du réseau monétique du fondateur (plusieurs années de collaboration)
- Une **architecture multi-tenant souveraine** sur Hetzner Falkenstein DE
- 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** : inclus Lite (~500 conv/mois), Standard et Pro (conversations illimitées* sous garde-fou comportemental).

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

**Niveau 1 (Lite/Standard/Pro)** : llms.txt + AGENTS.md déposés sur le site du commerçant. Plugin WordPress/Shopify/Wix en un clic ou template mail webmaster.

**Niveau 2 (Pro seulement)** : 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** :
- Lite : Google Business Profile de base
- Standard : + Apple Business Connect
- Pro : + Bing Places + OpenStreetMap, actions automatiques

### 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 Pro qui veulent voir des graphes.

### Module 5 — Apporteur d'affaires IA (Phase 3-4)

Détection besoins matériaux dans les devis → propositions fournisseurs partenaires :
- Matériaux BTP : Point P (Saint-Gobain), Brico Dépôt Pro, Bigmat, Tout Faire Matériaux
- Outillage : Würth, Master Pro
- Plomberie : Cedeo (Saint-Gobain), Brossette
- Électricité : Rexel, Sonepar
- Pièces dépannage : Spareka, LDLC Pro

Architecture UCP-ready, AP2 mandates signés ECDSA P-256 pour autonomous commerce Phase 4.

### 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** :
- Lite : one-shot + top 3 actions
- Standard : mensuel + actions assistées
- Pro : hebdo + actions automatiques

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

### 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 +29 € Pro, Phase 2-3 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** : Standard + Pro

### 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** : tous (Lite si métier = resto seulement)

### 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** : tous

### 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** : Standard + Pro

### 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** : Standard + Pro

### 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** : Pro

### 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** : tous

### 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** : tous

### 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** : Pro

### 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** : tous

## 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 Pro
   └─ Mémoire RAG (ChromaDB tenant)
   ↓
[Confirmation WA + lien vérification]
```

## 6. Stack IA hybride

### Répartition de charge

- **80 % Ollama local** (Hetzner GEX44, RTX 4000 SFF Ada 20 GB GDDR6 ECC) : Llama 3.3 70B ou Qwen 3.6 MTP (benchmarking en cours)
- **15 % Gemini Flash cloud** : free tier 60 req/min + multimodal natif pour photos chantier
- **5 % Claude Sonnet 4.6** : juge qualité Hermes score 0-10 avant envoi commerçant/client
- **Test ponctuel ChatGPT GPT-4.1** : comparaison hors production uniquement

### Routage par tâche

| Tâche | Modèle |
|---|---|
| Classification intention | Ollama 7B (rapide, local) |
| FAQ, NAP, normalisation | Ollama Llama 3.3 70B local |
| Photo chantier / menu OCR | Gemini Flash multimodal |
| Audit complet site internet | Gemini Pro contexte 2M tokens |
| Juge qualité Hermes | Claude Sonnet 4.6 |
| Audit contentieux exceptionnel | Claude Opus 4.7 |

### Coût mensuel Phase 1 (30 commerçants pilotes)

- Hetzner GEX44 (Ollama dédié) : 184 €/mois
- Hetzner CCX23 (backend) : 25 €/mois
- Gemini Flash : ~10 €/mois (largement dans free tier)
- Claude Sonnet (Juge Hermes) : ~30 €/mois
- **Total IA : ~250 €/mois** soit ~8 €/commerçant
- Marge brute par client : 78-84 %
- Matos rentabilisé dès le 5e commerçant Standard

## 7. Pricing et marges

| Plan | Prix | Marge brute estimée | Profil client |
|---|---|---|---|
| Lite | 49 €/mois | ~38 € (78 %) | Artisan solo |
| Standard | 99 €/mois | ~83 € (84 %) | Artisan moyen |
| Pro | 149 €/mois | ~125 € (84 %) | TPE/PME ambitieuse, profession libérale |
| Option numéro fourni | +15 €/mois | variable | Tous plans |
| Option Outbound Pro | +29 €/mois | ~25 € | Pro Phase 2-3 |

MRR estimé Phase 1 (30 commerçants mix 30/50/20 %) : ~2 300 €/mois brut, ~84 % marge avant rémunération apporteuse.

## 8. Souveraineté et conformité

### Hébergement

- **Hetzner Falkenstein DE** : ISO/IEC 27001 + BSI C5 + 100 % énergie verte + ~700 km du Luxembourg = latence excellente vers FR
- **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

- **80 % traitement Ollama local** — vos données client restent sur nos serveurs Hetzner DE EU
- Gemini et Claude utilisés pour cas multimodaux ou juge qualité, 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 Pro
- 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 (Standard) ou hebdomadaire (Pro) »

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. Apporteuse d'affaires + 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, dashboard distributeur.

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

Manifestes niveau 2 (MCP + UCP + A2A + AP2), Module 5 affiliation (Point P, Brico Dépôt Pro, Würth), 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 : Bot WA + sync multicanal + audit Module 7 + skills métier modulaires + souverain + forfait TPE 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 49 €/mois
11. Vendu via réseau monétique pré-existant français

## 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-21
- 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