Der native Kalender
Native ist Famulors eigene Buchungs-Engine – direkt in die Plattform eingebaut statt ein Drittanbieter-Produkt, für das du dich anmeldest, und in Anbieter im Überblick neben den anderen Kalenderanbietern gelistet. Es gibt kein externes Konto, keinen API-Key und keinen OAuth-Zustimmungsbildschirm: Definiere einen Event-Typ mit eigener wöchentlicher Verfügbarkeit, und er ist sofort bereit, einem Assistenten zugewiesen zu werden.Native läuft über dasselbe Plan-Feature Calendar integrations wie jeder andere Anbieter unter Anbieter im Überblick – es ist kein separates, kostenpflichtiges Add-on zusätzlich zu Cal.com oder Calendly. Dein Plan muss dieses Feature weiterhin enthalten, bevor du einen Event-Typ oder eine Integration erstellen kannst, native eingeschlossen. Siehe Plan-Gating.
check_availability und book_appointment wie jede andere Integration, ganz ohne Drittanbieter-API dazwischen: Slots kommen direkt aus den eigenen Verfügbarkeitsfenstern, Puffern und Vorlaufregeln des Event-Typs. Native ist außerdem einer von nur zwei Anbietern – der andere ist Acuity –, deren Assistenten einen bestehenden Termin finden, stornieren und umbuchen können, und der Einzige der beiden, der dafür kein externes Konto braucht. Die vollständige Tool-Liste findest du unter Einem Assistenten zuweisen.
Kalenderverbindungen
Native funktioniert eigenständig, nur mit seinen eigenen Regeln zur wöchentlichen Verfügbarkeit, oder du verbindest einen echten Kalender, damit seine Belegungszeiten berücksichtigt werden und – bei den meisten Verbindungstypen – bestätigte Buchungen dorthin zurückgeschrieben werden. Verbinde Google Calendar und Outlook unter Booking → Integrations; füge CalDAV oder einen ICS-Feed unter Booking → Event types → Calendars hinzu. In beiden Fällen wählst du die Verbindung im eigenen Calendars-Feld des Event-Typs aus, um sie tatsächlich zu nutzen.Die integrierte Buchungs-Engine
Lege Event-Typen unter Booking im Dashboard an (oder über API/MCP):- Name, slug, duration – der Slug ist innerhalb des Workspace eindeutig und wird Teil der öffentlichen Buchungsseiten-URL, die im Editor angezeigt wird.
- Weekly availability – Zeitfenster pro Wochentag in der Zeitzone des Event-Typs, z. B. Mo–Fr 09:00–17:00 Uhr.
- Buffers & rules – Puffer vor und nach jeder Buchung, Mindestvorlauf, wie weit im Voraus Kunden buchen dürfen, und Slot-Intervall.
- Calendar sync (optional) – verknüpfe einen verbundenen Kalender. Bei Google-, Outlook- und CalDAV-Verbindungen werden ihre Belegungszeiten von den angebotenen Slots abgezogen und bestätigte Buchungen als Kalendereinträge zurückgeschrieben; bei Google und Outlook wird der Gast als Teilnehmer hinzugefügt, sodass der Anbieter ebenfalls seine eigene Einladung verschickt. Ein ICS-Feed liefert nur Belegungszeiten.
- Host confirmation – der Gast bekommt immer eine Bestätigungs-E-Mail mit ICS-Einladung. Eine zweite Kopie geht an den Host: das Add-to-Calendar-Konto, eine benutzerdefinierte Organizer-E-Mail-Adresse oder den Event-Typ-Besitzer, wenn kein Kalender ausgewählt ist.
Öffentliche Buchungsseite & Einbettung
Jeder aktive Event-Typ hat eine öffentliche Seite im Branding deines Tenants unterhttps://<your-domain>/book/{workspace}/{slug} – ohne Login nötig. Der Button Public link & embed code in der Event-Typ-Liste kopiert ein fertiges iframe-Snippet für deine eigene Website, zusammen mit dem kleinen Skript, das den Frame an die Größe seines Inhalts anpasst. Bette sie überall ein:
Buchung aus Anrufen
Verbinde die integrierte Buchungs-Engine mit einem Assistenten, damit Buchungen mitten im Anruf im selben Kalender landen und mit dem zugehörigen Anruf verknüpft werden. Du weist sie genauso zu wie einen externen Anbieter – siehe Einem Assistenten zuweisen.Webhooks
Gib einem Event-Typ eine Webhook URL, und Famulor benachrichtigt sie, sobald eine Buchung dieses Event-Typs erstellt, storniert oder umgebucht wird. Beim Speichern der URL erscheint ein Webhook signing secret – wird nur einmal angezeigt, also kopiere es, bevor du die Seite verlässt. Jede Zustellung ist einPOST von booking.created, booking.cancelled oder booking.rescheduled, signiert mit einem HMAC-SHA256 des rohen Bodys in X-Famulor-Signature: sha256=<hex digest>. Das data-Objekt enthält booking_id, die event_type_id/event_type_slug/event_type_name des Event-Typs, invitee (name, email, phone, timezone), start_time und end_time (plus previous_start_time bei einer Umbuchung), status, source (web, call oder api), die auslösende call_id, wenn die Buchung aus einem Anruf stammt, und freien Text unter notes.
Ein vollständiges Serverbeispiel inklusive Signaturprüfung findest du unter Webhooks empfangen.
Plan-Gating
Dein Plan muss Calendar integrations enthalten – dasselbe Plan-Feature, das auch die externen Anbieter auf Kalender & Buchung freischaltet. Ohne dieses Feature kannst du keine Event-Typen erstellen, und öffentliche Buchungsseiten nehmen keine neuen Buchungen an.API & MCP
Alles oben Beschriebene steht über die öffentliche REST-API und als MCP-Tools unterhttps://<your-domain>/mcp zur Verfügung. Anbieter-Integrationen (Cal.com, Calendly, Acuity, eTermin, HighLevel) und die Zuweisung eines beliebigen Kalenders zu einem Assistenten sind auf Kalender & Buchung beschrieben.
GET /api/v1/bookings und list_bookings unterstützen Filter nach Event-Typ, Quelle und Datum. Verwende view=upcoming|unconfirmed|recurring|past|cancelled für dieselben Buchungsansichten wie im Dashboard, oder nutze einen exakten status-Filter; view und status schließen sich gegenseitig aus.
Storniert du eine Buchung, wird ein ICS-Update mit
METHOD:CANCEL verschickt, sodass der Termin automatisch aus dem Kalender der eingeladenen Person verschwindet.