Mon Espace

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

DomaineUsageStatut
assitance.amaana.frApplication principale (React + FastAPI)Actif
docs.amaana.frDocumentation techniqueActif
docs2.amaana.frDocumentation API clientActif
pres.amaana.frLanding page commercialeActif
moi.amaana.frEspace 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

CollectionContenu
usersComptes utilisateurs, roles, equipes
projectsProjets (multi-tenant)
agentsAgents IA (prompt, voix, modele, config)
agent_versionsHistorique des versions d'agents
scenariosWorkflows conversationnels (noeuds ReactFlow)
campaignsCampagnes d'appels sortants
voice_sessionsHistorique des appels + transcriptions
knowledge_baseBases de connaissances
toolsOutils/fonctions appelables par les agents
routing_rulesRegles de routage intelligent
tasksTaches post-appel
wfm_shiftsPlanning des shifts (WFM)
quality_scorecardsScorecards d'evaluation qualite
quality_evaluationsEvaluations qualite des appels
notificationsNotifications temps reel

Stack technique

Technologies utilisees dans le projet.

Frontend

TechnoUsageVersion
ReactFramework UI (SPA)18.x
Tailwind CSSStyling utilitaire3.x
ReactFlowEditeur de scenarios (noeuds)11.x
AxiosRequetes HTTP (withCredentials)1.x
RechartsGraphiques et charts2.x
WebSocketNotifications temps reelnatif
WebRTCTest appels en directnatif

Backend

TechnoUsageVersion
FastAPIFramework API REST0.100+
MongoDBBase de donnees NoSQL7.x
PyMongo / MotorDriver MongoDB-
bcryptHachage mots de passe-
PyJWTTokens HTTP-only cookies-
OpenAI SDKCopilot IA (GPT-4o-mini)1.x
ElevenLabs SDKTTS, Voice Cloning1.x

Infrastructure

