> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bookivox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> 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.

## Ce que vous pouvez construire

Bookivox expose sa plateforme à trois niveaux complémentaires. Choisissez celui
qui correspond à votre besoin, et combinez-les librement.

> **[API REST](https://docs.bookivox.com/api-reference/overview)**
>
> Pilotez agents, appels, outils et campagnes par HTTP.

> **[Serveur MCP](https://docs.bookivox.com/mcp/overview.md)**
>
> Laissez un agent IA (Claude, Cursor, VS Code) construire vos agents.

> **[Canevas visuel](https://docs.bookivox.com/workflow/overview.md)**
>
> Construisez le graphe à la souris, sans écrire de code.

> **[Intégrations HTTP](https://docs.bookivox.com/integrations/http-api.md)**
>
> Branchez vos propres API pendant l'appel.

## Les concepts clés

Avant d'écrire du code, retenez quatre briques. Elles reviennent partout dans la
documentation.

**Agents**

Un **agent** est un graphe (`workflow_definition`) de nœuds : un point
d'entrée (`startCall`), un ou plusieurs cœurs conversationnels (`agentNode`),
une fin (`endCall`). C'est le format décrit dans
[Workflow (JSON)](https://docs.bookivox.com/api-reference/guides/workflow-json).

**Outils**

Un **outil** est une capacité donnée à l'agent pendant l'appel : appeler votre
API (`http_api`), raccrocher (`end_call`), transférer un appel
(`transfer_call`). Voir [Outils (API)](https://docs.bookivox.com/api-reference/tools).

**Identifiants**

Les **secrets** (clés API tierces, jetons OAuth) ne sont **jamais** dans vos
définitions : ils vivent dans le gestionnaire d'identifiants et sont
référencés par un `credential_uuid`. Voir
[Intégrations HTTP (API)](https://docs.bookivox.com/api-reference/guides/http-api-integrations).

**Identifiants publics**

Les ressources (`workflow`, `tool`, `document`, configuration téléphonie) sont
référencées par des **UUID publics**, jamais par un identifiant interne
séquentiel.

## Par où commencer

**1. Authentifiez-vous**

Créez une clé API dans [Clés API](https://docs.bookivox.com/workspace/api-keys.md) et envoyez-la dans
l'en-tête `X-API-Key`. Voir [Démarrage rapide](https://docs.bookivox.com/api-reference/quickstart).

**2. Faites un premier appel**

Le [Démarrage rapide](https://docs.bookivox.com/api-reference/quickstart) contient une requête
complète et un wrapper TypeScript prêt à l'emploi.

**3. Parcourez les concepts**

[Nœuds (graphe)](https://docs.bookivox.com/api-reference/nodes), [Erreurs & codes](https://docs.bookivox.com/api-reference/errors)
et [Workflow (JSON)](https://docs.bookivox.com/api-reference/guides/workflow-json) posent le vocabulaire.

**4. Automatisez**

[Webhooks](https://docs.bookivox.com/api-reference/guides/webhooks), [Campagnes](https://docs.bookivox.com/api-reference/campaigns) et
[Outils](https://docs.bookivox.com/api-reference/tools) couvrent les cas avancés.

> [!WARNING]
>
> Bookivox ne fournit **pas** de SDK officiel pour le moment. Les exemples
> s'appuient sur `fetch` standard et un petit wrapper TypeScript documenté dans le
> [Démarrage rapide](https://docs.bookivox.com/api-reference/quickstart).

## Où aller ensuite

> **[Démarrage rapide](https://docs.bookivox.com/api-reference/quickstart)**
>
> Première requête en quelques minutes.

> **[Pour les agents IA](https://docs.bookivox.com/api-reference/guides/ai-agents)**
>
> Le parcours d'un assistant IA connecté au MCP.

> **[Endpoints (cheatsheet)](https://docs.bookivox.com/api-reference/endpoints)**
>
> Toutes les routes, par domaine.

> **[Flows end-to-end](https://docs.bookivox.com/api-reference/flows)**
>
> Des recettes complètes, du début à la fin.


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