Webhooks in meetergo

Mit Webhooks kann meetergo deine anderen Systeme automatisch benachrichtigen, wenn etwas Wichtiges passiert - etwa eine neue Buchung, eine Stornierung oder eine Terminverschiebung. Anstatt ständig nach Updates zu suchen, erhalten deine Systeme sofortige Benachrichtigungen, sodass alles synchron bleibt.

Webhooks sind für Teams- und Enterprise-Kunden verfügbar.

Was sind Webhooks?

Webhooks sind meetergo's Methode, deine anderen Tools auf dem Laufenden zu halten. Wenn etwas passiert - jemand bucht ein Meeting, storniert oder verschiebt einen Termin - senden wir sofort alle Details an eine Webadresse deiner Wahl. Von dort aus kann dein System die gewünschten Aktionen ausführen: dein CRM aktualisieren, dein Team in Slack benachrichtigen, eine E-Mail-Kampagne starten und vieles mehr.

Webhooks in meetergo einrichten

Navigiere zu Integrationen & Apps und finde den Webhooks-Bereich
Klicke auf "Webhook hinzufügen"
Gib die URL ein, an die du Benachrichtigungen erhalten möchtest (diese Adresse wird von deinem System oder deiner Integrationsplattform bereitgestellt)
Wähle aus, über welche Ereignisse du benachrichtigt werden möchtest
Klicke auf "Webhook erstellen"

Nach dem Speichern sendet meetergo Benachrichtigungen an deine URL, sobald diese Ereignisse eintreten. Jede Benachrichtigung enthält vollständige Informationen darüber, was passiert ist, sodass dein System alles hat, was es braucht.

Verfügbare Webhook-Ereignisse

meetergo sendet Webhooks für drei Haupttypen von Ereignissen. Jedes Ereignis liefert spezifische Informationen, die dein System verwenden kann.

Neue Termine — Wird ausgelöst, wenn jemand ein neues Meeting bucht. Du erhältst alle Buchungsdetails einschließlich Teilnehmerinformationen, Meetingzeit, Gastgeber und den Meetingtyp.
Stornierte Termine — Wird ausgelöst, wenn eine Buchung storniert wird. Die Daten enthalten dieselben Informationen wie bei einer erstellten Buchung, plus Stornierungsdetails.
Verschobene Termine — Wird ausgelöst, wenn jemand ein Meeting auf eine andere Zeit verschiebt. Dies umfasst sowohl die ursprüngliche Startzeit als auch alle Details des neu geplanten Meetings.

Webhook-Payloads verstehen

Wenn meetergo einen Webhook sendet, enthält er einen "Payload" - das Paket mit Informationen darüber, was passiert ist. Der Payload ist strukturierte Daten, die dein System einfach lesen und verwenden kann.

Bei erstellten und stornierten Buchungen befinden sich die Informationen auf der obersten Ebene. Bei verschobenen Buchungen findest du die ursprüngliche Startzeit oben und alle neuen Buchungsdetails verschachtelt darunter. Diese Struktur macht es einfach zu vergleichen, was sich geändert hat.

Webhooks testen

Nach dem Einrichten eines Webhooks buche ein Testmeeting oder löse das Ereignis manuell aus, um sicherzustellen, dass alles funktioniert. Überprüfe dein empfangendes System, um zu bestätigen, dass die Benachrichtigung mit allen erwarteten Informationen angekommen ist. Wenn etwas nicht funktioniert, überprüfe, ob deine URL korrekt und öffentlich erreichbar ist.

Webhook-Datenreferenz

Unten findest du die genaue Struktur der Daten, die meetergo für jeden Ereignistyp sendet. Deine Entwickler können diese verwenden, um Integrationen zu erstellen.

Buchungsereignis-Payload (`booking_created`, `booking_cancelled`)