TechnoUsage
NginxReverse proxy + SSL (Let's Encrypt)
SupervisorProcess manager (frontend + backend)
WazoServeur VoIP / SIP
AsteriskAGI pour la telephonie
Auth importante : Le backend utilise des cookies HTTP-only. Toutes les requetes frontend doivent utiliser axios avec { withCredentials: true }. Ne JAMAIS utiliser fetch avec des headers Authorization Bearer.

Serveurs & Infrastructure

Configuration serveur et informations d'acces.

VPS Principal

InfoValeur
Provider(votre provider VPS)
OSUbuntu / Debian
IP(votre IP serveur)
Acces SSHssh user@votre-ip

Ports utilises

PortService
80Nginx HTTP (redirection HTTPS)
443Nginx HTTPS (SSL)
3000React Frontend
8001FastAPI Backend
27017MongoDB
5060Wazo 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

MethodeRouteDescription
POST/api/auth/loginConnexion (retourne cookie)
POST/api/auth/registerInscription
POST/api/auth/logoutDeconnexion
GET/api/auth/meUtilisateur courant

CRUD principaux

RessourceBase URLOperations
Agents/api/agentsGET, POST, PUT, DELETE
Scenarios/api/scenariosGET, POST, PUT, DELETE
Campagnes/api/campaignsGET, POST, PUT, DELETE
Knowledge Base/api/knowledge-baseGET, POST, DELETE
Outils/api/toolsGET, POST, PUT, DELETE
Voice Sessions/api/voice-sessionsGET

Modules Centre d'appels

ModuleBase URLOperations
Copilot IA/api/copilot/analyzePOST
Routage/api/routing/rulesGET, POST, PUT, DELETE
Taches/api/tasksGET, POST, PUT, DELETE
WFM Shifts/api/wfm/shiftsGET, POST, PUT, DELETE
Qualite Scorecards/api/quality/scorecardsGET, POST
Qualite Evaluations/api/quality/evaluationsGET, POST

Integrations

ModuleRouteDescription
Voice Clone TTS/api/voice-clone/ttsSynthese vocale ElevenLabs
Voice Preview/api/voice-clone/preview/{voice_id}Apercu voix ElevenLabs
Orchestrateur/api/orchestrator/startDemarrer 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
Apres chaque modification de .env : relancer le service concerne avec sudo supervisorctl restart backend ou frontend.

Certificats SSL

# Renouveler les certificats Let's Encrypt
sudo certbot renew

# Verifier l'expiration
sudo certbot certificates
Important DNS : Avant d'ajouter un nouveau sous-domaine, verifier que l'enregistrement DNS pointe bien vers la bonne IP du serveur. Attendre la propagation avant de generer le certificat SSL.

Pitch & Proposition de valeur

Le positionnement commercial de L'Assistant.

Pitch en une phrase

L'Assistant est une plateforme Voice AI qui automatise votre standard telephonique avec l'intelligence artificielle — 24h/24, 7j/7, comme votre meilleur employe, mais qui ne dort jamais.

Probleme

ProblemeImpact
Appels manques en dehors des heures d'ouverturePerte de clients et de revenus
Secretariat couteux et indisponibleCharges fixes elevees, absences, turnover
Temps d'attente longInsatisfaction client, mauvais avis Google
Pas de suivi structure des appelsPas de data, pas d'amelioration

Solution

L'Assistant fournit un standard telephonique intelligent propulse par l'IA :

FonctionnaliteBenefice client
Reponse automatique 24/7Plus aucun appel perdu
Prise de RDV par telephoneAgenda rempli sans effort
Qualification automatique des leadsFocus sur les vrais prospects
Campagnes d'appels sortantsProspection a grande echelle
Analytics et emotionsDecisions basees sur la data
Copilot IA pour les agents humainsEquipe augmentee par l'IA

Differenciateurs cles

Multi-LLM : Choix entre OpenAI, Anthropic et Gemini — pas de lock-in.
Telephonie native : Integration directe Wazo/SIP, pas de bridge externe.
Omnicanal : Telephone + SMS + WhatsApp + Messenger + Instagram + Widget web.
Centre d'appels complet : Copilot IA, routage intelligent, WFM, gestion qualite.
Voice Cloning : Clonez votre propre voix avec ElevenLabs.

Cibles & Marche

Segments de marche et personas prioritaires.

Segments prioritaires

SegmentTailleDouleur principaleBudget
Cabinets medicauxEnormeAppels manques, secretariat debordeMoyen-Eleve
Cabinets dentairesGrandPrise de RDV manuelle chronophageMoyen
Agences immobilieresGrandLeads non qualifies, rappels oubliesMoyen-Eleve
Cabinets juridiquesMoyenTri des urgences, confidentialiteEleve
PME / TPEEnormePas de standard, 1 personne fait toutFaible-Moyen
Centres d'appelsMoyenCouts operationnels, turnover agentsEleve

Persona principal : Dr. Sarah

Dr. Sarah Benali — Dentiste, cabinet de 3 praticiens a Dijon. Recoit 80+ appels/jour. Sa secretaire est debordee. 30% des appels sont manques. Veut un standard automatise qui prend les RDV, repond aux questions et ne ferme jamais.

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

Ce pricing est un brouillon. A affiner en fonction des retours des premiers clients et du cout reel des API (LLM + TTS).

Grille tarifaire

PlanPrix/moisInclusCible
Starter49 EUR1 agent, 200 appels, analytics de baseTPE, freelance
Pro149 EUR5 agents, 1000 appels, campagnes, copilotPME, cabinets
Business349 EURAgents illimites, WFM, qualite, APICentres d'appels, ETI
EntrepriseSur devisSur mesure, SLA, support dedieGrands comptes

Couts variables a surveiller

ServiceCout unitaireImpact
OpenAI GPT-4o-mini~0.15$/1M tokens inputFaible
ElevenLabs TTS~0.18$/1000 charsMoyen (voix longues)
Twilio SMS~0.05$/SMSFaible
Twilio Voice~0.014$/minDepend du volume

Concurrence

Comparaison avec les solutions existantes.

Paysage concurrentiel

SolutionTypeForcesFaiblesses
Vapi.aiAPI Voice AIAPI robuste, multi-providerPas de UI, dev required, US-focused
Bland.aiVoice AI callsSimple a utiliser, rapidePas de centre d'appels, pas de CRM
Retell.aiVoice AIBonne qualite voixPas d'omnicanal, pas de WFM
AircallCentre d'appels cloudEtabli, integrationsPas d'IA vocale, cher
Genesys CloudCCaaS enterpriseTres completTres cher, complexe, pas adapte PME

Positionnement L'Assistant

L'Assistant = Voice AI + Centre d'appels complet + Omnicanal — au prix d'une PME, avec la puissance d'un Genesys.

Avantages competitifs

CritereL'AssistantVapi/BlandGenesys
Interface no-codeOuiNon (API)Oui
Telephonie nativeWazo/SIPAPI tiersNatif
Copilot IAOuiNonOui
WFM / QualiteOuiNonOui
Prix mensuel49-349 EURUsage1000+ EUR
Adapte PME FranceOuiUS-onlyEnterprise

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

ObjectionReponse
"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.

Rappel : Verifier regulierement les dates de renouvellement pour eviter les coupures de service.

Services IA & API

OpenAI

GPT-4o-mini pour le Copilot IA. Paiement a l'usage (tokens). Facture mensuelle automatique.

Usage /mois

ElevenLabs

Text-to-Speech et Voice Cloning. Plan selon le volume de caracteres. Renouvellement mensuel.

~29 EUR /mois

Telephonie & Messagerie

Wazo / SIP Trunk

Serveur VoIP et trunk SIP pour la telephonie. Licence + minutes d'appel.

Variable /mois

Twilio

SMS, WhatsApp, numeros de telephone. Paiement a l'usage.

Usage /mois

Hebergement

VPS (Hebergement)

Serveur de production. Ubuntu + Nginx + MongoDB + FastAPI + React.

~XX EUR /mois

Marketing & Email

Brevo (ex-Sendinblue)

Envoi d'emails automatiques post-appel et marketing. Plan gratuit jusqu'a 300 emails/jour.

Gratuit / 0-300 emails/j

CRM & Productivite

Odoo

CRM pour la gestion des leads et contacts. Version Community gratuite ou Enterprise payante.

Variable

Google Workspace

Google Calendar pour la synchronisation des rendez-vous. Inclus si vous avez deja Workspace.

~6 EUR /mois

Domaines

Gestion et renouvellement des noms de domaine.

Domaines actifs

DomaineUsageRegistrarRenouvellement
amaana.frDomaine principal(votre registrar)(date a renseigner)

Sous-domaines configures

Sous-domaineType DNSPointe versSSL
assitance.amaana.frAIP du VPSLet's Encrypt
docs.amaana.frAIP du VPSLet's Encrypt
docs2.amaana.frAIP du VPSLet's Encrypt
pres.amaana.frAIP du VPSLet's Encrypt
moi.amaana.frAIP du VPSA configurer
Pour ajouter un nouveau sous-domaine : 1) Creer l'enregistrement DNS A chez votre registrar. 2) Attendre la propagation (~5 min). 3) Configurer Nginx. 4) Generer le certificat SSL avec sudo certbot --nginx -d nouveau.amaana.fr.

