Mon Espace — L'Assistant
Tableau de bord personnel : technique, commercial et suivi des outils/paiements.
Acces rapides
Vue d'ensemble
Technique
Architecture, stack, serveurs, endpoints et procedures de deploiement.
Commercial
Pitch, cibles, pricing, concurrence et arguments de vente.
Paiements
Abonnements, domaines, cles API et checklist mensuelle.
Domaines du projet
| Domaine | Usage | Statut |
|---|---|---|
| assitance.amaana.fr | Application principale (React + FastAPI) | Actif |
| docs.amaana.fr | Documentation technique | Actif |
| docs2.amaana.fr | Documentation API client | Actif |
| pres.amaana.fr | Landing page commerciale | Actif |
| moi.amaana.fr | Espace personnel (cette page) | Nouveau |
Liens rapides
Tous les liens utiles du projet regroupes.
Application
Documentation
Services externes
Hebergement & DNS
Architecture
Vue globale de l'architecture technique de L'Assistant.
Schema global
Utilisateur (Navigateur)
|
v
[Nginx Reverse Proxy] --- SSL/HTTPS
|
+---> :3000 React Frontend (SPA)
+---> :8001 FastAPI Backend (API REST)
+---> :27017 MongoDB (Base de donnees)
|
+---> Wazo Server (VoIP / SIP / WebRTC)
+---> Asterisk AGI (Passerelle telephonie)
|
+---> OpenAI API (GPT-4o-mini — Copilot)
+---> ElevenLabs API (TTS, Voice Cloning)
+---> Twilio API (SMS, WhatsApp)
+---> Meta API (Messenger, Instagram)
+---> Brevo API (Emails)
+---> Odoo API (CRM)
+---> Google Calendar API
Flux d'un appel entrant
1. Appel entrant → Wazo SIP
2. Wazo → Asterisk AGI → Backend /api/agi/
3. Backend identifie l'agent assigne au numero
4. Backend ouvre WebSocket vers le frontend (Live)
5. STT transcrit l'audio en temps reel
6. LLM genere la reponse (prompt + knowledge base)
7. TTS (ElevenLabs) synthetise la voix
8. Audio retourne a l'appelant via Asterisk
9. Post-appel : analyse sentiment + extraction donnees
10. Notification WebSocket + stockage MongoDB
Base de donnees
| Collection | Contenu |
|---|---|
users | Comptes utilisateurs, roles, equipes |
projects | Projets (multi-tenant) |
agents | Agents IA (prompt, voix, modele, config) |
agent_versions | Historique des versions d'agents |
scenarios | Workflows conversationnels (noeuds ReactFlow) |
campaigns | Campagnes d'appels sortants |
voice_sessions | Historique des appels + transcriptions |
knowledge_base | Bases de connaissances |
tools | Outils/fonctions appelables par les agents |
routing_rules | Regles de routage intelligent |
tasks | Taches post-appel |
wfm_shifts | Planning des shifts (WFM) |
quality_scorecards | Scorecards d'evaluation qualite |
quality_evaluations | Evaluations qualite des appels |
notifications | Notifications temps reel |
Stack technique
Technologies utilisees dans le projet.
Frontend
| Techno | Usage | Version |
|---|---|---|
| React | Framework UI (SPA) | 18.x |
| Tailwind CSS | Styling utilitaire | 3.x |
| ReactFlow | Editeur de scenarios (noeuds) | 11.x |
| Axios | Requetes HTTP (withCredentials) | 1.x |
| Recharts | Graphiques et charts | 2.x |
| WebSocket | Notifications temps reel | natif |
| WebRTC | Test appels en direct | natif |
Backend
| Techno | Usage | Version |
|---|---|---|
| FastAPI | Framework API REST | 0.100+ |
| MongoDB | Base de donnees NoSQL | 7.x |
| PyMongo / Motor | Driver MongoDB | - |
| bcrypt | Hachage mots de passe | - |
| PyJWT | Tokens HTTP-only cookies | - |
| OpenAI SDK | Copilot IA (GPT-4o-mini) | 1.x |
| ElevenLabs SDK | TTS, Voice Cloning | 1.x |
Infrastructure
| Techno | Usage |
|---|---|
| Nginx | Reverse proxy + SSL (Let's Encrypt) |
| Supervisor | Process manager (frontend + backend) |
| Wazo | Serveur VoIP / SIP |
| Asterisk | AGI pour la telephonie |
axios avec { withCredentials: true }. Ne JAMAIS utiliser fetch avec des headers Authorization Bearer.Serveurs & Infrastructure
Configuration serveur et informations d'acces.
VPS Principal
| Info | Valeur |
|---|---|
| Provider | (votre provider VPS) |
| OS | Ubuntu / Debian |
| IP | (votre IP serveur) |
| Acces SSH | ssh user@votre-ip |
Ports utilises
| Port | Service |
|---|---|
80 | Nginx HTTP (redirection HTTPS) |
443 | Nginx HTTPS (SSL) |
3000 | React Frontend |
8001 | FastAPI Backend |
27017 | MongoDB |
5060 | Wazo SIP |
Chemins sur le serveur
/opt/lassistant/
├── backend/ # Code FastAPI
├── frontend/ # Build React
├── docs/ # docs.amaana.fr
├── docs2/ # docs2.amaana.fr
├── pres/ # pres.amaana.fr
├── moi/ # moi.amaana.fr
└── deploy/ # Scripts de deploiement
Commandes utiles
# Verifier les services
sudo supervisorctl status
# Logs backend
sudo tail -f /var/log/supervisor/backend.err.log
# Logs frontend
sudo tail -f /var/log/supervisor/frontend.err.log
# Restart services
sudo supervisorctl restart backend
sudo supervisorctl restart frontend
# Nginx
sudo nginx -t && sudo systemctl reload nginx
# MongoDB
sudo systemctl status mongod
mongosh
Endpoints cles
Les routes API les plus importantes a connaitre.
Authentification
| Methode | Route | Description |
|---|---|---|
| POST | /api/auth/login | Connexion (retourne cookie) |
| POST | /api/auth/register | Inscription |
| POST | /api/auth/logout | Deconnexion |
| GET | /api/auth/me | Utilisateur courant |
CRUD principaux
| Ressource | Base URL | Operations |
|---|---|---|
| Agents | /api/agents | GET, POST, PUT, DELETE |
| Scenarios | /api/scenarios | GET, POST, PUT, DELETE |
| Campagnes | /api/campaigns | GET, POST, PUT, DELETE |
| Knowledge Base | /api/knowledge-base | GET, POST, DELETE |
| Outils | /api/tools | GET, POST, PUT, DELETE |
| Voice Sessions | /api/voice-sessions | GET |
Modules Centre d'appels
| Module | Base URL | Operations |
|---|---|---|
| Copilot IA | /api/copilot/analyze | POST |
| Routage | /api/routing/rules | GET, POST, PUT, DELETE |
| Taches | /api/tasks | GET, POST, PUT, DELETE |
| WFM Shifts | /api/wfm/shifts | GET, POST, PUT, DELETE |
| Qualite Scorecards | /api/quality/scorecards | GET, POST |
| Qualite Evaluations | /api/quality/evaluations | GET, POST |
Integrations
| Module | Route | Description |
|---|---|---|
| Voice Clone TTS | /api/voice-clone/tts | Synthese vocale ElevenLabs |
| Voice Preview | /api/voice-clone/preview/{voice_id} | Apercu voix ElevenLabs |
| Orchestrateur | /api/orchestrator/start | Demarrer un scenario |
| AGI | /api/agi/ | Point d'entree Asterisk AGI |
Deploiement
Procedures de deploiement sur le VPS de production.
Deploiement complet (app principale)
# 1. Se connecter au serveur
ssh user@votre-ip
# 2. Aller dans le repertoire
cd /opt/lassistant
# 3. Recuperer les dernieres modifications
git pull origin main
# 4. Installer les dependances backend
pip install -r backend/requirements.txt
# 5. Build et deployer le frontend
sudo bash deploy/build_frontend.sh
# 6. Redemarrer les services
sudo bash deploy/update.sh
Deploiement des sites statiques
# Documentation technique
sudo bash deploy/build_docs.sh
# Documentation API
sudo bash deploy/build_docs2.sh
# Landing page
sudo bash deploy/build_pres.sh
# Espace personnel (cette page)
sudo bash deploy/build_moi.sh
Deploiement rapide (backend seul)
git pull origin main
pip install -r backend/requirements.txt
sudo supervisorctl restart backend
sudo supervisorctl restart backend ou frontend.Certificats SSL
# Renouveler les certificats Let's Encrypt
sudo certbot renew
# Verifier l'expiration
sudo certbot certificates
Pitch & Proposition de valeur
Le positionnement commercial de L'Assistant.
Pitch en une phrase
Probleme
| Probleme | Impact |
|---|---|
| Appels manques en dehors des heures d'ouverture | Perte de clients et de revenus |
| Secretariat couteux et indisponible | Charges fixes elevees, absences, turnover |
| Temps d'attente long | Insatisfaction client, mauvais avis Google |
| Pas de suivi structure des appels | Pas de data, pas d'amelioration |
Solution
L'Assistant fournit un standard telephonique intelligent propulse par l'IA :
| Fonctionnalite | Benefice client |
|---|---|
| Reponse automatique 24/7 | Plus aucun appel perdu |
| Prise de RDV par telephone | Agenda rempli sans effort |
| Qualification automatique des leads | Focus sur les vrais prospects |
| Campagnes d'appels sortants | Prospection a grande echelle |
| Analytics et emotions | Decisions basees sur la data |
| Copilot IA pour les agents humains | Equipe augmentee par l'IA |
Differenciateurs cles
Cibles & Marche
Segments de marche et personas prioritaires.
Segments prioritaires
| Segment | Taille | Douleur principale | Budget |
|---|---|---|---|
| Cabinets medicaux | Enorme | Appels manques, secretariat deborde | Moyen-Eleve |
| Cabinets dentaires | Grand | Prise de RDV manuelle chronophage | Moyen |
| Agences immobilieres | Grand | Leads non qualifies, rappels oublies | Moyen-Eleve |
| Cabinets juridiques | Moyen | Tri des urgences, confidentialite | Eleve |
| PME / TPE | Enorme | Pas de standard, 1 personne fait tout | Faible-Moyen |
| Centres d'appels | Moyen | Couts operationnels, turnover agents | Eleve |
Persona principal : Dr. Sarah
Parcours d'achat typique
1. Decouverte via Google ("standard telephonique IA") ou bouche a oreille
2. Visite de pres.amaana.fr — convaincue par les chiffres (98% d'appels decroches)
3. Test gratuit de l'app pendant 14 jours
4. Configuration en 10 minutes avec aide du support
5. Abonnement mensuel apres validation des resultats
Pricing
Structure tarifaire envisagee (a ajuster).
Grille tarifaire
| Plan | Prix/mois | Inclus | Cible |
|---|---|---|---|
| Starter | 49 EUR | 1 agent, 200 appels, analytics de base | TPE, freelance |
| Pro | 149 EUR | 5 agents, 1000 appels, campagnes, copilot | PME, cabinets |
| Business | 349 EUR | Agents illimites, WFM, qualite, API | Centres d'appels, ETI |
| Entreprise | Sur devis | Sur mesure, SLA, support dedie | Grands comptes |
Couts variables a surveiller
| Service | Cout unitaire | Impact |
|---|---|---|
| OpenAI GPT-4o-mini | ~0.15$/1M tokens input | Faible |
| ElevenLabs TTS | ~0.18$/1000 chars | Moyen (voix longues) |
| Twilio SMS | ~0.05$/SMS | Faible |
| Twilio Voice | ~0.014$/min | Depend du volume |
Concurrence
Comparaison avec les solutions existantes.
Paysage concurrentiel
| Solution | Type | Forces | Faiblesses |
|---|---|---|---|
| Vapi.ai | API Voice AI | API robuste, multi-provider | Pas de UI, dev required, US-focused |
| Bland.ai | Voice AI calls | Simple a utiliser, rapide | Pas de centre d'appels, pas de CRM |
| Retell.ai | Voice AI | Bonne qualite voix | Pas d'omnicanal, pas de WFM |
| Aircall | Centre d'appels cloud | Etabli, integrations | Pas d'IA vocale, cher |
| Genesys Cloud | CCaaS enterprise | Tres complet | Tres cher, complexe, pas adapte PME |
Positionnement L'Assistant
Avantages competitifs
| Critere | L'Assistant | Vapi/Bland | Genesys |
|---|---|---|---|
| Interface no-code | Oui | Non (API) | Oui |
| Telephonie native | Wazo/SIP | API tiers | Natif |
| Copilot IA | Oui | Non | Oui |
| WFM / Qualite | Oui | Non | Oui |
| Prix mensuel | 49-349 EUR | Usage | 1000+ EUR |
| Adapte PME France | Oui | US-only | Enterprise |
Arguments de vente
Points cles pour convaincre un prospect.
Les 5 arguments choc
1. "Plus aucun appel perdu"
98% des appels decroches, 24h/24, 7j/7. Meme la nuit, les weekends et les jours feries. Chaque appel manque est un client potentiel perdu.
2. "Votre meilleur employe — qui ne dort jamais"
L'IA repond comme un vrai humain, avec votre ton, vos instructions et vos connaissances metier. Les appelants ne font pas la difference.
3. "Operationnel en 10 minutes"
Pas besoin de competences techniques. Creez votre agent, connectez votre numero, c'est pret. Pas de semaines d'integration.
4. "-70% sur les couts de secretariat"
Un secretariat humain coute 2000-3000 EUR/mois. L'Assistant : 49-149 EUR/mois. ROI immediat des le premier mois.
5. "Des donnees que vous n'avez jamais eues"
Chaque appel est analyse : sentiment, intention, duree, sujet. Prenez des decisions basees sur la data, pas sur l'intuition.
Objections courantes
| Objection | Reponse |
|---|---|
| "Les gens n'aiment pas parler a un robot" | Les voix ElevenLabs sont quasi-indistinguables d'un humain. Et 78% des gens preferent une reponse immediate a une attente de 5 min. |
| "C'est trop complique a configurer" | 10 minutes pour etre operationnel. On fournit des templates pre-configures par metier. |
| "Et si l'IA se trompe ?" | L'IA est formee sur VOS connaissances. Et en cas de doute, elle transfere automatiquement vers un humain. |
| "C'est cher" | Moins cher qu'un mi-temps SMIC. Et disponible 24/7, jamais malade, jamais en vacances. |
Abonnements & Services
Liste des services payants a surveiller et renouveler.
Services IA & API
OpenAI
GPT-4o-mini pour le Copilot IA. Paiement a l'usage (tokens). Facture mensuelle automatique.
ElevenLabs
Text-to-Speech et Voice Cloning. Plan selon le volume de caracteres. Renouvellement mensuel.
Telephonie & Messagerie
Wazo / SIP Trunk
Serveur VoIP et trunk SIP pour la telephonie. Licence + minutes d'appel.
Twilio
SMS, WhatsApp, numeros de telephone. Paiement a l'usage.
Hebergement
VPS (Hebergement)
Serveur de production. Ubuntu + Nginx + MongoDB + FastAPI + React.
Marketing & Email
Brevo (ex-Sendinblue)
Envoi d'emails automatiques post-appel et marketing. Plan gratuit jusqu'a 300 emails/jour.
CRM & Productivite
Odoo
CRM pour la gestion des leads et contacts. Version Community gratuite ou Enterprise payante.
Google Workspace
Google Calendar pour la synchronisation des rendez-vous. Inclus si vous avez deja Workspace.
Domaines
Gestion et renouvellement des noms de domaine.
Domaines actifs
| Domaine | Usage | Registrar | Renouvellement |
|---|---|---|---|
| amaana.fr | Domaine principal | (votre registrar) | (date a renseigner) |
Sous-domaines configures
| Sous-domaine | Type DNS | Pointe vers | SSL |
|---|---|---|---|
| assitance.amaana.fr | A | IP du VPS | Let's Encrypt |
| docs.amaana.fr | A | IP du VPS | Let's Encrypt |
| docs2.amaana.fr | A | IP du VPS | Let's Encrypt |
| pres.amaana.fr | A | IP du VPS | Let's Encrypt |
| moi.amaana.fr | A | IP du VPS | A configurer |
sudo certbot --nginx -d nouveau.amaana.fr.Cles API
Gestion des cles API et tokens d'acces aux services externes.
.env du backend.Cles configurees
| Service | Variable .env | Ou la trouver |
|---|---|---|
| OpenAI | OPENAI_API_KEY | platform.openai.com |
| ElevenLabs | ELEVENLABS_API_KEY | elevenlabs.io |
| Twilio SID | TWILIO_ACCOUNT_SID | console.twilio.com |
| Twilio Token | TWILIO_AUTH_TOKEN | console.twilio.com |
| Brevo | BREVO_API_KEY | app.brevo.com |
| Wazo Token | WAZO_TOKEN | Interface admin Wazo |
| MongoDB | MONGO_URL | Configuration locale |
Verifier une cle
# Tester OpenAI
curl https://api.openai.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY" | head -c 200
# Tester ElevenLabs
curl https://api.elevenlabs.io/v1/voices \
-H "xi-api-key: $ELEVENLABS_API_KEY" | head -c 200
# Verifier .env backend
cat /opt/lassistant/backend/.env
Checklist mensuelle
A verifier chaque mois pour maintenir le service en bon etat.
Infrastructure
| Tache | Frequence | Commande / Action |
|---|---|---|
| Verifier l'espace disque VPS | Mensuel | df -h |
| Verifier les logs d'erreur | Hebdo | tail -100 /var/log/supervisor/*.err.log |
| Mettre a jour les paquets OS | Mensuel | sudo apt update && sudo apt upgrade -y |
| Renouveler les certificats SSL | Auto (90j) | sudo certbot renew |
| Backup MongoDB | Hebdo | mongodump --db lassistant --out /backup/$(date +%Y%m%d) |
Services & Paiements
| Tache | Frequence | Action |
|---|---|---|
| Verifier le solde OpenAI | Mensuel | Verifier les credits restants sur platform.openai.com |
| Verifier le quota ElevenLabs | Mensuel | Verifier les caracteres restants sur elevenlabs.io |
| Verifier le solde Twilio | Mensuel | Verifier le credit restant sur console.twilio.com |
| Payer le VPS | Mensuel | Verifier le renouvellement automatique |
| Renouveler le domaine amaana.fr | Annuel | Verifier la date d'expiration chez le registrar |
Qualite & Performance
| Tache | Frequence | Action |
|---|---|---|
| Consulter les analytics | Hebdo | Voir les tendances dans l'app > Analytics |
| Verifier les evaluations qualite | Hebdo | Voir le score moyen dans Gestion Qualite |
| Tester un appel entrant | Mensuel | Appeler le numero et verifier le comportement |
| Mettre a jour les bases de connaissances | Mensuel | Ajouter les nouvelles FAQ et infos produit |