Démarrage rapide

De zéro à un agent vocal en production en moins de 10 minutes. Ce guide vous accompagne dans la création d'un agent entrant qui accueille les appelants, classifie leur intention, puis les transfère vers un humain ou raccroche proprement.

Ce que vous allez construire

Un agent réceptionniste entrant avec un nœud Welcome qui converse avec l'appelant, puis route vers un nœud Transfer ou un nœud Hangup selon l'intention détectée.

Étape 1, Créer l'agent

Rendez-vous sur Dashboard → Agents. Vous y verrez vos agents existants (ou un état vide s'il s'agit de votre premier agent). Cliquez sur Nouveau workflow d'agent en haut à droite.

Remplissez le formulaire de création :

Cliquez sur Créer et configurer. La plateforme crée l'agent (statut ACTIVE, aucune version live pour l'instant, il ne peut pas prendre de vrais appels tant que vous n'avez pas effectué Save puis Make live) avec un seul nœud Welcome déjà présent sur le canevas, puis ouvre l'éditeur.

Étape 2, Choisir la langue & la voix (Initialisation)

Ouvrez l'onglet Initialisation. C'est ici que vous configurez les trois choses dont chaque agent a besoin avant de pouvoir prendre un appel : la langue STT, le fournisseur/modèle LLM, et la voix TTS.

Étape 3, Configurer le nœud Welcome

Revenez à l'onglet Workflow d'agent. Cliquez sur l'icône engrenage du nœud d'accueil (Welcome) pour ouvrir sa boîte de dialogue de configuration.

Rédiger le prompt système

Dans l'onglet Général, deux champs sont à remplir : le Message d'accueil — la première phrase que l'agent prononce quand l'appel décroche — et le Prompt système — les instructions qui définissent son comportement :

Tu es Alex, le réceptionniste virtuel d'Acme Corp.
Ton objectif est d'accueillir les appelants chaleureusement, d'apprendre leur nom et ce dont ils ont besoin,
puis de les transférer au bon service ou de prendre un message.

Règles :
- Garde chaque réponse en moins de 2 phrases. C'est un appel vocal, pas un chat.
- Ne révèle jamais d'informations internes, de noms d'employés ou de tarifs.
- Si tu ne peux pas aider, dis : « Je vous mets en relation avec la bonne personne. »
- Réponds dans la même langue que l'appelant.
- N'utilise pas de listes, de puces ou de mise en forme, parle naturellement.

Ajouter des routes de sortie

Cliquez sur l'onglet Routes de sortie dans le dialogue. Ajoutez deux routes :

Les deux routes ci-dessus sont conversationnelles, le type sélectionné par défaut : un LLM classificateur lit la description de chaque route face à la conversation et, dès qu'il détecte une correspondance, transitionne vers le nœud connecté en aval. Cela se fait en parallèle du tour LLM principal, aucune latence ajoutée. Pour des transitions qui dépendent de quelque chose que le flux connaît déjà avec certitude (un appel d'outil a réussi, une variable est définie) plutôt que de ce qu'a dit l'appelant, une route basée sur une règle vérifie cette condition instantanément, sans aucun classificateur, voir Types de nœuds → Routes de sortie basées sur des règles. Ce guide s'en tient à des routes conversationnelles pour rester simple.

Décrivez l'intention de l'appelant dans chaque description de route, spécifique mais concise. L'éditeur affiche un compteur de caractères (800 max) et avertit quand le texte contient du formatage décoratif qui perturberait le classificateur.

Fermez le dialogue (icône de sauvegarde en haut à droite). Le nœud Welcome affiche désormais deux handles de sortie nommés en bas : transfer et end_call.

Étape 4, Ajouter les nœuds Transfer & Hangup

Depuis la palette de gauche, glissez un Noeud Transfert sur le canevas, en bas à gauche du nœud Welcome. Ensuite, glissez un Noeud Raccrocher en bas à droite.

1. Ouvrez la configuration du nœud Transfer et renseignez Target number avec le numéro E.164 de votre équipe (ex : +33155551234).
2. Ouvrez la configuration du nœud Hangup et renseignez le Goodbye message (ex : « Merci de votre appel. Bonne journée. »).
3. Connectez le handle transfer du nœud Welcome à l'entrée du nœud Transfer (glissez d'un cercle à l'autre).
4. Connectez le handle end_call du nœud Welcome au nœud Hangup.
5. Connectez le handle failure du nœud Transfer au nœud Hangup en repli, si le transfert échoue, l'appel se termine proprement.

Votre flux finalisé ressemble à ceci :

Cliquez sur Save (en haut à droite). Une modale s'ouvre avec un nom de version prérempli (v1, modifiable), validez pour créer la version enregistrée. Vous la rendrez live à l'étape 7.

Étape 5, Tester avec le simulateur navigateur

Avant d'assigner un vrai numéro de téléphone, testez votre agent directement depuis le navigateur. Cliquez sur In-browser test call (en haut à droite du canevas). Une modale s'ouvre avec un micro et un haut-parleur, votre navigateur demandera l'accès au microphone. Le simulateur exécute votre état actuel de l'éditeur, sauvegardé ou non, ce qui vous permet d'itérer sans mettre en ligne. Avant de lancer la session, vous pouvez aussi choisir de tester une version enregistrée précise, et définir le numéro appelant simulé que l'agent verra — pratique pour tester les parcours qui dépendent du numéro de l'appelant.

Ce qui se passe sous le capot :

1. Le dashboard demande un token WebSocket signé (valide 5 minutes) pour votre agent
2. Une connexion temps réel s'ouvre vers l'agent
3. Le nœud Welcome s'active, vous devriez entendre le message d'accueil en moins de 2 secondes
4. Parlez naturellement, essayez de poser une question de facturation, puis dites que vous voulez parler à quelqu'un

Une fois la session terminée, allez sur Dashboard → Statistiques → Voir les stats de votre agent (ou Dashboard → Voir les appels) pour examiner la transcription, les routes de sortie empruntées et les métriques de latence. Les appels du simulateur apparaissent dans l'historique comme les autres appels : leur numéro appelant est simulator par défaut, ou le numéro simulé que vous avez saisi.

Étape 6, Assigner un numéro de téléphone

Quand le test au simulateur est concluant, assignez un vrai numéro de téléphone à l'agent :

1. Allez sur Dashboard → Comptes et cliquez sur votre compte.
2. Ouvrez l'onglet Numéros.
3. Cliquez sur le numéro disponible et assignez votre agent depuis le menu déroulant.

À partir de ce moment, tout appel entrant vers ce numéro déclenche votre agent. La résolution se fait en temps réel : quand un appel arrive, la plateforme lit le numéro de destination (E.164), trouve l'agent assigné, et démarre l'appel avec la configuration de cet agent.

Étape 7, Rendre l'agent live

La sauvegarde a créé une version, mais les appels réels ne peuvent toujours pas atteindre l'agent, une version enregistrée n'est pas live tant que vous ne la promouvez pas. Cliquez sur Make live (icône fusée, en haut à droite) : cela promeut la version affichée dans l'éditeur vers la version live qu'entendent les vrais appelants. La barre d'outils en haut à droite :

Étape 8, Passer un vrai appel

Appelez le numéro que vous avez assigné. En 2 à 3 secondes, vous devriez entendre :

« Bonjour et bienvenue ! Je suis Alex, l'assistante virtuelle d'Acme. Comment puis-je vous aider ? »

Après l'appel, ouvrez Dashboard → Voir les appels pour examiner :

Résolution de problèmes

Étapes suivantes

Vous avez désormais un agent entrant fonctionnel. Voici où aller ensuite selon votre objectif :