Le quintet IA français pour TPE et artisans. Léon orchestre. Charlotte décroche le téléphone. Nina répond sur WhatsApp/SMS/email. Théo place en page 1 de Google. Manon crée le contenu réseaux sociaux. Cette documentation est destinée aux développeurs, intégrateurs et partenaires.
Démarrer en 5 min Swagger APICinq assistants spécialisés, orchestrés par Léon. Chacun a son périmètre, ses outils et sa voix.
Orchestrateur. Reçoit la requête tenant, route vers le bon assistant ou exécute une action via 13+ intents (devis, factures, sync HubSpot, audit SEO, etc.).
Voix IA Vapi. Décroche 24/7 sur le numéro tenant. FAQ, prise de RDV, transfert humain. Modèle Haiku 4.5.
WhatsApp + SMS + email. Templates configurables : RDV confirmé, J-1, avis Google, devis, relance. Meta Embedded Signup pour WA Business.
SEO/site. Sitemap auto, Search Console, mots-clés cibles, articles blog auto (rotation 10 sujets), backlinks annuaires.
Création de contenu réseaux sociaux, prêt à publier. Instagram, Facebook, LinkedIn, TikTok, YouTube. 48 posts/mois (texte + visuel), le client publie lui-même en 1 clic. Génération images Flux.dev + vidéos Wan 2.1.
Un client BTB (tenant) suit ces étapes après checkout Stripe :
POST /api/onboarding/profile — sauvegarde profil tenant
POST /api/onboarding/validate-siret — vérification SIRET
POST /api/onboarding/apply-templates — applique templates services
POST /api/tenant-profile/complete-onboarding — finalisation
L'API REST Boost Ta Boîte expose 368 endpoints sur 32 domaines d'intégration. Authentification JWT Bearer après login.
Swagger UI auto-généré (OpenAPI 3.1) :
| Domaine | Endpoints | Statut |
|---|---|---|
/api/leon/v3/* | chat, rag, history, voice | stable |
/api/jarvis/* | process, voice, text, status | stable |
/api/charlotte/* | demo-call, demo-chat, web-call-token | stable |
/api/vapi/* | webhook, calls | stable |
/api/whatsapp/* | embedded, templates, send | stable |
/api/seo/* | positions, keywords, sitemap | stable |
/api/social/* | providers, drafts, schedule | beta |
/api/integrations/* | hubspot, qonto, gmail, stripe | stable |
/api/quotes/*, /api/invoices/* | devis + factures multi-tenant | stable |
/api/admin/* | audit-logs, charlotte/provision (super-admin) | stable |
GET /healthz
GET /api/health
32 domaines d'intégration disponibles. La plupart se configurent via le wizard onboarding ou la page /dashboard/integrations.
Backend : FastAPI Python 3.12, PostgreSQL 15, SQLAlchemy. Frontend : Next.js 14 App Router, TypeScript, Tailwind. Infrastructure : Docker Compose sur VPS Hostinger. Modèles IA : Anthropic Claude Haiku 4.5 (par défaut tenants), Sonnet 4.6 (escalade).
Chaque requête est filtrée par tenant_id extrait du JWT. Forced everywhere via dépendance FastAPI. 87 tables PostgreSQL avec contrainte tenant_id sur toutes les tables non-globales.
POST /api/auth/login → JWT
GET /api/leon/v3/chat
Authorization: Bearer <JWT>
Pas de rate limit public actuellement (kill switch backend OUVERT). Tenant fair use surveillé.
Endpoints : /api/stripe/webhook, /api/vapi/webhook, /api/whatsapp/webhook. Validation signature Stripe webhook secret. Vapi token vérifié dans X-Vapi-Secret header.
Endpoint super-admin : POST /api/admin/tenant/create avec tenant_id=1 dans JWT. Plus simple : tenant fait son signup Stripe puis fait l'onboarding wizard.
Backup quotidien automatique à 03:15 (/usr/local/bin/btb-db-backup.sh). Stockage /root/backups/db/. Drill restore testé le 11/06/2026 (counts identiques).
Non. Code propriétaire Boost Ta Boîte. Sub-pages Notion partagée avec partenaires sur demande.