Docs

Zapier

Empfange Workspace-Ereignisse und verarbeite sie mit Prüfung, Deduplizierung und Fehlerbehandlung in einem Zap.

Du brauchst Calberry Pro und Inhaber-/Admin-Zugriff auf Webhooks sowie einen Zapier-Tarif für die verwendeten Apps. Das Rezept nutzt Webhooks by Zapier, keine offizielle Calberry-App.

Aus einem Flow-Schritt senden

Nutze diesen Weg, um einen Zap beim Erreichen eines gewählten Sequenzschritts zu starten. Flow-Webhook-Schritte erfordern Pro und die Workspace-Freigabe.

  1. Erstelle einen Zap mit Webhooks by Zapier als Trigger-App und Catch Hook als Ereignis. Wähle Continue. Lass Pick Off A Child Key leer, damit die vollständige Hülle erhalten bleibt, und kopiere die Webhook-URL aus Test.
  2. Öffne in Calberry Sequenzen → Meine Sequenzen und bearbeite einen Flow. Nutze Termin vereinbart für eine Aktion nach der Buchung oder Vor Terminbeginn für eine zeitgesteuerte Aktion.
  3. Wähle Schritt einfügen → Webhook senden. Trage die Zapier-HTTPS-URL unter Webhook-URL ein und wähle Ziel speichern. Sichere den einmal angezeigten Signatur-Schlüssel, wenn du Signaturen prüfen möchtest.
  4. Wähle in Calberry Test senden, dann Verlauf aktualisieren. Wähle in Zapiers Reiter Test die Aktion Test trigger und lade den Request. Prüfe type = flow.webhook, data.test=true und die verschachtelten data.flow-IDs. Das Beispiel führt den übrigen Calberry-Flow nicht aus.
  5. Filtere vor echten Aktionen auf type = flow.webhook und schließe data.test=true aus. Ordne das Beispiel einem Testziel zu: Kontakt über data.lead.email, Termin-ID über data.booking.id, Zeiten aus data.booking und Antworten aus data.answers.
  6. Dedupliziere über event_id mit dauerhaftem Speicher und atomarer Eindeutigkeit. Speichere data.flow.step_id und data.flow.run_id zur Zuordnung; fasse verschiedene Schritte nicht allein anhand der Buchungs-ID zusammen.
  7. Wähle in Calberry Entwurf speichern → Veröffentlichen, prüfe die von der Version betroffenen Termine und wähle die Sequenz unter Kommunikation im Buchungslink aus. Veröffentliche/aktiviere den Zap. Prüfe eine bewusst angelegte echte Buchung in Calberry, Zapiers Ausführungsverlauf und deinem Zielsystem.

Catch Hook empfängt direkt ohne HMAC-Prüfung und prüft Calberry-Signaturen nicht automatisch. Halte die Zap-URL vertraulich. Benötigst du eine Prüfung, schalte deinen prüfenden Empfänger vor Zapier und leite nur angenommene Ereignisse weiter.

Ein nicht erreichbarer Zapier-Empfänger führt zu unabhängigen Calberry-Wiederholungen; Kunden-E-Mails laufen weiter. Ein HTTP-Erfolg belegt keinen Abschluss späterer Zap-Aktionen. Nimm deren Verarbeitung in Zapier wieder auf. Calberry-Replay sendet dasselbe gespeicherte Ereignis ohne erneute Ausführung von Sequenz oder E-Mails; dedupliziere es. Antwortdaten stehen späteren Calberry-Schritten nicht als Variablen zur Verfügung. Siehe Flow-Payload, Größenlimit und Replay.

Das verwendet generische Webhooks by Zapier, keine offizielle Calberry-App. Kopien in Zapier liegen an dessen Speicherorten und können die EU verlassen. Trigger-Einrichtung: Zapiers Webhook-Anleitung.

Ereignisstruktur einlesen

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

  1. Erstelle einen Zap mit Webhooks by Zapier → Catch Hook und kopiere seine Webhook-URL.
  2. Lege in Calberry einen Workspace-Webhook-Endpunkt an und wähle zunächst booking.created.
  3. Verwende die Zapier-URL für ein erstes synthetisches Beispiel und wähle in Calberry Testereignis senden.
  4. Lade im Reiter Test des Zaps den empfangenen Request. Prüfe type, event_id und die verschachtelten data-Felder.

Erstelle daraus keine echten CRM-Datensätze. Die Nutzdaten tragen data.test=true.

Vor Geschäftsaktionen prüfen

Catch Hook verarbeitet eingehende Daten, prüft aber nicht automatisch Calberrys HMAC-Protokoll. Catch Raw Hook kann rohe Eingaben liefern; der Zugriff auf exakte Bytes und Header sowie ein korrekter Verifier müssen trotzdem sichergestellt sein.

Für geprüften Empfang im Betrieb schaltest du deinen prüfenden Empfänger vor Zapier, deduplizierst dort dauerhaft und leitest nur geprüfte Ereignisse an die Zapier-URL weiter. Ändere das Calberry-Ziel auf diesen Empfänger. Halte die Zap-URL vertraulich und veröffentliche das Signatur-Secret nicht in öffentlichen Feldern.

Zap aufbauen

Filtere auf die Ereignistypen dieses Ablaufs und schließe data.test=true aus. Nutze für das synthetische Beispiel ein Test-CRM.

Für einen Buchungsablauf:

  1. Kontakt über data.lead.email suchen oder anlegen; vorhandenen Namen und Telefonnummer zuordnen.
  2. Terminaktivität mit data.booking.id als externer Kennung suchen oder anlegen.
  3. Start/Ende, Zeitzone und Status übernehmen. Passende Antworten und Attribution ergänzen; fehlende Werte dürfen vorhandene Angaben nicht durch leere Felder ersetzen.
  4. Den Abschluss der Wirkung für diese event_id speichern.

Deduplizierung muss dauerhaft und bei parallelen Läufen sicher sein. Eine getrennte Suche mit anschließendem Anlegen garantiert keine atomare Eindeutigkeit. Fehlgeschlagene CRM-Aktionen müssen erneut ausführbar bleiben, statt vorzeitig als erledigt zu gelten.

Für Umbuchung und Absage abonnierst du die entsprechenden Ereignisse und aktualisierst dieselbe Terminaktivität. Nachfassen bei Abbrechern verlangt data.consent=true.

Veröffentlichen und überwachen

Veröffentliche beziehungsweise aktiviere den Zap nach dem Test. Ein ausgeschalteter oder gelöschter Zap kann eine fehlerhafte Webhook-Antwort liefern. Prüfe sowohl Calberrys Zustellverlauf als auch den Zapier-Ausführungsverlauf: HTTP-Annahme belegt nicht den Erfolg einer späteren Aktion.

Teste bewusst eine echte Buchung und Änderungen. Nimm fehlgeschlagene Zielaktionen anhand des gespeicherten Ereignisses wieder auf. Sandbox-Buchungen lösen keine Workspace-Webhooks aus. Replay behält die Ereignis-ID und darf keine doppelten Aktivitäten erzeugen.

Aktuelle Triggerdetails: Zapier-Anleitung zu Webhook-Triggern.

Auf dieser Seite