# Bookivox

> Documentation Bookivox : créez et pilotez des agents vocaux IA, campagnes d'appels, base de connaissance, outils et intégrations, avec une API REST complète et un serveur MCP.

- [Introduction](https://docs.bookivox.com/getting-started.md): Bookivox est une plateforme d'agents vocaux IA : créez des agents qui répondent au téléphone et parlent à vos clients, avec un éditeur de workflow visuel.
- [Prérequis](https://docs.bookivox.com/getting-started/prerequisites.md): Ce dont vous avez besoin avant de créer votre premier agent vocal sur Bookivox : compte, crédits, numéro de téléphone et clés de modèles.
- [Premier agent en 5 minutes](https://docs.bookivox.com/getting-started/first-agent.md): Créez, testez et publiez votre premier agent vocal Bookivox, sans configuration téléphonique.
- [Dépannage](https://docs.bookivox.com/getting-started/troubleshooting.md): Solutions aux problèmes courants : appels qui échouent, agent qui ne répond pas, crédits insuffisants, numéro non reçu, transcription manquante.
- [VoxBuilder](https://docs.bookivox.com/voxbuilder/overview.md): Décrivez votre agent en langage naturel : VoxBuilder génère le workflow complet, prêt à tester.
- [WebVox](https://docs.bookivox.com/webvox/overview.md): Configurez le widget web de votre agent : apparence, comportement, et récupérez le code d'intégration à copier sur votre site.
- [Agents vocaux](https://docs.bookivox.com/workflow/overview.md): La liste de vos agents : dossiers, création, archivage et accès à l'éditeur.
- [Créer un agent](https://docs.bookivox.com/workflow/creating-an-agent.md): Trois méthodes pour démarrer : générer avec VoxBuilder, partir d'un canvas vide, ou importer un workflow JSON.
- [Le canevas du builder](https://docs.bookivox.com/workflow/builder-canvas.md): L'éditeur de workflow : barre d'outils, canevas, ajout de nœuds, et le dialogue d'édition des nœuds avec ses trois onglets.
- [Onglet Général](https://docs.bookivox.com/workflow/node-general.md): Les propriétés d'un nœud : nom, prompt, voix, modèle et transitions, affichées dynamiquement selon le type de nœud.
- [Onglet Intégrations](https://docs.bookivox.com/workflow/node-tools.md): Attachez des outils à un nœud : appels HTTP, transfert et fin d'appel, choisis parmi vos intégrations actives.
- [Onglet Connaissance](https://docs.bookivox.com/workflow/node-knowledge.md): Attachez des documents à un nœud pour que l'agent réponde à partir de votre base de connaissance.
- [Guide de prompting](https://docs.bookivox.com/guides/prompting-guide.md): Comment écrire les prompts de vos agents vocaux : structure, variables, garde-fous, gestion des objections et bonnes pratiques.
- [Réglages de l'agent](https://docs.bookivox.com/workflow/agent-settings.md): Les huit sections de configuration d'un agent : général, modèles, variables, dictionnaire, messagerie vocale, enregistrements, rapport et identité.
- [Tester et publier](https://docs.bookivox.com/workflow/testing-and-versions.md): Le cycle brouillon → publication : tester en texte et en audio, gérer les versions, puis publier pour servir les appels réels.
- [Exécutions d'un agent](https://docs.bookivox.com/workflow/runs.md): L'historique des appels d'un agent : transcriptions, résumés, données collectées et coûts, accessibles depuis la barre d'outils du canevas.
- [Nœud Départ d'appel](https://docs.bookivox.com/workflow/nodes/start-call.md): Le point d'entrée du workflow : message d'accueil, prompt initial, extraction de variables et chargement de données avant l'appel.
- [Nœud Étape agent](https://docs.bookivox.com/workflow/nodes/agent.md): Le nœud central du workflow : prompt, interruption, extraction de variables, outils et documents associés.
- [Nœud Fin d'appel](https://docs.bookivox.com/workflow/nodes/end-call.md): Le nœud terminal qui clôture la conversation : prompt de sortie, ajout du prompt global et extraction d'ultime minute.
- [Nœud Global](https://docs.bookivox.com/workflow/nodes/global.md): La persona et les règles transverses appliquées à tous les nœuds qui activent le prompt global.
- [Nœud Déclencheur](https://docs.bookivox.com/workflow/nodes/trigger.md): Le point d'entrée API : chemin personnalisé et corps de requête accepté pour déclencher un appel depuis un système externe.
- [Nœud Webhook](https://docs.bookivox.com/workflow/nodes/webhook.md): L'appel HTTP sortant déclenché après l'appel : méthode, URL, authentification, en-têtes personnalisés et modèle de charge utile.
- [Nœud QA](https://docs.bookivox.com/workflow/nodes/qa.md): Évaluer automatiquement la qualité d'un appel après sa fin : critères, échantillonnage, modèle d'analyse.
- [Campagnes](https://docs.bookivox.com/campaigns/overview.md): Lancez des appels sortants en masse à partir d'un fichier CSV, avec concurrence, reprises et planning.
- [Créer une campagne](https://docs.bookivox.com/campaigns/creating-a-campaign.md): Nom, agent, configuration téléphonique, contacts (CSV ou saisie manuelle) et réglages avancés.
- [Suivre une campagne](https://docs.bookivox.com/campaigns/monitoring.md): Le détail d'une campagne : statistiques, paramètres, journal d'activité, exécutions liées et rapport téléchargeable.
- [Intégrations](https://docs.bookivox.com/integrations/overview.md): Créez des outils réutilisables (appel HTTP, transfert, fin d'appel, calcul, Calendly, MCP) et attachez-les à vos agents.
- [Intégration : Appel HTTP](https://docs.bookivox.com/integrations/http-api.md): Créez un outil API HTTP pour que vos agents interrogent vos propres services pendant la conversation : URL, méthode, en-têtes, paramètres LLM, paramètres prédéfinis et authentification.
- [Intégration : Calendly](https://docs.bookivox.com/integrations/calendly.md): Connectez Calendly à Bookivox pour que vos agents proposent, réservent, retrouvent, annulent ou replanifient des rendez-vous.
- [Bibliothèque de templates](https://docs.bookivox.com/templates/overview.md): Partez d'un agent prêt à l'emploi : templates de la communauté, populaires, ou de votre organisation. Publiez et importez vos propres templates.
- [Publier et importer un template](https://docs.bookivox.com/templates/publishing.md): Publier un de vos agents comme template, et importer un template dans votre organisation.
- [Voix et modèles](https://docs.bookivox.com/configurations/voices.md): Choisissez les voix et les modèles utilisés par vos agents : catalogue managé Bookivox ou vos propres clés (BYOK).
- [Téléphonie : Vue d'ensemble](https://docs.bookivox.com/telephony/overview.md): Configurez la téléphonie de Bookivox : numéros managés Bookivox ou vos propres fournisseurs (Twilio, Vonage, Telnyx, Plivo, Vobiz, Cloudonix, ARI).
- [Configurations téléphoniques](https://docs.bookivox.com/telephony/configurations.md): Créez une configuration téléphonique : choisissez un fournisseur, saisissez les identifiants et associez un ou plusieurs numéros à un agent.
- [Numéros de téléphone](https://docs.bookivox.com/telephony/phone-numbers.md): Le détail d'une configuration téléphonique : ses identifiants et la liste de ses numéros avec leurs agents entrants.
- [Acheter un numéro](https://docs.bookivox.com/telephony/buying-numbers.md): Achetez un numéro de téléphone managé Bookivox en trois étapes, sans compte fournisseur externe.
- [Numéro managé Bookivox](https://docs.bookivox.com/telephony/providers/bookivox-number.md): Achetez un numéro directement dans Bookivox : aucun compte opérateur, aucun identifiant à fournir. La plateforme gère le numéro de bout en bout.
- [Twilio](https://docs.bookivox.com/telephony/providers/twilio.md): Branchez votre propre compte Twilio (BYOK) : Account SID et Auth Token, détection de répondeur (AMD), signature des webhooks et gestion des numéros E.164.
- [Vonage](https://docs.bookivox.com/telephony/providers/vonage.md): Branchez Vonage (Nexmo) : API Key, API Secret, Application ID, clé privée RSA et signature des webhooks. Audio 16 kHz Linear PCM, réponses NCCO.
- [Telnyx](https://docs.bookivox.com/telephony/providers/telnyx.md): Branchez Telnyx (Call Control) : clé API, Application Call Control auto-créée et clé publique de webhook obligatoire pour accepter les événements.
- [Plivo](https://docs.bookivox.com/telephony/providers/plivo.md): Branchez Plivo : Auth ID, Auth Token et Application auto-créée. Les webhooks sont validés par signature X-Plivo-Signature-V3.
- [Vobiz](https://docs.bookivox.com/telephony/providers/vobiz.md): Branchez Vobiz : Auth ID (Account ID), Auth Token et Application auto-créée. Webhooks signés sur les octets bruts du corps.
- [Cloudonix](https://docs.bookivox.com/telephony/providers/cloudonix.md): Branchez Cloudonix : Bearer Token, Domain ID et Application auto-créée.
- [ARI (Asterisk)](https://docs.bookivox.com/telephony/providers/ari.md): Branchez Asterisk (ARI) : endpoint, nom d'application et mot de passe. Bookivox se connecte en WebSocket à votre serveur.
- [Fichiers de connaissance](https://docs.bookivox.com/files/overview.md): Importez et gérez les documents que vos agents utilisent pour répondre : indexation et statut de traitement.
- [Enregistrements](https://docs.bookivox.com/recordings/overview.md): Consultez et téléchargez les enregistrements audio de vos appels.
- [Exécutions](https://docs.bookivox.com/conversations/overview.md): L'historique complet de vos appels et sessions : agent, type, numéro, résultat, durée, coût et détail de chaque exécution.
- [Rapports](https://docs.bookivox.com/reports/overview.md): Analysez l'activité : exécutions du jour, transferts, répartition des issues et des durées, avec export CSV.
- [Facturation](https://docs.bookivox.com/billing/overview.md): Rechargez vos crédits et consultez votre solde et vos abonnements.
- [Clés API](https://docs.bookivox.com/workspace/api-keys.md): Créez et gérez vos clés API Bookivox pour piloter la plateforme par API REST ou via le serveur MCP.
- [Équipe et rôles](https://docs.bookivox.com/workspace/team.md): Invitez des membres, attribuez des rôles (Propriétaire, Admin, Opérateur, Lecture) et des scopes précis.
- [Paramètres](https://docs.bookivox.com/workspace/settings.md): Cinq onglets : Organisation, Préférences, Langue, Sécurité (2FA-TOTP) et Affiliation.
- [Revendeur : Vue d'ensemble](https://docs.bookivox.com/reseller/overview.md): Revendez Bookivox en marque blanche : gérez vos clients, vos tarifs, vos paiements et votre image de marque.
- [Revendeur : Clients](https://docs.bookivox.com/reseller/clients.md): Créez et gérez les comptes de vos clients finaux : chaque client utilise Bookivox sous votre marque.
- [Revendeur : Tarifs](https://docs.bookivox.com/reseller/pricing.md): Définissez vos prix de revente : mode EUR (prix fixe) ou mode marge (pourcentage au-dessus du coût).
- [Revendeur : Paiements](https://docs.bookivox.com/reseller/payments.md): Encaissez vos clients via Stripe Connect : connectez votre compte, facturez et suivez vos encaissements.
- [Revendeur : E-mails](https://docs.bookivox.com/reseller/emails.md): Personnalisez les e-mails transactionnels envoyés à vos clients, sous votre marque (via Postmark).
- [Revendeur : Marque](https://docs.bookivox.com/reseller/branding.md): Définissez l'identité visuelle en marque blanche : logo, couleurs et nom affichés à vos clients finaux.
- [Revendeur : Offres](https://docs.bookivox.com/reseller/offers.md): Créez des offres commerciales packagées pour vos clients : combinaison de crédits, fonctionnalités et prix.
- [Revendeur : Usage](https://docs.bookivox.com/reseller/usage.md): Suivez la consommation de vos clients : appels, crédits consommés et coûts, par client.
- [Lister les agents](https://docs.bookivox.com/api-reference/endpoints/agents/list.md): Renvoie les agents de l'organisation. Filtrez par statut.
- [Compter les agents](https://docs.bookivox.com/api-reference/endpoints/agents/count.md): Renvoie le nombre d'agents de l'organisation, éventuellement filtré par statut.
- [Résumé des agents](https://docs.bookivox.com/api-reference/endpoints/agents/summary.md): Compteurs agrégés par statut pour l'organisation.
- [Créer un agent](https://docs.bookivox.com/api-reference/endpoints/agents/create.md): Crée un agent à partir d'une définition de graphe complète.
- [Créer un agent depuis un template](https://docs.bookivox.com/api-reference/endpoints/agents/create-from-template.md): Crée un agent à partir d'une définition de template.
- [Récupérer un agent](https://docs.bookivox.com/api-reference/endpoints/agents/get.md): Renvoie le brouillon s'il existe, sinon la version publiée.
- [Mettre à jour un agent](https://docs.bookivox.com/api-reference/endpoints/agents/update.md): Met à jour partiellement ou totalement un agent.
- [Valider un agent](https://docs.bookivox.com/api-reference/endpoints/agents/validate.md): Valide le graphe. Renvoie 422 avec la liste des erreurs si invalide.
- [Publier un agent](https://docs.bookivox.com/api-reference/endpoints/agents/publish.md): Publie le brouillon courant.
- [Créer un brouillon](https://docs.bookivox.com/api-reference/endpoints/agents/create-draft.md): Crée un brouillon éditable à partir de la version courante.
- [Lister les versions](https://docs.bookivox.com/api-reference/endpoints/agents/versions.md): Liste les versions publiées d'un agent.
- [Changer le statut](https://docs.bookivox.com/api-reference/endpoints/agents/status.md): Active, désactive ou archive un agent.
- [Déplacer dans un dossier](https://docs.bookivox.com/api-reference/endpoints/agents/folder.md): Range un agent dans un dossier, ou le retire du dossier.
- [Dupliquer un agent](https://docs.bookivox.com/api-reference/endpoints/agents/duplicate.md): Crée une copie d'un agent existant.
- [Lister les exécutions](https://docs.bookivox.com/api-reference/endpoints/agents/runs.md): Liste les exécutions d'un agent, avec filtres et tri.
- [Démarrer une exécution](https://docs.bookivox.com/api-reference/endpoints/agents/run-create.md): Crée une exécution (run) pour l'agent avec un contexte initial optionnel.
- [Récupérer une exécution](https://docs.bookivox.com/api-reference/endpoints/agents/run-get.md): Détail d'une exécution (run) d'un agent à partir de son identifiant public.
- [Rapport d'un agent](https://docs.bookivox.com/api-reference/endpoints/agents/report.md): Agrégats de l'agent : exécutions, durées et résultats.
- [Obtenir une URL d'upload](https://docs.bookivox.com/api-reference/endpoints/knowledge-base/upload-url.md): Renvoie une URL présignée pour déposer un document.
- [Traiter un document](https://docs.bookivox.com/api-reference/endpoints/knowledge-base/process.md): Lance l'indexation asynchrone du document uploadé.
- [Lister les documents](https://docs.bookivox.com/api-reference/endpoints/knowledge-base/list.md): Renvoie les documents de la base de connaissance.
- [Récupérer un document](https://docs.bookivox.com/api-reference/endpoints/knowledge-base/get.md): Détail d'un document de la base de connaissance.
- [Relancer le traitement d'un document](https://docs.bookivox.com/api-reference/endpoints/knowledge-base/retry.md): Relance l'indexation d'un document dont le traitement a échoué.
- [Supprimer un document](https://docs.bookivox.com/api-reference/endpoints/knowledge-base/delete.md): Supprime un document de la base de connaissance.
- [Rechercher dans la base](https://docs.bookivox.com/api-reference/endpoints/knowledge-base/search.md): Recherche sémantique dans les documents indexés.
- [Créer une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/create.md): Crée une campagne sortante à partir d'une liste de contacts.
- [Lister les campagnes](https://docs.bookivox.com/api-reference/endpoints/campaigns/list.md): Renvoie les campagnes de l'organisation.
- [Récupérer une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/get.md): Renvoie le détail d'une campagne.
- [Modifier une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/update.md): Modifie le nom, la concurrence, le retry ou le planning. Refusé si la campagne est terminée, arrêtée ou en échec.
- [Démarrer une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/start.md): Lance les appels sortants de la campagne.
- [Mettre en pause une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/pause.md): Suspend les appels en cours sans annuler les contacts restants.
- [Reprendre une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/resume.md): Reprend une campagne précédemment mise en pause.
- [Arrêter une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/stop.md): Arrête définitivement la campagne. Les contacts non appelés ne sont pas traités.
- [Relancer les contacts échoués](https://docs.bookivox.com/api-reference/endpoints/campaigns/redial.md): Crée une campagne de relance à partir des contacts d'une campagne terminée.
- [Archiver ou restaurer une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/archive.md): Archive ou restaure une campagne sans supprimer son historique.
- [Progression d'une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/progress.md): Compteurs d'avancement : contacts traités, restants et réponses.
- [Lister les exécutions d'une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/runs.md): Liste paginée des appels d'une campagne, avec filtres et tri.
- [Rapport d'une campagne](https://docs.bookivox.com/api-reference/endpoints/campaigns/report.md): Agrégats de la campagne : résultats, durées et coûts.
- [URL de téléchargement de la source](https://docs.bookivox.com/api-reference/endpoints/campaigns/source-download-url.md): Renvoie une URL présignée pour télécharger le CSV des contacts. Disponible uniquement pour les sources CSV.
- [Obtenir une URL d'upload de contacts](https://docs.bookivox.com/api-reference/endpoints/campaigns/upload-url.md): Renvoie une URL présignée pour déposer le CSV des contacts.
- [Créer une session de chat texte](https://docs.bookivox.com/api-reference/endpoints/text-chat/create-session.md): Ouvre une session de test en chat texte (sans appel).
- [Lire une session de chat texte](https://docs.bookivox.com/api-reference/endpoints/text-chat/get-session.md): Renvoie l'état courant d'une session de chat texte.
- [Envoyer un message](https://docs.bookivox.com/api-reference/endpoints/text-chat/send-message.md): Ajoute un message utilisateur et renvoie la réponse de l'agent.
- [Rembobiner la session](https://docs.bookivox.com/api-reference/endpoints/text-chat/rewind.md): Revient à un tour précédent de la conversation.
- [Lister les clés API](https://docs.bookivox.com/api-reference/endpoints/api-keys/list.md): Renvoie les clés API de l'organisation courante.
- [Créer une clé API](https://docs.bookivox.com/api-reference/endpoints/api-keys/create.md): Crée une clé API. Le secret n'est renvoyé qu'une seule fois.
- [Archiver une clé API](https://docs.bookivox.com/api-reference/endpoints/api-keys/delete.md): Archive la clé. Elle n'est plus utilisable mais reste traçable.
- [Réactiver une clé API](https://docs.bookivox.com/api-reference/endpoints/api-keys/reactivate.md): Réactive une clé précédemment archivée.
- [Solde et journal de crédits](https://docs.bookivox.com/api-reference/endpoints/credits/get.md): Consulte le solde, le quota et le journal des mouvements.
- [Usage de la période courante](https://docs.bookivox.com/api-reference/endpoints/credits/current-period.md): Renvoie l'usage agrégé de la période en cours.
- [Usage par exécution](https://docs.bookivox.com/api-reference/endpoints/credits/runs.md): Liste les exécutions avec leur coût.
- [Répartition quotidienne](https://docs.bookivox.com/api-reference/endpoints/credits/daily.md): Renvoie l'usage agrégé par jour.
- [Lister les types de nœuds](https://docs.bookivox.com/api-reference/endpoints/node-types/list.md): Catalogue complet des types de nœuds et de leurs propriétés.
- [Récupérer un type de nœud](https://docs.bookivox.com/api-reference/endpoints/node-types/get.md): Renvoie la description complète d'un type de nœud.
- [Lister les outils](https://docs.bookivox.com/api-reference/endpoints/tools/list.md): Renvoie les outils de l'organisation.
- [Créer un outil](https://docs.bookivox.com/api-reference/endpoints/tools/create.md): Crée un outil attachable à un nœud agent.
- [Récupérer un outil](https://docs.bookivox.com/api-reference/endpoints/tools/get.md): Renvoie le détail d'un outil.
- [Mettre à jour un outil](https://docs.bookivox.com/api-reference/endpoints/tools/update.md): Met à jour les métadonnées et la définition d'un outil.
- [Archiver un outil](https://docs.bookivox.com/api-reference/endpoints/tools/delete.md): Archive un outil (suppression logique).
- [Désarchiver un outil](https://docs.bookivox.com/api-reference/endpoints/tools/unarchive.md): Restaure un outil précédemment archivé.
- [Lister les configurations](https://docs.bookivox.com/api-reference/endpoints/telephony/list-configs.md): Renvoie les configurations téléphonie de l'organisation.
- [Récupérer une configuration](https://docs.bookivox.com/api-reference/endpoints/telephony/get-config.md): Renvoie le détail d'une configuration téléphonie.
- [Lister les numéros](https://docs.bookivox.com/api-reference/endpoints/telephony/phone-numbers.md): Renvoie les numéros rattachés à une configuration.
- [Lister les templates](https://docs.bookivox.com/api-reference/endpoints/templates/list.md): Renvoie les modèles d'agents disponibles, prêts à dupliquer.
- [Créer un agent depuis un template](https://docs.bookivox.com/api-reference/endpoints/templates/duplicate.md): Méthode recommandée pour créer un agent : dupliquer un template.
- [Serveur MCP](https://docs.bookivox.com/mcp/overview.md): Connectez vos agents IA (Claude, Cursor, VS Code) au serveur MCP de Bookivox pour créer et piloter vos agents vocaux par conversation.
- [Connexion par client](https://docs.bookivox.com/mcp/clients.md): Configurer Cursor, Claude Desktop, Claude Code et VS Code pour utiliser le serveur MCP de Bookivox.
- [Outils exposés](https://docs.bookivox.com/mcp/tools.md): Découvrez les outils que le serveur MCP de Bookivox expose à votre agent IA.
- [Campagnes (API)](https://docs.bookivox.com/api-reference/campaigns.md): Piloter les campagnes sortantes via l'API : upload CSV, création, options de retry/planning/disjoncteur, démarrage, erreurs.
- [Connexion et authentification](https://docs.bookivox.com/api-reference/connections.md): Authentifier vos requêtes, choisir une surface (API REST ou MCP) et configurer les webhooks.
- [Endpoints](https://docs.bookivox.com/api-reference/endpoints.md): Liste complète des endpoints de la surface clé API /api/v1/api, avec les paramètres de requête et de corps.
- [Erreurs](https://docs.bookivox.com/api-reference/errors.md): Formats d'erreur de l'API Bookivox, exemples réels par code, erreurs du catalogue et stratégie de retry.
- [Uploads de fichiers](https://docs.bookivox.com/api-reference/file-uploads.md): Uploader des fichiers via l'API : source CSV de campagne et documents de base de connaissance (URL présignées + processing).
- [Flows (recettes)](https://docs.bookivox.com/api-reference/flows.md): Recettes de bout en bout : créer et tester un agent, uploader une base de connaissance, créer une campagne, lire crédits et usage, téléphonie.
- [Pour les agents IA](https://docs.bookivox.com/api-reference/guides/ai-agents.md): Comment un agent IA (Claude, Cursor, VS Code…) construit un agent vocal Bookivox via le serveur MCP, du plan à la publication.
- [Nouveautés](https://docs.bookivox.com/api-reference/guides/changelog.md): Les nouveautés de la documentation Bookivox : serveur MCP, guides développeur, pages fournisseurs téléphonie.
- [Concepts](https://docs.bookivox.com/api-reference/guides/concepts.md): Le vocabulaire partagé de la surface développeur : agent (workflow), nœud, arête, outil, identifiant, UUID public, run et campagne.
- [Intégrations HTTP (API)](https://docs.bookivox.com/api-reference/guides/http-api-integrations.md): Piloter vos intégrations http_api par code : anatomie de la définition (méthode, URL, en-têtes, credential, paramètres), attacher l'outil à un agent et l'appeler pendant l'appel.
- [Introduction](https://docs.bookivox.com/api-reference/guides/overview.md): Ce que la surface développeur de Bookivox permet : piloter les appels, les agents, les outils et les webhooks par API REST, par le serveur MCP, ou depuis le canevas.
- [Webhooks](https://docs.bookivox.com/api-reference/guides/webhooks.md): Recevoir les événements d'appel Bookivox sur votre serveur : nœud webhook du workflow, variables de template disponibles et validation des requêtes.
- [Workflow (JSON)](https://docs.bookivox.com/api-reference/guides/workflow-json.md): Le format workflow_definition : graphe nodes/edges, workflow minimal valide, catalogue de node-types et validation.
- [Intégrations (API)](https://docs.bookivox.com/api-reference/integrations.md): Connecter et utiliser les intégrations via l'API : exemple Calendly (OAuth, event types, toolset) et découverte des intégrations disponibles.
- [Base de connaissance (API)](https://docs.bookivox.com/api-reference/knowledge-base.md): Gérer les documents de la base de connaissance via l'API : URL d'upload, processing, liste, suppression et recherche.
- [Nœuds (graphe)](https://docs.bookivox.com/api-reference/nodes.md): Comprendre workflow_definition : structure nodes/edges, workflow minimal valide, catalogue de node-types et validation.
- [Référence API](https://docs.bookivox.com/api-reference/overview.md): Pilotez Bookivox en server-to-server : authentification X-API-Key, base /api/v1/api, et chaque surface (agents, campagnes, base de connaissance, outils, téléphonie, crédits).
- [Démarrage rapide](https://docs.bookivox.com/api-reference/quickstart.md): Faites votre première requête à l'API Bookivox : prérequis, en-têtes, wrapper TypeScript prêt à l'emploi, gestion des codes de statut.
- [Téléphonie (API)](https://docs.bookivox.com/api-reference/telephony.md): Accès téléphonie via l'API : lecture des configurations et des numéros. Le provisioning et la gestion des numéros sont réservés au dashboard.
- [Outils (API)](https://docs.bookivox.com/api-reference/tools.md): Gérer les outils via l'API : schéma de création complet (http_api, end_call, transfer_call, calculator, integration, mcp), mise à jour, archivage.
- [Bookivox](https://docs.bookivox.com/index.md): Documentation officielle Bookivox : plateforme d'agents vocaux IA. Créez, testez et déployez des agents vocaux avec un éditeur de workflow visuel.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.