L’agent ne décroche pas / l’appel échoue
- Vérifiez que l’agent est Publié (un brouillon ne sert pas les appels entrants). Voir Versions.
- Vérifiez que la configuration téléphonique est active et associée au bon numéro (voir Téléphonie).
- Vérifiez vos crédits. Un appel peut être refusé si le solde est épuisé (voir Facturation).
Le solde est insuffisant
Rechargez vos Crédits des modèles Bookivox ou configurez vos propres clés fournisseur (BYOK) dans Configurations de modèles. Le détail des deux systèmes de crédits est dans Facturation.L’agent ne répond pas correctement
- Prompt trop vague : précisez le rôle, le ton et les règles dans le nœud Étape agent.
- Variables manquantes : si le prompt utilise
{{template_variables}}mais que la valeur n’est pas fournie, l’agent peut poser une question incohérente. Voir Réglages de l’agent. - Base de connaissances absente : si l’agent doit répondre à des questions factuelles, associez-lui des documents (voir Fichiers de connaissance).
Le numéro de téléphone n’apparaît pas
- L’achat d’un numéro managé peut prendre quelques instants ; rafraîchissez la page Téléphonie.
- Pour un numéro externe (Twilio/Telnyx), vérifiez que les identifiants sont corrects et que l’URL de webhook pointée vers Bookivox est bien configurée.
Pas de transcription ni d’enregistrement
- L’enregistrement d’un appel est une option : vérifiez qu’elle est activée dans les réglages de l’agent.
- Certains fournisseurs téléphoniques ne transmettent pas l’audio des deux canaux : voir Exécutions pour les pistes séparées.
Erreurs d’API
Les codes renvoyés par l’API ont une signification précise :
Le détail complet est dans Erreurs (API).
Problèmes MCP / agents IA
- 401 / 403 : vérifiez que la clé API est bien passée dans l’en-tête
X-API-Keyet qu’elle dispose des scopes nécessaires. - Le client MCP ne se connecte pas : l’endpoint est
https://mcp.bookivox.com/en Streamable HTTP. - Voir Intégration MCP.