Questions fréquentes et dépannage
Trouvez la réponse aux questions courantes et la solution aux messages d'erreur que Flowtative peut afficher.
Cette page rassemble les questions les plus fréquentes et explique les messages d'erreur que vous pouvez rencontrer, fonction par fonction. Les messages sont cités tels qu'ils s'affichent dans l'application. Utilisez la recherche de votre navigateur (⌘F / Ctrl+F) pour retrouver un message précis. Vous partez d'un symptôme sans message d'erreur ? Voir Dépannage par symptôme. Pour savoir ce qui a changé récemment, voir Nouveautés.
Lire un message d'erreur
Beaucoup de messages se terminent par un code entre parenthèses, par exemple « Création du flow impossible (403). ». Ce code indique la nature du problème :
| Code | Signification | Que faire |
|---|---|---|
400 | La demande contient une valeur refusée. | Vérifiez les champs saisis. |
401 | Votre session n'est plus valide. | Rechargez la page. Si le message persiste, reconnectez-vous. |
403 | Votre compte n'a pas le droit d'effectuer cette action. | Demandez à un administrateur de vérifier votre rôle (voir Équipe et rôles). |
404 | L'élément n'existe plus (supprimé entre-temps). | Rechargez la liste. |
409 | Conflit : un élément porte déjà ce nom ou a été modifié entre-temps. | Rechargez, puis refaites l'action. |
413 | Le fichier envoyé est trop volumineux. | Découpez le fichier. |
500 à 503 | Le service est momentanément indisponible. | Réessayez dans quelques minutes, puis contactez le support si le problème persiste. |
Quand un chargement échoue, la plupart des écrans affichent un bouton Réessayer.
Connexion et compte
Selon la configuration de votre espace, l'écran de connexion demande l'Organisation (l'identifiant de votre espace), l'Identifiant et le Mot de passe, ou propose Continuer avec le SSO ViaDialog.
| Message | Que faire |
|---|---|
| « Organisation, identifiant et mot de passe sont requis. » | Renseignez les trois champs. |
| « Saisissez l'identifiant de votre organisation. » | Saisissez l'identifiant de votre espace avant de lancer le SSO. |
| « Connexion impossible. » | Vérifiez vos identifiants. Si vous ne connaissez pas l'identifiant de votre organisation, demandez-le à votre administrateur (mention Besoin d'aide ? Contactez votre administrateur sous le formulaire). |
Cochez Rester connecté sur l'écran de connexion. Pendant votre travail, votre session est renouvelée automatiquement.
Dans Paramètres > Profil. Le mot de passe doit faire au moins 6 caractères. Voir Paramètres et connecteurs.
Changez la Langue dans Paramètres > Profil. Le changement est immédiat.
Les listes conservent leur recherche, leurs filtres et leur page quand vous les quittez. Cliquez sur Réinitialiser pour effacer les filtres de la liste.
Paramètres > Profil, puis Relancer le parcours.
Agents et tests
Donnez un nom à l'agent avant de l'enregistrer.
Le test vocal fonctionne uniquement sur un agent enregistré. Enregistrez l'agent, puis relancez le test. Voir Tester un agent.
L'appel de test n'a pas pu démarrer. Vérifiez que votre navigateur a l'autorisation d'utiliser le micro, puis réessayez. Si le message comporte un code 5xx, réessayez quelques minutes plus tard.
Votre navigateur ne permet pas la lecture audio utilisée par l'application. Utilisez une version récente de Chrome, Edge, Firefox ou Safari.
Certaines variables de test n'ont pas été envoyées à l'appel vocal parce que leur nom est invalide ou en double. Renommez-les puis relancez le test.
La connexion a été coupée pendant que l'agent répondait. Vérifiez votre réseau et renvoyez votre message.
Quand vous reliez une base de connaissances à un agent, Flowtative crée l'outil de recherche correspondant. Ici, sa création a échoué et l'agent n'a pas été enregistré. Réessayez. Le message « Catalogue d'outils indisponible : l'outil de recherche de la base n'a pas pu être lié. Réessayez. » appelle la même action. Voir Relier une base à un agent.
Flows et outils
Les noms de flow sont uniques. Choisissez un autre nom, par exemple en ajoutant le canal ou la version (Prise de RDV — voix v2).
Le fichier importé n'est pas un export de flow Flowtative. Exportez de nouveau le flow depuis l'éditeur, sans modifier le fichier.
Le flow n'a jamais été enregistré : il n'a donc aucune version antérieure. Enregistrez-le d'abord. Voir Enregistrer et publier.
Un outil de type HTTP doit avoir une URL. Renseignez-la, ou importez la requête avec Importer depuis une commande cURL.
Collez la commande complète, en commençant par curl, telle que copiée depuis votre outil de test d'API.
Le gabarit contient une erreur de syntaxe (virgule en trop, guillemet manquant). Corrigez-le. Chaque placeholder du gabarit doit aussi être déclaré en paramètre.
Le test fonctionne uniquement sur un outil enregistré.
Un outil issu d'un serveur MCP n'existe plus sur ce serveur. Détachez-le de vos agents ou supprimez-le. Voir Serveurs MCP.
Connaissances
Découpez le document en plusieurs fichiers puis importez-les séparément. Voir Bases de connaissances.
La connexion d'une source externe (Mayday, Zendesk, Stonly, Mindsay) exige une base existante. Créez une base dans Connaissances, puis revenez dans Paramètres > Connecteurs.
Regardez l'état affiché sur la carte Mindsay. Synchros seules signifie que les changements arrivent à la prochaine synchronisation, et non en temps réel.
Campagnes d'appels sortants
Le numéro présenté doit être un numéro valide, par exemple +33972101001.
Choisissez un numéro fixe ou non géographique comme numéro présenté.
En prospection, le numéro présenté doit appartenir aux plages réservées à cet usage. Utilisez un numéro de ces plages, ou choisissez un autre type de campagne si l'appel ne relève pas de la prospection.
Depuis le 11 août 2026, la prospection téléphonique exige l'accord préalable du contact (opt-in). Le fichier de contacts doit donc comporter une colonne de consentement. Voir Campagnes.
Leur numéro n'est pas exploitable. Les fiches exclues sont listées mais ne bloquent pas le lancement. Corrigez-les dans votre fichier si nécessaire.
La campagne existe mais n'a pas pu démarrer, car sa configuration est incomplète. Ouvrez-la, complétez ce qui est indiqué, puis relancez-la. Voir Suivre et gérer une campagne.
La réinitialisation d'un contact demande un rôle d'administrateur. Demandez à un Administrateur ou à un Admin service de la faire.
Validations humaines
Un autre validateur a traité la demande avant vous. Aucune action n'est nécessaire.
Actualisez la file de la console Validations. La demande a probablement été traitée ou a expiré.
Un ou plusieurs champs du formulaire de validation ne respectent pas les règles attendues. Corrigez les champs listés et renvoyez. Voir Validations humaines.
Le délai de traitement est dépassé et le flow a emprunté la sortie Timeout. Pour ne plus manquer une demande, activez les Notifications navigateur dans Paramètres > Notifications, ou allongez le Délai max du bloc Validation humaine.
Suivi et qualité
La supervision en temps réel n'est pas encore activée sur votre espace. Contactez votre interlocuteur ViaDialog.
Saisissez la date au format jour/mois/année, par exemple 16/10/2026.
Webhooks
Vérifiez dans l'ordre :
- Le webhook est actif (interrupteur allumé) dans Paramètres > Webhooks.
- Il est coché dans la section Webhooks de l'agent, et l'agent a été enregistré.
- Il n'affiche pas l'avertissement « N'écoute pas BOT_SESSION_ENDED ».
- Le journal Livraisons en échec ne contient pas d'erreur. S'il en contient, la description et le contenu vous indiquent la cause.
Calculez la signature sur le corps brut reçu, avant tout décodage JSON, et utilisez le secret le plus récent. Après une rotation, l'ancien secret ne fonctionne plus. Voir Vérifier la signature.
Il ne peut pas être réaffiché. Générez-en un nouveau avec l'icône de clé, puis mettez à jour votre serveur.
Le webhook existe, mais son secret n'a pas pu être généré. Cliquez sur l'icône de clé du webhook pour le générer.
Téléphonie
Dans Paramètres > Téléphonie & Trunk, partie Numéros entrants, cliquez sur le nom de l'agent affiché à côté du numéro et choisissez le bon.
Vérifiez que la ligne du numéro est activée (interrupteur allumé, ligne non estompée) et qu'un agent y est relié.
Dérive : ouvrez le trunk avec Modifier puis enregistrez-le pour réaligner la plateforme. Non vérifié : la plateforme de routage est injoignable, cliquez sur Actualiser un peu plus tard. Le détail de chaque état et des messages d'erreur figure dans Téléphonie.
L'adresse du PBX doit être son adresse publique sur Internet, pas une adresse de votre réseau interne.
Équipe
C'est voulu : demandez à un autre administrateur de le faire.
Votre rôle ne permet pas de modifier les autres membres. Le changement a été annulé. Demandez à un Administrateur.
Le retrait est immédiat et sans confirmation. Contactez votre administrateur ViaDialog pour recréer son accès. Pour un retrait temporaire, utilisez plutôt Suspendre.
Pour aller plus loin
Paramètres et connecteurs
Gérez votre profil, vos préférences d'affichage, vos connecteurs de connaissances et d'agenda, et vos serveurs MCP.
Webhooks
Recevez le transcript complet de chaque session sur votre serveur, signé pour en garantir l'origine.
Téléphonie
Connectez vos numéros à vos agents vocaux et déclarez les trunks SIP de votre standard téléphonique.
Dépannage par symptôme
partir de ce que vous constatez, sans message d'erreur.