Webhooks konfigurieren

Die Webhooks Mit der Funktion in Bookablesites können Sie Echtzeit-Ereignisdaten von der Plattform über benutzerdefinierte URLs an externe Anwendungen senden. Verwenden Sie es, um Benachrichtigungen zu automatisieren und Buchungsdaten für optimierte Integrationen an andere Systeme zu übertragen.

Die Webhooks Die Funktion für Bookablesites ist eine Premium-Option und wird auf Ihre gesamten benutzerdefinierten Funktionen und Integrationen angerechnet.

Erste Schritte

  • Aktivieren Webhooks auf der Funktionen und Integrationen Seite.
  • Klicken Sie nach der Aktivierung auf „Einrichten“, um die Webhooks-Verwaltungsseite zu öffnen. Anfangs wird es keine Webhooks geben, also erstellen Sie neue mit der Schaltfläche Webhook erstellen oben rechts

Verfügbare Webhook-Ereignisarten Sie können für jedes dieser Ereignisse einen Webhook erstellen. Klicken Sie auf das “Webhook erstellen“:

  • Termin gebucht
  • Termin abgesagt
  • Termin verschoben
  • Terminstatus geändert
  • Kunde erstellt
Screenshot eines Web-Dashboards, das den Abschnitt „Webhooks“ unter „Funktionen und Integrationen“ zeigt, mit Optionen zum Hinzufügen von Webhook-URLs und einer hervorgehobenen Schaltfläche „Webhook erstellen“.

Bitte beachten Sie, dass Sie in dieser Phase nur einen einzigen Webhook für jeden Typ erstellen können. Dies bedeutet, dass es nur einen ‘Termin gebucht’ Webhook, einen ‘Termin storniert’ Webhook usw. geben kann.

Konfigurationsoptionen Beim Erstellen eines Webhooks können Sie Folgendes festlegen:

  • Name — eine beschreibende Bezeichnung für den Webhook.
  • Website-URL — der Endpunkt, an dem bookablesites die Ereignisnutzlast POSTet.

Testen und Nutzlast Ihrer Webhooks:

Test-Webhook senden sendet Beispieldaten an die konfigurierte URL, damit Sie die Nutzlast und Zuordnung überprüfen können. Die Testnutzlast umfasst Details wie:

  • Terminstatus, Start-/Enddaten und -zeiten, kombiniertes Start-/Enddatum/-zeit
  • Terminpreis
  • Vollständiger Name des Kunden, Vorname, Nachname, E-Mail, Telefon
  • Vollständiger Name des Mitarbeiters, Vorname, Nachname, E-Mail, Telefon
  • Servicekategorie, Name, Dauer, Preis
  • Extras
  • Standortname, Adresse, Telefon
  • Benutzerdefinierte Felder

So können Sie sicherstellen, dass der Webhook korrekt konfiguriert ist, um die notwendigen Informationen für Ihre Integrationsanforderungen zu senden.

Anmerkungen

Sie können nur einen Webhook pro Veranstaltungstyp erstellen (z. B. einen einzelnen Webhook „Termin gebucht“).

Die Nutzlastformatierung folgt den Einstellungen, die Sie auf Bookablesites gewählt haben. Veranstaltungen werden über HTTP übermittelt POST Anfragen.

Sicherheit

Verifizierungstoken Klicken Sie auf die Schaltfläche „Verifizierungstoken“ (in der Nähe von „Webhook erstellen“), um Ihr Token anzuzeigen und zu kopieren. Wenn dieses Token im Autorisierungsheader jeder Webhook-Anfrage enthalten ist, können Sie eingehende Anfragen authentifizieren und bestätigen, dass sie von Bookablesites stammen.

Eine Webseite zeigt ein Popup “Verifizierungstoken” mit einer Token-Zeichenfolge und Optionen zum Kopieren des Tokens oder Schließen des Popups an; Webhook-Einstellungen sind im Hintergrund sichtbar.

Beispiele und Integrationen

Integratoren von Drittanbietern wie Pabbelig „ KonnectzIT haben Integrationen mithilfe von Bookablesites-Webhooks erstellt und gezeigt, wie Sie die Plattform mit externen Automatisierungs- und Workflow-Tools verbinden können.