Ereignisse und Nutzdaten
Die neun aktiven Workspace-Ereignisse, ihre öffentliche JSON-Hülle und die Felder für deine Anbindung.
Verfügbare Ereignisse
| Ereignis | Bedeutung |
|---|---|
lead.captured | Ein Lead mit Kontaktdaten wurde gespeichert; eine Buchung muss noch nicht vorliegen. |
lead.abandoned | Eine dafür geeignete erfasste Formularanfrage blieb bis zum Timeout ohne Buchung. |
lead.converted | Ein zuvor abgebrochener Lead hat später gebucht. |
booking.created | Eine Buchung wurde angelegt; eine Gast-Bestätigung kann noch ausstehen. |
booking.rescheduled | Ein Termin wurde verschoben. |
booking.cancelled | Ein Termin wurde abgesagt. |
booking.confirmed_by_invitee | Der Gast hat eine bestätigungspflichtige Buchung ausdrücklich bestätigt. |
booking.expired | Eine unbestätigte Buchung ist verfallen. |
booking.completed | Der geplante Termin ist zeitlich beendet. Das belegt weder Teilnahme noch Gesprächsergebnis. |
lead.disqualified und booking.no_show sind reserviert und derzeit nicht auswählbar.
Abbrecher-Erfassung gilt nur für geeignete Links mit Formular und Kalender und aktivierter Erfassung. Kalender-first und Headless erzeugen kein lead.abandoned. Ein wegen des Free-Buchungslimits gespeicherter Lead ist kein Formularabbrecher. Entsteht der Lead erst mit der Buchung, wird lead.captured vor booking.created angelegt.
flow.webhook entsteht ausschließlich in einem Flow-Schritt und ist kein auswählbares Workspace-Ereignis. Sein Ausführungs-Snapshot ergänzt die folgende Hülle um Flow-, Host- und Buchungslink-Kontext.
Öffentliche Ereignishülle
Der öffentliche Webhook ist ein unveränderlicher Ereignis-Snapshot, kein internes Datenbankereignis. Die äußeren Feldnamen verwenden snake case; Lead- und Buchungsfelder behalten die unten gezeigte Schreibweise. Ändere die Groß-/Kleinschreibung beim Mapping nicht.
| Feld | Bedeutung |
|---|---|
event_id | Stabile Identität des Ereignisses; anhand dieses signierten Bodyfelds deduplizieren. |
type | Einer der neun aktiven Workspace-Ereignisnamen oder flow.webhook für einen Flow-Schritt. |
created_at | UTC-Zeitpunkt des Ereignisses, nicht des aktuellen Zustellversuchs. |
data.actor | invitee, host oder system. |
data.schema_version | Öffentliche Schemaversion, derzeit 1. |
data.workspace_id | Zugehöriger Workspace. |
data.form_version | Formularversion dieses Snapshots. |
data.consent | Boolesche Nachfass-Einwilligung zum Ereigniszeitpunkt; kein Tracking- oder Reminder-Consent. |
data.lead | Lead-Kennungen und verfügbare Kontakt-/Statusfelder. |
data.booking | Buchungs-Snapshot, falls vorhanden; bei Buchungsereignissen erforderlich. |
data.answers | Formularantworten mit der jeweiligen Fragekennung als Schlüssel. |
data.attribution | Erfasste Kampagnen- und Herkunftsdaten. |
data.test | Bei synthetischen Testereignissen true, sonst normalerweise nicht vorhanden. |
Beispiel einer Buchung
Das Beispiel verwendet erfundene Kennungen und Kontaktdaten. Die IDs dienen der Veranschaulichung und sind keine Werte für echte API-Aufrufe.
{
"event_id": "ev_example",
"type": "booking.created",
"created_at": "2026-11-04T10:00:00.000Z",
"data": {
"actor": "invitee",
"schema_version": 1,
"workspace_id": "ws_example",
"form_version": 1,
"consent": false,
"lead": {
"id": "lead_example",
"workspaceId": "ws_example",
"funnelId": "funnel_example",
"name": "Alex Example",
"email": "alex@example.com",
"phone": null,
"status": "booked",
"createdAt": "2026-11-04T10:00:00.000Z"
},
"booking": {
"id": "booking_example",
"workspaceId": "ws_example",
"funnelId": "funnel_example",
"hostId": "host_example",
"leadId": "lead_example",
"start": "2026-11-10T09:00:00.000Z",
"end": "2026-11-10T09:30:00.000Z",
"timeZone": "Europe/Vienna",
"inviteeTimeZone": "Europe/London",
"status": "confirmed"
},
"answers": { "topic": "First consultation" },
"attribution": { "utm_source": "newsletter", "utm_campaign": "november" }
}
}Bei reinen Lead-Ereignissen kann data.booking fehlen. Nicht verfügbare Kontaktfelder und Zeitstempel dürfen fehlen; Telefonnummer und Teamreferenz können null sein. Den vollständigen Vertrag enthält das WebhookEvent-Schema. Fehlende Felder sind kein Auftrag, CRM-Daten zu löschen.
Grenzen beachten
Die Nutzdaten enthalten keine Buchungs-Aktionstokens, Umbuchungs-/Stornierungslinks oder Google-Meet-Links. Aktuelle Buchungsdetails erhältst du bei Bedarf mit passenden Scopes über die API.
Ersetze den eingefrorenen Consent nicht durch eine Vermutung aus dem Status oder dem heutigen Kontaktstand. Ein abgebrochener Lead mit data.consent=false darf nicht automatisch angeschrieben werden.
Testereignisse dürfen keine echten Kontakte, Deals oder Nachrichten auslösen. Retry und Replay behalten Ereignis-ID und Body. Beachte die Zustell- und Reihenfolgeregeln, bevor du mehrere Ereignisse als streng geordnete Historie verarbeitest.