Documentation Boost Ta Boîte

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 API

Le quintet IA

Cinq assistants spécialisés, orchestrés par Léon. Chacun a son périmètre, ses outils et sa voix.

Léon

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.).

Charlotte

Voix IA Vapi. Décroche 24/7 sur le numéro tenant. FAQ, prise de RDV, transfert humain. Modèle Haiku 4.5.

Nina

WhatsApp + SMS + email. Templates configurables : RDV confirmé, J-1, avis Google, devis, relance. Meta Embedded Signup pour WA Business.

Théo

SEO/site. Sitemap auto, Search Console, mots-clés cibles, articles blog auto (rotation 10 sujets), backlinks annuaires.

Manon

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.

Quickstart tenant

Un client BTB (tenant) suit ces étapes après checkout Stripe :

  1. Step 1-2 — Métier + entreprise (SIRET, année)
  2. Step 3-4 — Adresse + horaires
  3. Step 5-6 — Services + clientèle
  4. Step 7-8 — Identité visuelle (logo, photos hero) + témoignages
  5. Step 9-10 — Site web + CRM existant
  6. Step 11 — Charlotte : script accueil + FAQ 10 Q/R + transfert humain
  7. Step 12 — Nina : numéro WA + 10 templates contextes
  8. Step 13 — Théo : 5 mots-clés primaires + 10 long-tail + GMB URL
  9. Step 14 — Manon : ton des publications à générer
  10. Step 15 — Validation finale → activation quintet

Endpoints onboarding

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

API publique

L'API REST Boost Ta Boîte expose 368 endpoints sur 32 domaines d'intégration. Authentification JWT Bearer après login.

Documentation interactive

Swagger UI auto-généré (OpenAPI 3.1) :

Swagger UI openapi.json

Domaines principaux

DomaineEndpointsStatut
/api/leon/v3/*chat, rag, history, voicestable
/api/jarvis/*process, voice, text, statusstable
/api/charlotte/*demo-call, demo-chat, web-call-tokenstable
/api/vapi/*webhook, callsstable
/api/whatsapp/*embedded, templates, sendstable
/api/seo/*positions, keywords, sitemapstable
/api/social/*providers, drafts, schedulebeta
/api/integrations/*hubspot, qonto, gmail, stripestable
/api/quotes/*, /api/invoices/*devis + factures multi-tenantstable
/api/admin/*audit-logs, charlotte/provision (super-admin)stable

Healthcheck

GET /healthz
GET /api/health

Intégrations

32 domaines d'intégration disponibles. La plupart se configurent via le wizard onboarding ou la page /dashboard/integrations.

CRM

  • HubSpot (OAuth)
  • Airtable (API key)
  • Bridge alias (universel)

Banque / compta

  • Qonto (OAuth)
  • Bridge / Powens
  • Photo facture Vision IA (TVA FR auto)

Communication

  • WhatsApp Business (Meta Embedded Signup)
  • SMS (Twilio, Brevo)
  • Email SMTP (Brevo, Gmail OAuth, SMTP custom)
  • Vapi (voix IA Charlotte)

Marketing / SEO

  • Google Search Console (Service Account)
  • Google My Business
  • IndexNow (Bing)
  • Génération de contenu multi-plateforme, prêt à publier (FB/IG/LinkedIn/TikTok/YT)

Paiement

  • Stripe Checkout (essai 7 jours)
  • Stripe Webhooks (subscription events)
  • Devis PDF signature électronique

Productivité

  • Google Calendar (sync)
  • Gmail (lecture + envoi)
  • Notion (carte technique tenant)
  • Slack (notifs équipe)

FAQ développeurs

Quelle stack technique ?

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).

Multi-tenant : isolation ?

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.

Comment authentifier l'API ?

POST /api/auth/login → JWT
GET /api/leon/v3/chat
Authorization: Bearer <JWT>

Rate limit ?

Pas de rate limit public actuellement (kill switch backend OUVERT). Tenant fair use surveillé.

Webhooks Stripe/Vapi/WhatsApp ?

Endpoints : /api/stripe/webhook, /api/vapi/webhook, /api/whatsapp/webhook. Validation signature Stripe webhook secret. Vapi token vérifié dans X-Vapi-Secret header.

Comment ajouter un tenant pilote ?

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.

Backups DB ?

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).

Open source ?

Non. Code propriétaire Boost Ta Boîte. Sub-pages Notion partagée avec partenaires sur demande.