Guide rapide

Creez, configurez et testez votre premier agent vocal IA en quelques minutes.

Creer votre premier Agent

Tester votre Agent

Appelez le numero assigne ou utilisez le test WebRTC integre pour verifier le comportement en temps reel. Retrouvez ensuite l'appel dans Monitorer > Appels pour voir la transcription et l'analyse.

Agents

Les agents sont le coeur de L'Assistant. Un agent est un assistant vocal IA configure avec un prompt, une voix, un modele de langage et des integrations optionnelles.

Creer un Agent

Onglets de configuration

Onglet Modele

Controle le "cerveau" de l'agent — ce qu'il dit, comment il raisonne et a quelles donnees il accede.

Message de bienvenue

Le premier message prononce au debut d'un appel. Laissez vide pour que l'agent attende que l'appelant parle en premier.

System Prompt

La configuration la plus importante. Definit l'identite, les instructions, le ton et les limites de l'agent. Redigez comme si vous formiez un employe reel.

Vous etes Sophie, receptionniste a la Clinique Dentaire Acme.
Votre role : repondre aux appels, planifier des rendez-vous,
repondre aux questions sur nos services.

Regles :
- Toujours saluer chaleureusement
- Demander le nom et le motif de l'appel
- Si rendez-vous demande, utiliser l'outil book_appointment
- Ne jamais donner de conseil medical
- En cas de doute, proposer un transfert au responsable

Configuration LLM

Onglet Voix

Onglet Analyse d'appel

L'analyse post-appel utilise un LLM pour extraire des donnees structurees de chaque transcription :

Bonnes pratiques

Versionning Agent

Suivez l'historique de chaque modification de vos agents et restaurez une version anterieure a tout moment.

Fonctionnement

Chaque sauvegarde de la configuration d'un agent cree une nouvelle version. L'onglet Versions affiche l'historique complet avec les changements effectues.

Restaurer une version

Cliquez sur une version pour voir son contenu, puis cliquez Restaurer pour revenir a cette configuration. La version actuelle sera sauvegardee comme une nouvelle entree.

Base de connaissances

Alimentez vos agents avec du contenu structure pour des reponses precises et contextuelles.

Creer une base

Ajoutez du contenu sous forme de texte, FAQ ou fiches produit. Liez ensuite la base a un ou plusieurs agents.

Parametres de recuperation

Outils

Definissez des fonctions et integrations API que vos agents peuvent appeler pendant les conversations.

Creer un outil

Chaque outil est defini par un nom, une description, un endpoint URL et des parametres au format JSON Schema. Quand le LLM determine qu'un outil doit etre appele, il extrait les parametres de la conversation et execute l'appel.

Scenarios

Concevez des workflows conversationnels multi-etapes avec un editeur visuel de noeuds.

Editeur visuel

L'editeur utilise un canvas de noeuds par glisser-deposer. Chaque scenario est compose de noeuds connectes entre eux formant un flux de conversation.

Types de noeuds

Templates

4 templates pre-configures : Support Client, Qualification Lead, Prise de Rendez-vous et Scenario vide.

Execution et test

Testez vos scenarios en temps reel via l'interface de chat integree. Le runner affiche les variables collectees, les actions executees et le statut d'avancement.

Canaux

Connectez vos agents a la telephonie, aux widgets web et aux plateformes de messagerie.

Telephonie SIP

Configurez votre connexion au serveur Wazo/SIP pour assigner des agents a des lignes telephoniques. Chaque ligne peut avoir un agent principal et un agent de fallback.

Widget Web

Integrez un widget de chat sur votre site web. Le code d'integration est genere automatiquement dans la configuration de l'agent.

A/B Testing

Assignez deux agents differents a une meme ligne avec une repartition configurable du trafic pour comparer les performances.

Types de canaux

Campagnes

Automatisez les appels sortants a grande echelle.

Creer une campagne

Parametres

Statuts

Messagerie

Configuration omnicanal pour SMS, WhatsApp, Facebook Messenger et Instagram.

SMS & WhatsApp (Twilio)

Connectez votre compte Twilio pour envoyer et recevoir des SMS et messages WhatsApp. La configuration se fait dans Deployer > Canaux.

Facebook Messenger

Connectez votre page Facebook pour recevoir et repondre aux messages Messenger via l'API Meta. Configuration dans Deployer > Canaux en cliquant sur la carte Messenger.

Instagram

Meme configuration que Messenger, avec en plus l'identifiant du compte Instagram Business pour recevoir les DM.

Appels & Transcriptions

Historique complet de tous les appels avec transcriptions et analyse des emotions.

Tableau des appels

Detection des emotions

