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

# SimplyBook.me

> Votre assistant vérifie les créneaux libres et réserve des rendez-vous dans SimplyBook.me.

Votre assistant consulte les prestations, le personnel et les créneaux libres de votre compte SimplyBook.me et réserve des rendez-vous une fois que l’appelant a confirmé.

## Connecter votre compte

1. Dans SimplyBook.me, ouvrez **Custom Features → API** et copiez le **REST API Endpoint** de votre région, par exemple `https://user-api-v2.simplybook.it`. Sur la page des clés API, créez une **API User Key** pour un utilisateur du personnel.
2. Utilisez un utilisateur du personnel dédié, avec uniquement les droits nécessaires à l’assistant. L’assistant peut faire tout ce que cet utilisateur est autorisé à faire.
3. Ouvrez **Agent Tools → Marketplace → SimplyBook.me**. Choisissez l’endpoint, puis saisissez votre identifiant d’entreprise (la partie avant `.simplybook.me`), l’identifiant de l’utilisateur du personnel et l’API User Key. Utilisez une API User Key et non un mot de passe : les mots de passe exigent une connexion à deux facteurs et ne fonctionnent pas pour l’automatisation.
4. Choisissez **Ajouter**. La connexion est vérifiée avant l’enregistrement. Associez ensuite la connexion à votre assistant.

> [!WARNING]
>
> La création de votre première API User Key active la vérification par e-mail de l’adresse IP pour les connexions par mot de passe du personnel de votre compte SimplyBook.me. Les autres intégrations qui se connectent avec un mot de passe ont alors aussi besoin d’une clé.

Pour modifier plus tard l’endpoint, l’identifiant du personnel ou la clé, supprimez l’outil et reconnectez-le.

## Ce que l’assistant peut faire

Activé par défaut :

* Informations sur l’entreprise, prestations et personnel (les coordonnées du personnel ne sont jamais communiquées).
* Créneaux libres pour une prestation, avec ou sans membre du personnel choisi, et prochain créneau libre.
* Les informations qu’une prestation exige avant la réservation.
* Réserver un rendez-vous.

Optionnel, à choisir sous **Modifier** :

* Retrouver un client par son adresse e-mail et lister ses prochains rendez-vous. Toute personne connaissant l’adresse e-mail peut entendre ces horaires ; n’activez cette option que si cela est acceptable pour votre entreprise.
* Consulter une réservation et lister les réservations d’une période, coordonnées des clients comprises. À réserver aux automatisations et aux assistants internes, pas aux assistants qui parlent aux appelants.
* Annuler un rendez-vous.

## Comment se déroule la réservation

L’assistant charge d’abord les informations exigées par la prestation, puis les créneaux libres. Il ne propose que les horaires renvoyés par SimplyBook.me, dans le fuseau horaire de votre entreprise. Il recueille le nom, l’adresse e-mail et les autres informations obligatoires, répète la prestation, le membre du personnel, la date et l’heure, et ne réserve qu’après un oui de l’appelant. Il n’annonce la réussite qu’une fois la réservation confirmée par SimplyBook.me. Si la prestation nécessite une validation, l’assistant indique que l’entreprise confirmera le rendez-vous.

SimplyBook.me envoie à vos clients ses confirmations habituelles. Les créneaux libres ne sont pas des réservations : si un créneau est pris entre-temps, l’assistant recharge les créneaux et demande à nouveau.

## Si le résultat n’est pas clair

Un délai dépassé ne prouve pas que la réservation a échoué. Les demandes répétées ou parallèles sont protégées contre les doubles réservations. Si l’assistant signale un résultat inconnu, vérifiez dans SimplyBook.me avant de réserver à nouveau.

## Annuler

L’annulation est désactivée par défaut. L’appelant doit indiquer le code de réservation figurant dans l’e-mail de confirmation et l’adresse e-mail utilisée pour la réservation ; les deux doivent correspondre. Pour déplacer un rendez-vous, l’assistant réserve le nouvel horaire puis annule l’ancien, chaque fois après confirmation de l’appelant. Le déplacement en une seule étape n’est pas encore disponible.

## Tester sans risque

Un chat de test ou un test vocal effectue de vraies réservations et envoie de vraies notifications. Testez avec une prestation de test et annulez ensuite la réservation. Les simulations textuelles n’appellent pas SimplyBook.me.

## Canaux

Au téléphone et dans le chat web, l’assistant dispose de toutes les consignes de réservation. Dans WhatsApp, Messenger et par e-mail, il peut avoir besoin d’un message supplémentaire pour obtenir correctement les informations de réservation.

## Automatisations

Connectez **SimplyBook.me** dans **Automatisations → Connexions**, ou importez sa connexion Agent Tools. Chaque outil est disponible comme action. Une action de réservation nécessite la référence de disponibilité d’une étape de créneaux précédente et la confirmation du client, qui ne doit être définie qu’après son accord réel. Les déclencheurs pour les réservations nouvelles, modifiées ou annulées ne sont pas encore disponibles.

## API, MCP, CLI & SDK

`POST /api/v1/tools/simplybook` · MCP `connect_simplybook` · CLI `famulor connect-simplybook`.

`client.api.connectSimplybook` nécessite `famulor-sdk` 0.2.11 ou une version ultérieure. Mettez à jour la CLI avec `npm install --global famulor` avant d’utiliser `connect-simplybook`.

```bash theme={null}
famulor connect-simplybook --api-host "https://user-api-v2.simplybook.it" --company-login "mycompany" --user-login "assistant" --api-key "$SIMPLYBOOK_API_KEY" --name simplybook
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectSimplybook({ body: {
  api_host: 'https://user-api-v2.simplybook.it',
  company_login: 'mycompany',
  user_login: 'assistant',
  api_key: process.env.SIMPLYBOOK_API_KEY,
  name: 'simplybook',
} });
console.log(tool.id);
```

[SimplyBook.me REST API](https://simplybook.me/en/api/developer-api/tab/rest_api)


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