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

# Intégration : Calendly

> Connectez Calendly à Bookivox pour que vos agents proposent, réservent, retrouvent, annulent ou replanifient des rendez-vous.

## À quoi ça sert

L'intégration **Calendly** permet à votre agent de **gérer des rendez-vous**
pendant l'appel : proposer des créneaux, réserver, retrouver, annuler ou
replanifier un rendez-vous.

## Les cinq opérations

| Opération | Rôle |
| - | - |
| **Proposer des créneaux** | Récupérer les disponibilités (`find_slots`) |
| **Réserver** | Créer un rendez-vous (`book`) |
| **Retrouver** | Retrouver un rendez-vous existant (`find`) |
| **Annuler** | Annuler un rendez-vous (`cancel`) |
| **Replanifier** | Déplacer un rendez-vous (`reschedule`) |

## Connexion

**1. Lancer la connexion**

Dans **Intégrations**, sélectionnez **Calendly** et démarrez la connexion.

**2. Autoriser (OAuth)**

Vous êtes redirigé vers Calendly pour **autoriser** l'accès. Un flux OAuth
sécurisé est utilisé : Bookivox ne stocke pas votre mot de passe Calendly.

**3. Terminer le callback**

Après autorisation, vous revenez dans Bookivox avec la connexion active.

## Utilisation par l'agent

Activez l'outil sur un nœud **Étape agent** (onglet **Outils**), puis décrivez
dans le prompt **quand** proposer un rendez-vous. Exemple :

```
Quand le client veut un rendez-vous, propose-lui les créneaux disponibles
(« Proposer des créneaux »), puis réserve le créneau choisi.
```

## Exemple de conversation

```
Agent  : Souhaitez-vous que je vous propose un créneau ?
Client : Oui, plutôt en fin de journée.
Agent  : [find_slots] J'ai mardi 17 h et jeudi 18 h. Lequel vous convient ?
Client : Mardi 17 h.
Agent  : [book] C'est réservé pour mardi 17 h. Vous recevrez une confirmation.
```

> [!NOTE]
>
> Les créneaux proposés dépendent de vos **événements Calendly** et de vos règles
> de disponibilité. Configurez-les dans Calendly.

> **[Intégrations](https://docs.bookivox.com/integrations/overview.md)**
>
> Toutes les intégrations.

> **[Outil Appel HTTP](https://docs.bookivox.com/integrations/http-api.md)**
>
> Pour une API maison.


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