Technische Referenz
Verbinde Calberry mit Website und Werkzeugen; genaue Endpunktverträge stehen in der generierten API-Referenz.
Hier findest du Workspace- und Flow-Webhooks, Signaturprüfung, Embed und Integrationsrezepte. Ein Buchungslink heißt in der API Funnel. Kennungen und Ereignisnamen bleiben in beiden Sprachen gleich.
Endpunktverträge
Nutze die vorhandene generierte Referenz, statt Endpunktschemas aus einem Artikel zu übernehmen:
Die Basis-URL lautet https://api.calberry.ai; Ressourcenpfade beginnen mit /v1. Die Referenz nennt Scopes, Request-/Response-Schemas sowie den Status stabil oder Beta. Zum stabilen Umfang gehören Slots, Buchungen anlegen/verschieben/stornieren, Lead-Anlage und -Liste, Funnels lesen und Webhook-Verwaltung. Weitere freigegebene Operationen gelten als Beta, sofern die Referenz nichts anderes ausweist.
Authentifizierung und sichere Schreibzugriffe
API und Workspace-Webhooks erfordern Pro und die passende Workspace-Berechtigung. Inhaber/Admins verwalten Schlüssel unter Entwicklung → API. Speichere den Schlüssel bei der Ausgabe und vergib nur die benötigten Scopes. Die Schlüsselverwaltung selbst verlangt eine angemeldete Inhaber-/Admin-Session.
Private API-Schlüssel bleiben auf dem Server. Sie gehören weder ins Embed noch in Website-JavaScript, öffentliche Repositories oder URL-Parameter. Öffentliche Buchungs- und Embed-Routen verwenden einen getrennten Besucherablauf.
Sende bei Schreibzugriffen einen Idempotency-Key. Für die Wiederholung derselben Aktion mit denselben validierten Daten bleibt der Key gleich. Eine neue beabsichtigte Aktion bekommt einen neuen Key. Derselbe Key mit widersprüchlichen Daten führt zu einem Idempotenzkonflikt.
Verarbeite die dokumentierte Fehlerhülle und Rate-Limit-Antworten. Beachte Retry-After, falls vorhanden, paginiere Listen und nutze die dokumentierten Delta-Filter. Eine erfolgreiche Buchungsantwort und die abgeschlossene Google-Kalender-Synchronisation sind getrennte Ergebnisse.
Anbindung auswählen
- KI-Assistenten / MCP: Tools, API-Schlüssel-Rechte und Einrichtung für Claude Code, Cursor und weitere Clients mit Header-Unterstützung.
- Workspace-Webhooks: unterstützte Lead- und Buchungsereignisse empfangen.
- Flow-Webhooks: signierten Snapshot im Sequenzschritt senden, während Kunden-E-Mails weiterlaufen.
- Ereignisse und Nutzdaten: öffentliche Hülle und Bedeutung der Ereignisse.
- Signaturen prüfen: Verifier für unveränderte Bodybytes und Testvektor.
- Wiederholungen und Replay: Deduplizierung und Grenzen der Reihenfolge.
- Embed-Referenz: Script, Prefill, eigene Oberfläche und Website-Baukästen.
- Integrationsrezepte: Make, Zapier und CRM.
Workspace-Webhooks liefern Ereignisse unabhängig von Sequenzen. WhatsApp ist demnächst verfügbar.