/api/v1/api et s’authentifient avec une clé API.
Les clés API doivent rester côté serveur. Ne les embarquez jamais dans du code client (navigateur, application mobile) ni dans un dépôt public.
Authentification
Ajoutez votre clé dans l’en-têteX-API-Key.
- cURL
- JavaScript
- Python
Créer une clé API
- Ouvrez Workspace → Clés API dans le dashboard.
- Créez une clé avec un nom parlant (ex. « Backend production »).
- Copiez la valeur immédiatement : elle n’est affichée qu’une seule fois.
Surfaces disponibles
- API REST
- Serveur MCP
Appels HTTP classiques décrits dans cette référence. Idéal pour automatiser la création d’agents, lancer des campagnes ou interroger votre base de connaissance depuis votre backend.
- Base URL :
https://api.bookivox.com/api/v1/api - Auth : en-tête
X-API-Key
Webhooks
Deux directions existent, à ne pas confondre.Bookivox → votre serveur
Bookivox → votre serveur
Le nœud Webhook d’un agent envoie une requête HTTP vers une URL de votre choix pendant ou après l’appel. Vous recevez les données de l’appel (transcription, résumé, variables collectées) et pouvez déclencher vos propres traitements.
Nœud Webhook
Champs, variables de template, cas d’usage et sécurité.
Votre serveur → Bookivox (outil HTTP)
Votre serveur → Bookivox (outil HTTP)
Vous exposez un endpoint que l’agent appelle pendant l’appel (vérifier une disponibilité, créer un rendez-vous…). Bookivox appelle votre API avec les paramètres définis.
Outil HTTP API
Configuration complète d’un outil HTTP.
Étapes suivantes
Démarrage rapide
Votre première requête en quelques minutes.
Codes d'erreur
Comprendre et gérer les réponses d’erreur.
