Docs

Make

Baue ein Webhook-Szenario mit Ereignisfilter, sicherem Mapping und eigener Fehlerbehandlung.

Du brauchst einen Calberry-Pro-Workspace, Inhaber-/Admin-Zugriff auf Webhooks und einen Make-Account mit den verwendeten Modulen. Das Rezept nutzt Make Webhooks, keinen nativen Calberry-Connector.

Aus einem Flow-Schritt senden

Nutze diesen Weg, wenn eine Automatisierung an einer gewählten Stelle in einer Sequenz starten soll. Flow-Webhook-Schritte erfordern Pro und die Workspace-Freigabe.

  1. Erstelle in Make ein Szenario, füge Webhooks → Custom webhook hinzu und wähle Add. Vergib einen Namen, speichere und kopiere die erzeugte HTTPS-URL.
  2. Wähle Run once, damit das Modul auf Beispieldaten wartet.
  3. Öffne in Calberry Sequenzen → Meine Sequenzen und bearbeite einen Flow. Wähle Termin vereinbart für eine Aktion nach der Buchung oder Vor Terminbeginn für eine zeitgesteuerte Aktion.
  4. Wähle an der gewünschten Stelle Schritt einfügen → Webhook senden. Trage die Make-URL unter Webhook-URL ein und wähle Ziel speichern. Sichere den einmal angezeigten Signatur-Schlüssel, wenn du Signaturen prüfen möchtest.
  5. Wähle Test senden, dann Verlauf aktualisieren im Schritt. Prüfe das empfangene Bundle in Make: type ist flow.webhook, data.test ist true, und data.flow identifiziert den Beispielschritt/-lauf. Dieser Test führt die Sequenz nicht aus.
  6. Ordne data.lead.email, data.booking.id, Terminzeiten, data.answers und benötigte Host-/Link-Felder zu. Filtere vor echten Aktionen auf type = flow.webhook und schließe data.test=true aus. Erprobe das Mapping mit einem getrennten Testziel.
  7. Dedupliziere vor Geschäftsaktionen über event_id mit dauerhafter, atomarer Speicherung. Bewahre data.flow.step_id und data.flow.run_id zur Zuordnung auf; verschiedene Schritte derselben Buchung sind verschiedene Ereignisse.
  8. Wähle in Calberry Entwurf speichern → Veröffentlichen, prüfe die betroffenen Termine und ordne die veröffentlichte Sequenz unter Kommunikation im Buchungslink zu. Aktiviere das Make-Szenario mit dem gewünschten Zeitplan. Prüfe eine bewusst angelegte echte Buchung in beiden Verläufen und im Zielsystem.

Der direkte Empfang in Make funktioniert ohne HMAC-Prüfung; Custom webhook prüft Calberry-Signaturen nicht automatisch. Halte die URL vertraulich. Für geprüften Empfang verwendest du den Signatur-Verifier in deinem eigenen Empfänger und leitest angenommene Ereignisse an Make weiter.

Ist Make nicht erreichbar, wiederholt Calberry die Zustellung unabhängig und Kunden-E-Mails laufen weiter. Prüfe Calberrys Webhook-Verlauf und Makes Ausführungsverlauf. Eine HTTP-Annahme durch Make kann vor einem späteren Modulfehler liegen. Replay sendet dasselbe Ereignis ohne erneute Ausführung von Flow oder E-Mails; behalte den Duplikatschutz bei. Der Antwortinhalt steht nicht als spätere Flow-Variable bereit. Siehe Flow-Payload, Größenlimit und Replay.

Das verwendet generische Webhooks, keine offizielle Calberry-Connector-App. Kopien in Make liegen an dessen Speicherorten und können die EU verlassen. Siehe Makes Webhook-Einrichtung und Verarbeitung und Verlauf.

Beispieldaten empfangen

Das folgende Rezept verwendet Workspace-Ereignis-Abonnements unabhängig von Flows.

  1. Erstelle ein Make-Szenario mit Webhooks → Custom webhook und kopiere die erzeugte HTTPS-URL.
  2. Starte Run once, damit Make ein Beispiel erkennen kann.
  3. Lege in Calberry einen Workspace-Webhook-Endpunkt an und wähle booking.created.
  4. Für die erste Datenstrukturerkennung trägst du die Make-URL ein und wählst Testereignis senden. Prüfe Calberrys Zustellverlauf und das empfangene Bundle in Make.

Für geprüften Empfang echter Daten verwendest du die Signaturprüfung. Das Modul Custom webhook bestätigt für sich allein nicht, dass der Request von Calberry stammt. Kann deine Einrichtung Originalbytes und Header nicht prüfen, ändere das Calberry-Ziel auf deinen prüfenden Empfänger und leite von dort angenommene Ereignisse an Make weiter. Behandle die Make-URL vertraulich.

Filtern und zuordnen

Setze vor CRM-Aktionen folgende Prüfungen:

  • Für diesen Pfad nur type = booking.created zulassen.
  • data.test = true von echten Geschäftsaktionen ausschließen. Nutze beim Mapping ein getrenntes Testziel.
  • Über event_id dauerhaft deduplizieren. Ein bloßes „prüfen, dann anlegen“ kann bei parallelen Läufen doppelt ausführen; serialisiere oder nutze einen Empfänger mit atomarer Unique-Key-Reservierung.

Suche oder erstelle den Kontakt über data.lead.email im richtigen Workspace-/Kundenkontext. Übernimm Name und Telefonnummer nur, wenn sie vorliegen. Verwende data.booking.id als externe Kennung der Terminaktivität. Start, Ende, Zone und Status kommen aus data.booking, Antworten aus data.answers, Kampagnendaten aus data.attribution.

Lege nicht für lead.captured und booking.created dieselbe Aktivität doppelt an. Nachfassen bei einem Abbrecher setzt data.consent=true voraus.

Umbuchung und Absage ergänzen

Abonniere booking.rescheduled und booking.cancelled und verzweige nach type. Aktualisiere die bestehende Aktivität anhand der Buchungs-ID; erstelle nicht für jede Änderung einen neuen Deal. Ereignis-IDs verhindern doppelte Wirkungen, Buchungs-IDs identifizieren den fachlichen Datensatz.

Aktiviere nach dem Test die Szenario-Zeitplanung für den laufenden Empfang. Prüfe bewusst eine echte Buchung, Umbuchung und Absage im Szenarioverlauf und CRM. Sandbox-Buchungen senden keine Workspace-Ereignisse.

Fehler auffangen

Make kann einen Webhook bestätigen, bevor alle späteren Module abgeschlossen sind. Calberry kann daher „Zugestellt“ anzeigen, obwohl ein CRM-Schritt fehlschlug. Überwache den Make-Ausführungsverlauf und richte Fehlerbehandlung beziehungsweise Wiederaufnahme ein. Bewahre angenommene Ereignisse bis zum Abschluss auf. Replay aus Calberry setzt Deduplizierung voraus.

Modul- und Zeitplanungsdetails: Make-Dokumentation zu Webhooks.

Auf dieser Seite