Für Entwickler
FlowCaptain per API, MCP oder eigener Voice-Bot-Plattform in bestehende Systeme einbinden.
FlowCaptain funktioniert ohne Programmierung: Der eingebaute Assistent nimmt Anrufe an und bucht Termine. Dieser Bereich ist für alle, die FlowCaptains Terminlogik in eigene Systeme einbauen. Wenn du einfach loslegen willst, starte bei Erste Schritte.
Wann brauchst du die API?
- Eigene Voice-Bot-Plattform — Du betreibst bereits einen Voice Bot und möchtest FlowCaptains Terminlogik anbinden.
- Eigene Oberflächen — Du möchtest Terminbuchungen in deine Website, dein Buchungsformular oder deinen eigenen Chat einbauen. FlowCaptain selbst bietet keinen Chat-Kanal für Anrufer an; du baust ihn auf der API.
- Automatisierungen — Du möchtest Termine aus anderen Systemen heraus prüfen oder buchen.
Drei Wege der Anbindung
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. → Autopilot
Einzelne Endpunkte (REST) — Je ein Endpunkt pro Aktion: Verfügbarkeit prüfen, buchen, stornieren, umbuchen, Rückruf. Du steuerst den Gesprächsfluss selbst. → Verfügbarkeit prüfen · Buchen, Stornieren, Umbuchen & Rückruf
MCP (Model Context Protocol) — Ein Endpunkt, über den dein System alle Werkzeuge automatisch erkennt. → MCP-Endpunkt
Wie du die gängigen Voice-Bot-Plattformen anschließt, steht unter Plattform-Einrichtung.
Basis-URL
https://api.flowcaptain.com
Eine interaktive API-Dokumentation findest du unter api.flowcaptain.com/docs.
Schlüssel und Kalender-ID
Jede Anfrage braucht zwei Dinge:
- einen API-Schlüssel als Bearer-Token im
Authorization-Header — du erstellst ihn in den Workspace-Einstellungen, Details unter API-Schlüssel; - die Kalender-ID des Kalenders, um den es geht — vorausgefüllt in jedem Beispiel unter Kalender › Name › API im Abschnitt Integrations-Anleitung.
Authorization: Bearer sk_live_dein_api_schluessel
Autopilot- und REST-Endpunkte erwarten calendarId als Feld im JSON-Body; MCP erwartet sie als Query-Parameter in der URL. 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, nie aus einem verschachtelten args-Objekt.