Cles API

Gestion des cles API et tokens d'acces aux services externes.

Securite : Ne jamais exposer les cles API dans le code frontend. Toutes les cles sont stockees dans le fichier .env du backend.

Cles configurees

ServiceVariable .envOu la trouver
OpenAIOPENAI_API_KEYplatform.openai.com
ElevenLabsELEVENLABS_API_KEYelevenlabs.io
Twilio SIDTWILIO_ACCOUNT_SIDconsole.twilio.com
Twilio TokenTWILIO_AUTH_TOKENconsole.twilio.com
BrevoBREVO_API_KEYapp.brevo.com
Wazo TokenWAZO_TOKENInterface admin Wazo
MongoDBMONGO_URLConfiguration 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

TacheFrequenceCommande / Action
Verifier l'espace disque VPSMensueldf -h
Verifier les logs d'erreurHebdotail -100 /var/log/supervisor/*.err.log
Mettre a jour les paquets OSMensuelsudo apt update && sudo apt upgrade -y
Renouveler les certificats SSLAuto (90j)sudo certbot renew
Backup MongoDBHebdomongodump --db lassistant --out /backup/$(date +%Y%m%d)

Services & Paiements

TacheFrequenceAction
Verifier le solde OpenAIMensuelVerifier les credits restants sur platform.openai.com
Verifier le quota ElevenLabsMensuelVerifier les caracteres restants sur elevenlabs.io
Verifier le solde TwilioMensuelVerifier le credit restant sur console.twilio.com
Payer le VPSMensuelVerifier le renouvellement automatique
Renouveler le domaine amaana.frAnnuelVerifier la date d'expiration chez le registrar

Qualite & Performance

TacheFrequenceAction
Consulter les analyticsHebdoVoir les tendances dans l'app > Analytics
Verifier les evaluations qualiteHebdoVoir le score moyen dans Gestion Qualite
Tester un appel entrantMensuelAppeler le numero et verifier le comportement
Mettre a jour les bases de connaissancesMensuelAjouter les nouvelles FAQ et infos produit
Point critique : Si un service API (OpenAI, ElevenLabs, Twilio) est en rupture de credits, les appels continueront de fonctionner mais sans IA/voix. Surveiller les alertes email de chaque provider.