> ## 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. # Calendrier intégré > Le moteur de planification intégré de Famulor pour prendre des rendez-vous en cours d'appel — sans compte de calendrier externe Famulor embarque son propre système de planification complet : des types d'événements avec leur propre disponibilité hebdomadaire, une page de réservation publique intégrable, une synchronisation optionnelle avec un vrai calendrier, et un webhook signé à chaque réservation. Les assistants y réservent en cours d'appel comme avec n'importe quel autre fournisseur. Les fournisseurs externes — Cal.com, Calendly, Acuity Scheduling, eTermin, HighLevel — sont traités dans [Calendrier et prise de rendez-vous](/fr/assistants/calendar-booking). ## Le calendrier natif **Native** est le moteur de réservation propre à Famulor — construit directement dans la plateforme plutôt qu'un produit tiers auquel il faut s'inscrire, et répertorié aux côtés des autres fournisseurs de calendrier dans [Aperçu des fournisseurs](/fr/assistants/calendar-booking#aperçu-des-fournisseurs). Aucun compte externe, aucune clé API, aucun écran de consentement OAuth : définissez un [type d'événement](#le-moteur-de-réservation-intégré) avec sa propre disponibilité hebdomadaire, et il est immédiatement prêt à être attribué à un assistant. Native fonctionne avec la même fonctionnalité de forfait **Calendar integrations** que tous les autres fournisseurs répertoriés dans [Aperçu des fournisseurs](/fr/assistants/calendar-booking#aperçu-des-fournisseurs) — ce n'est pas une option payante distincte qui s'ajoute à Cal.com ou Calendly. Votre forfait doit toujours inclure cette fonctionnalité avant que vous puissiez créer un type d'événement ou une intégration, natifs compris. Voir [Limitation par le forfait](#limitation-par-le-forfait). Un type d'événement natif attribué reçoit les mêmes outils `check_availability` et `book_appointment` que toute autre intégration, sans API tierce intermédiaire : les créneaux proviennent directement des plages de disponibilité, des marges et des règles de préavis propres au type d'événement. Native est aussi l'un des deux seuls fournisseurs — Acuity est l'autre — dont les assistants peuvent rechercher, annuler et replanifier un rendez-vous existant, et le seul des deux à ne nécessiter aucun compte externe pour cela. Voir [Attribution à un assistant](/fr/assistants/calendar-booking#attribution-à-un-assistant) pour la liste complète des outils. ### Connexions de calendrier Native fonctionne de façon autonome avec ses seules règles de disponibilité hebdomadaire, ou vous pouvez connecter un vrai calendrier pour que ses plages occupées soient respectées et — pour la plupart des types de connexion — que les réservations confirmées y soient réécrites. Connectez Google Calendar et Outlook sous **Booking → Integrations** ; ajoutez CalDAV ou un flux ICS sous **Booking → Event types → Calendars**. Dans tous les cas, sélectionnez la connexion dans le champ **Calendars** propre au type d'événement pour l'utiliser réellement. | Connexion | Fonction | Configuration | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Google Calendar** | Libre/occupé, plus création et suppression de la réservation comme événement de calendrier avec invitation du participant | Connexion OAuth (une fois) | | **Outlook / Microsoft 365** | Libre/occupé, plus création et suppression de la réservation comme événement de calendrier avec invitation du participant | Connexion OAuth (une fois) | | **CalDAV** | Libre/occupé, plus création et suppression de la réservation comme événement de calendrier — aucune invitation envoyée par le serveur, l'invité dépend donc de l'e-mail de confirmation ICS propre au moteur de réservation | URL du serveur + nom d'utilisateur + mot de passe d'application — préréglages pour **Apple iCloud**, **Fastmail** et **Nextcloud**, plus **Custom** pour Zimbra, Baïkal, ou tout autre serveur CalDAV ; la collection de calendrier est détectée automatiquement | | **ICS feed** | Libre/occupé uniquement — lecture seule, rien n'est jamais réécrit | Une URL ICS/iCal secrète (`webcal://` accepté), par exemple l'« adresse secrète » de Google Calendar ou le réglage « Publier le calendrier » d'Outlook | ## Le moteur de réservation intégré Créez des types d'événements sous **Booking** dans le tableau de bord (ou via l'API/MCP) : * **Name, slug, duration** — le slug est unique au sein de l'espace de travail et devient une partie de l'URL de la page de réservation publique affichée dans l'éditeur. * **Weekly availability** — plages horaires par jour de la semaine, dans le fuseau horaire du type d'événement, par exemple du lundi au vendredi de 9h à 17h. * **Buffers & rules** — marge avant et après chaque réservation, préavis minimum, délai maximal de réservation à l'avance, et incrément des créneaux. * **Calendar sync** (facultatif) — associez un [calendrier connecté](#connexions-de-calendrier). Les connexions Google, Outlook et CalDAV voient leurs plages occupées déduites des créneaux proposés, et les réservations confirmées y sont réécrites sous forme d'événements de calendrier ; sur Google et Outlook, l'invité est ajouté comme participant, si bien que le fournisseur envoie aussi sa propre invitation. Un flux ICS ne fournit que des plages occupées. * **Host confirmation** — l'invité reçoit toujours un e-mail de confirmation avec une invitation ICS. Une seconde copie part vers l'hôte : le compte Add-to-calendar, une adresse d'organisateur personnalisée, ou le propriétaire du type d'événement si aucun calendrier n'est sélectionné. ### Page de réservation publique et intégration Chaque type d'événement actif dispose d'une page publique aux couleurs du tenant, à l'adresse `https:///book/{workspace}/{slug}` — aucune connexion requise. Son bouton **Public link & embed code** dans la liste des types d'événements copie un extrait iframe prêt à l'emploi pour votre propre site, accompagné du petit script qui redimensionne le cadre pour s'ajuster à son contenu. Intégrez-la où vous le souhaitez : ```html theme={null} ``` Les visiteurs choisissent un créneau dans leur propre fuseau horaire, saisissent leur nom et leur e-mail, et reçoivent un **e-mail de confirmation avec une invitation de calendrier ICS**, ainsi qu'un lien d'annulation. L'hôte configuré reçoit un e-mail **New booking** correspondant. Si deux personnes choisissent le même créneau en même temps, seule la première réservation aboutit et l'autre visiteur est invité à choisir un autre horaire. ### Réservation depuis un appel Connectez le moteur de réservation intégré à un assistant pour que les réservations effectuées en cours d'appel apparaissent dans le même calendrier et soient liées à l'appel concerné. Vous l'attribuez exactement comme un fournisseur externe — voir [Attribution à un assistant](/fr/assistants/calendar-booking#attribution-à-un-assistant). ### Webhooks Donnez à un type d'événement une **Webhook URL**, et Famulor la notifie chaque fois qu'une réservation de ce type d'événement est créée, annulée ou replanifiée. Enregistrer l'URL révèle un **Webhook signing secret** — affiché une seule fois, donc copiez-le avant de quitter la page. Chaque envoi est un `POST` de `booking.created`, `booking.cancelled` ou `booking.rescheduled`, signé par un HMAC-SHA256 du corps brut dans `X-Famulor-Signature: sha256=`. L'objet `data` contient `booking_id`, les `event_type_id`/`event_type_slug`/`event_type_name` du type d'événement, `invitee` (`name`, `email`, `phone`, `timezone`), `start_time` et `end_time` (plus `previous_start_time` lors d'une replanification), `status`, `source` (`web`, `call` ou `api`), le `call_id` d'origine lorsque la réservation provient d'un appel, ainsi que des `notes` en texte libre. Voir [Recevoir des webhooks](/fr/api-reference/integration-examples#recevoir-des-webhooks) pour un exemple de serveur complet, incluant la vérification de signature. ## Limitation par le forfait Votre forfait doit inclure **Calendar integrations** — la même fonctionnalité de forfait qui limite l'accès aux fournisseurs externes sur [Calendrier et prise de rendez-vous](/fr/assistants/calendar-booking). Sans elle, vous ne pouvez pas créer de types d'événements, et les pages de réservation publiques n'acceptent pas de nouvelles réservations. ## API & MCP Tout ce qui précède est disponible dans l'[API REST publique](/fr/api-reference/introduction) et sous forme d'outils MCP à l'adresse `https:///mcp`. Les intégrations de fournisseurs (Cal.com, Calendly, Acuity, eTermin, HighLevel) et l'attribution d'un calendrier à un assistant sont traitées dans [Calendrier et prise de rendez-vous](/fr/assistants/calendar-booking). `GET /api/v1/bookings` et `list_bookings` prennent en charge les filtres par type d'événement, source et date. Utilisez `view=upcoming|unconfirmed|recurring|past|cancelled` pour retrouver les mêmes vues de réservation que dans le tableau de bord, ou appliquez un filtre `status` exact ; `view` et `status` s'excluent mutuellement. | REST | Outil MCP | Portée | | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------- | | `GET/POST /api/v1/booking-event-types`, `GET/PATCH/DELETE /api/v1/booking-event-types/{id}` | `get_booking_event_types`, `create_booking_event_type`, `update_booking_event_type`, `delete_booking_event_type` | `bookings:read/write` | | `GET /api/v1/bookings`, `GET /api/v1/bookings/{id}`, `POST /api/v1/bookings/{id}/cancel` | `list_bookings`, `get_booking`, `cancel_booking` | `bookings:read/write` | Annuler une réservation envoie une mise à jour ICS `METHOD:CANCEL`, ce qui fait disparaître automatiquement le rendez-vous du calendrier de l'invité.