Docs

Ereignisse und Nutzdaten

Die neun aktiven Workspace-Ereignisse, ihre öffentliche JSON-Hülle und die Felder für deine Anbindung.

Verfügbare Ereignisse

EreignisBedeutung
lead.capturedEin Lead mit Kontaktdaten wurde gespeichert; eine Buchung muss noch nicht vorliegen.
lead.abandonedEine dafür geeignete erfasste Formularanfrage blieb bis zum Timeout ohne Buchung.
lead.convertedEin zuvor abgebrochener Lead hat später gebucht.
booking.createdEine Buchung wurde angelegt; eine Gast-Bestätigung kann noch ausstehen.
booking.rescheduledEin Termin wurde verschoben.
booking.cancelledEin Termin wurde abgesagt.
booking.confirmed_by_inviteeDer Gast hat eine bestätigungspflichtige Buchung ausdrücklich bestätigt.
booking.expiredEine unbestätigte Buchung ist verfallen.
booking.completedDer 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.

FeldBedeutung
event_idStabile Identität des Ereignisses; anhand dieses signierten Bodyfelds deduplizieren.
typeEiner der neun aktiven Workspace-Ereignisnamen oder flow.webhook für einen Flow-Schritt.
created_atUTC-Zeitpunkt des Ereignisses, nicht des aktuellen Zustellversuchs.
data.actorinvitee, host oder system.
data.schema_versionÖffentliche Schemaversion, derzeit 1.
data.workspace_idZugehöriger Workspace.
data.form_versionFormularversion dieses Snapshots.
data.consentBoolesche Nachfass-Einwilligung zum Ereigniszeitpunkt; kein Tracking- oder Reminder-Consent.
data.leadLead-Kennungen und verfügbare Kontakt-/Statusfelder.
data.bookingBuchungs-Snapshot, falls vorhanden; bei Buchungsereignissen erforderlich.
data.answersFormularantworten mit der jeweiligen Fragekennung als Schlüssel.
data.attributionErfasste Kampagnen- und Herkunftsdaten.
data.testBei 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.

Auf dieser Seite