Chaque appel termine est automatiquement analyse par LLM pour detecter les emotions : positif, neutre ou negatif. Cliquez sur un appel pour voir le detail de l'analyse.

Export

Exportez l'historique en PDF ou CSV pour vos rapports internes.

Analytics

Visualisez les performances de votre standard IA.

KPI principaux

Graphiques

Appels par jour, Distribution horaire, Motifs d'appel et Repartition du sentiment. Filtrez par periode : 24h, 7j, 14j ou 30j.

Insights Globaux

Tendances avancees, performance agents et analyse comparative.

Tendances avec comparaison

Chaque KPI compare la periode actuelle avec la periode precedente et affiche la variation en pourcentage.

Entonnoir de conversion

Visualisez le parcours : Appels → Termines → Leads avec les taux de conversion a chaque etape.

Performance Agents

Classement par nombre d'appels, taux de completion, duree moyenne et satisfaction client.

Heatmap d'activite

Carte de chaleur (heure × jour de la semaine) pour identifier vos pics d'appels.

Top Appelants

Liste des 10 appelants les plus frequents.

Revue Qualite

Evaluez et notez la qualite de traitement de chaque appel.

Revue detaillee avec notation multi-criteres : qualite de la reponse, respect du script, satisfaction client. Export PDF/CSV disponible.

API Reference

L'API publique de L'Assistant donne un acces programmatique a vos donnees d'appels, agents et bases de connaissances. Integrez L'Assistant a votre CRM, data warehouse ou tout systeme externe.

URL de base

https://assitance.amaana.fr/api

Ressources disponibles

Format de reponse

Toutes les reponses sont au format JSON :

{
  "data": [...],
  "pagination": {
    "total": 142,
    "limit": 100,
    "offset": 0
  }
}

Codes d'erreur

Limite de debit

L'API est limitee a 120 requetes par minute par adresse IP.

Authentification

Toutes les requetes API doivent inclure un token valide dans le header Authorization.

Obtenir un token

Endpoint de login

curl -X POST https://assitance.amaana.fr/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "votre@email.com", "password": "votre_mdp"}' \
  -c cookies.txt

Utiliser le cookie

curl https://assitance.amaana.fr/api/agents \
  -b cookies.txt

Erreurs courantes

Appels

Recuperez l'historique des appels de votre projet.

Lister les appels

Retourne la liste des sessions vocales avec transcriptions et analyses.

curl https://assitance.amaana.fr/api/voice-sessions \
  -b cookies.txt

Parametres de requete

Reponse

[
  {
    "session_id": "abc123",
    "caller_number": "+33612345678",
    "status": "completed",
    "duration_sec": 45,
    "total_interactions": 6,
    "created_at": "2026-03-29T10:30:00Z",
    "summary": {
      "sentiment": "positif",
      "subject": "Demande de rendez-vous"
    }
  }
]

Detail d'un appel

Retourne le detail complet d'un appel avec les messages.

Agents

CRUD complet sur vos agents vocaux.

Lister les agents

curl https://assitance.amaana.fr/api/agents -b cookies.txt

Creer un agent

curl -X POST https://assitance.amaana.fr/api/agents \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "name": "Mon Agent",
    "description": "Agent d accueil",
    "system_prompt": "Vous etes un assistant...",
    "provider": "openai",
    "model": "gpt-4o",
    "temperature": 0.5
  }'

Modifier un agent

Supprimer un agent

Connaissances

Gestion des bases de connaissances via l'API.

Lister les bases

Creer une entree

curl -X POST https://assitance.amaana.fr/api/knowledge-base \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "title": "FAQ Produit",
    "content": "Question: Quels sont vos horaires?\nReponse: Du lundi au vendredi, 9h-18h."
  }'

Supprimer une entree

Campagnes

Gestion des campagnes d'appels sortants.

Lister les campagnes

Creer une campagne

curl -X POST https://assitance.amaana.fr/api/campaigns \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "name": "Campagne Mars",
    "agent_id": "...",
    "agent_name": "Mon Agent",
    "outbound_number": "+33974660190",
    "send_date": "2026-04-01",
    "send_time": "14:00",
    "max_concurrent": 5,
    "recipients": ["+33612345678", "+33698765432"]
  }'

Modifier une campagne

Supprimer une campagne

Scenarios

Gestion des scenarios et execution via l'API.

Lister les scenarios

Creer un scenario

Demarrer une execution

curl -X POST https://assitance.amaana.fr/api/orchestrator/start \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "scenario_id": "...",
    "channel": "api"
  }'

Envoyer un input

curl -X POST https://assitance.amaana.fr/api/orchestrator/step \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "execution_id": "...",
    "user_input": "Jean Dupont"
  }'

Lister les executions