Docs

Workspace-Webhooks

Sende ausgewählte Lead- und Buchungsereignisse an deinen HTTPS-Empfänger und prüfe die Zustellung.

Workspace-Webhooks senden unterstützte Ereignisse deines Workspace an externe Werkzeuge. Du konfigurierst sie pro Endpunkt, unabhängig von E-Mail-Sequenzen. Zum Ändern brauchst du Pro, Webhook-Zugriff und die Rolle Inhaber oder Admin.

Für den Versand an einer gewählten Stelle in der Sequenz verwendest du einen Flow-Webhook-Schritt. Er hat ein eigenes Ereignis flow.webhook und einen eigenen Zielmodus; die beiden Modi teilen keine Abonnements.

Endpunkt anlegen

  1. Stelle einen öffentlich erreichbaren HTTPS-Empfänger bereit. Er muss Requests direkt annehmen; Calberry folgt keinen Weiterleitungen und erlaubt keine Ziele in privaten Netzen.
  2. Öffne im Workspace-Menü Entwicklung → Webhooks.
  3. Wähle Endpunkt anlegen und trage die HTTPS-Zieladresse ein.
  4. Wähle die benötigten Ereignisse. Standardmäßig sind alle neun aktiven Ereignisse ausgewählt; mindestens eines ist erforderlich.
  5. Speichere und kopiere das jetzt angezeigte Secret. Hinterlege es sicher im Empfänger für die Signaturprüfung. In Endpunktlisten und Zustellprotokollen wird es nicht angezeigt.

Wähle nur die Ereignisse, die deine Anbindung benötigt. Ein CRM, das nur neue Buchungen verarbeiten soll, braucht beispielsweise nicht automatisch Ereignisse unvollständiger Formulare.

Empfänger testen

Wähle Testereignis senden. Calberry stellt ein synthetisches Ereignis mit data.test=true in die Zustellwarteschlange. Es enthält keine echten Kontakt- oder Buchungsdaten. Die Vormerkung bedeutet noch nicht, dass das Ziel es angenommen hat.

Öffne den Zustellverlauf und prüfe Nutzdaten, HTTP-Ergebnis und Versuche. Der Test verwendet denselben Signatur- und Zustellweg wie normale Webhooks. Prüfe Signatur und Testereignis-Erkennung, bevor du echte Geschäftsaktionen ausführst.

Sandbox-Testbuchungen aus dem Dashboard lösen keine Workspace-Webhooks aus. Verwende dafür Testereignis senden. Für einen vollständigen Geschäftsablauf kannst du anschließend bewusst eine echte Buchung durchführen.

Filter und Verlauf

Es werden nur Ereignisse ab Anlage des Endpunkts zugestellt. Eine historische Nachlieferung gibt es nicht. Die Bedingungen je Ereignis stehen in der Ereignisreferenz.

Im Zustellverlauf filterst du nach Endpunkt und Status. Ausstehend bedeutet vorgemerkt, In Zustellung einen laufenden Versuch, Zugestellt einen HTTP-Erfolg und Dead-Letter einen zu prüfenden Fehler. Ein erfolgreicher HTTP-Status bestätigt die Annahme beim Empfänger, nicht den Abschluss einer nachgelagerten CRM-Aktion.

Nutze die erneute Zustellung erst, wenn du die Fehlerursache behoben und die Deduplizierung geprüft hast.

Pausieren, löschen und Secret wechseln

Ein pausierter Endpunkt führt keine Zustellversuche aus. Aktiviere ihn vor Test oder Replay wieder. Löschen stoppt weitere Zustellungen; der Verlauf bleibt erhalten.

Secret rotieren ersetzt das Signatur-Secret sofort. Aktualisiere deinen Empfänger. Ein bereits laufender Versuch kann noch das alte Secret verwenden. Akzeptiere während der Umstellung beide und entferne danach das alte. Die Rotation verändert weder Ereignis-IDs noch die zuvor signierten Bodydaten.

Endet Pro, werden Schlüssel und Endpunkte pausiert statt gelöscht. Nach erneutem Upgrade laufen Webhooks weiter, ohne die Ereignisse der Pause nachzuliefern.

Personenbezogene Daten

Calberry speichert Lead- und Buchungsdaten in der EU. Webhooks übertragen Kontaktdaten, Antworten und Attribution an von dir gewählte Ziele. Diese Kopien liegen an deren Speicherorten und können die EU verlassen. Beschränke dort Zugriff und Aufbewahrung.

Die Request-Schemas zur Endpunktverwaltung findest du in der generierten API-Referenz.

Auf dieser Seite