API & Integrationen

API & Integrationen

FlowCaptain funktioniert sofort nach der Einrichtung — ohne externe Tools oder Programmierung. Für individuelle Integrationen steht dir zusätzlich eine vollständige API zur Verfügung.

Wann brauchst du die API?

• Eigene Voice-Bot-Plattform — Du betreibst bereits einen Voice Bot und möchtest FlowCaptains Terminlogik anbinden
• Chat-Integration — Du möchtest Terminbuchungen in deinen Website-Chat oder Messenger einbauen
• Automatisierungen — Du möchtest Termine aus anderen Systemen heraus buchen oder prüfen

Integrationsmethoden

Autopilot — Ein einziger Endpunkt für die komplette Gesprächsführung. FlowCaptain übernimmt Begrüßung, Terminsuche, Buchung und Verabschiedung. Dein System leitet nur Nachrichten weiter.

Einzelne Endpunkte (REST) — Separate Endpunkte für jede Aktion (Verfügbarkeit prüfen, buchen, stornieren, umbuchen). Du steuerst den Gesprächsfluss selbst.

MCP (Model Context Protocol) — Ein Endpunkt, über den dein System alle verfügbaren Tools automatisch erkennt.

Basis-URL

https://api.flowcaptain.com

Eine interaktive API-Dokumentation findest du unter api.flowcaptain.com/docs.

Authentifizierung

Alle API-Anfragen erfordern einen API-Schlüssel als Bearer-Token (erstellt in den Workspace-Einstellungen unter API-Schlüssel):

Authorization: Bearer sk_live_dein_api_schluessel

Jede Anfrage benötigt außerdem deine Kalender-ID. Autopilot- und REST-Endpunkte erfordern calendarId als Feld im JSON-Body; MCP erfordert sie als Query-Parameter in der URL. Du findest deine Kalender-ID vorausgefüllt in jedem Beispiel unter Dashboard → Kalender → API → Integrations-Anleitung. Falls deine Plattform den Anfrage-Body in einen Umschlag einpackt (z.B. Retells args-Objekt), übergib calendarId stattdessen als URL-Query-Parameter — ?calendarId=YOUR_CALENDAR_ID — denn die API liest sie nur aus dem Top-Level-Body, der Query-Zeichenkette oder den Routen-Parametern, niemals aus einem verschachtelten args-Objekt.