{
  "id": "uuid",
  "secret": "string",
  "start": "2024-01-15T10:00:00.000Z",
  "end": "2024-01-15T11:00:00.000Z",
  "location": "string | null",
  "isCancelled": false,
  "rescheduledAt": "2024-01-14T12:00:00.000Z | null",
  "meetingInfo": { },
  "cancel": { },
  "ics": "string",
  "note": "string | null",
  "hostingInfo": { },
  "attendees": [
    {
      "id": "uuid",
      "email": "attendee@example.com",
      "phone": "+1234567890",
      "firstname": "John",
      "lastname": "Doe",
      "fullname": "John Doe",
      "timezone": "Europe/Berlin",
      "language": "en",
      "notes": "string | null",
      "attendeeEnrichment": { }
    }
  ],
  "hosts": [
    {
      "id": "uuid",
      "email": "host@example.com",
      "givenName": "Jane",
      "familyName": "Smith",
      "fullName": "Jane Smith",
      "slug": "jane-smith",
      "picture": "https://..."
    }
  ],
  "hostIds": ["uuid"],
  "meetingType": {
    "id": "uuid",
    "slug": "30-min-call",
    "meetingInfo": { },
    "meetingOptions": { },
    "crmOptions": { }
  },
  "meetingTypeId": "uuid",
  "paymentId": "string | null",
  "companyId": "uuid",
  "createdAt": "2024-01-14T09:00:00.000Z",
  "updatedAt": "2024-01-15T08:00:00.000Z"
}

Neuer Mitarbeiter Payload (`new_employee`)

{
  "id": "uuid",
  "email": "user@example.com",
  "givenName": "John",
  "familyName": "Doe",
  "fullName": "John Doe",
  "companyId": "uuid",
  "userType": "USER | ADMIN | COMPANY_ADMIN",
  "createdAt": "2024-01-15T10:00:00.000Z"
}

Terminverschiebung Payload (`booking_rescheduled`)

{
  "oldStartDate": "2024-01-15T10:00:00.000Z",
  "rescheduledAppointment": {
    "id": "uuid",
    "secret": "string",
    "start": "2024-01-16T14:00:00.000Z",
    "end": "2024-01-16T15:00:00.000Z",
    "location": "string | null",
    "isCancelled": false,
    "rescheduledAt": "2024-01-15T12:00:00.000Z",
    "meetingInfo": { },
    "cancel": { },
    "ics": "string",
    "note": "string | null",
    "hostingInfo": { },
    "attendees": [
      {
        "id": "uuid",
        "email": "attendee@example.com",
        "phone": "+1234567890",
        "firstname": "John",
        "lastname": "Doe",
        "fullname": "John Doe",
        "timezone": "Europe/Berlin",
        "language": "en",
        "notes": "string | null",
        "attendeeEnrichment": { }
      }
    ],
    "hosts": [
      {
        "id": "uuid",
        "email": "host@example.com",
        "givenName": "Jane",
        "familyName": "Smith",
        "fullName": "Jane Smith",
        "slug": "jane-smith",
        "picture": "https://..."
      }
    ],
    "hostIds": ["uuid"],
    "meetingType": {
      "id": "uuid",
      "slug": "30-min-call",
      "meetingInfo": { },
      "meetingOptions": { },
      "crmOptions": { }
    },
    "meetingTypeId": "uuid",
    "paymentId": "string | null",
    "companyId": "uuid",
    "createdAt": "2024-01-14T09:00:00.000Z",
    "updatedAt": "2024-01-15T12:00:00.000Z"
  }
}

Wichtiger Unterschied: booking_rescheduled enthält oldStartDate auf der obersten Ebene und verschachtelt die Termindaten unter rescheduledAppointment, während booking_created und booking_cancelled die Termindaten direkt auf der Stammebene senden.

FAQ

Kann ich Webhooks für bestimmte Meetingtypen filtern?

Webhooks werden für alle Meetingtypen in deinem Konto ausgelöst. Wenn du nur bestimmte Meetings verarbeiten möchtest, kannst du diese in deinem System mit den meetingType.id-Informationen im Payload filtern.

Wie schnell werden Webhooks nach einem Ereignis gesendet?

Webhooks werden sofort gesendet, wenn das Ereignis eintritt. In den meisten Fällen erhält dein System die Benachrichtigung innerhalb von Sekunden.

Benötige ich einen Entwickler, um Webhooks einzurichten?

Das Einrichten des Webhooks in meetergo ist unkompliziert, aber du benötigst technische Unterstützung, um den empfangenden Endpunkt zu erstellen, der die Benachrichtigungen verarbeitet. Wenn du eine Integrationsplattform wie Zapier oder Make verwendest, bieten diese oft vorgefertigte Webhook-Empfänger an.