Wiederholungen, Reihenfolge und Replay
Verarbeite doppelte Zustellungen, prüfe Fehler und beachte die begrenzte Reihenfolgegarantie zwischen Lead und Buchung.
Zustellungen können sich wiederholen
Ein Empfänger kann dasselbe Ereignis mehrfach erhalten, etwa nach einem Timeout, bei dem seine erste Antwort Calberry nicht erreicht hat. Speichere event_id aus dem geprüften Body und führe nachgelagerte Wirkungen idempotent aus. Ein Replay ist ein weiterer Zustellversuch, kein neues fachliches Ereignis.
Antworte nach dauerhafter Annahme mit 2xx. Bestätige keinen Request, der beim nächsten Prozessneustart verloren geht. Nutzt du eine eigene Warteschlange, überwache und wiederhole deren Verarbeitung separat: Calberrys Zustellerfolg endet bei deiner HTTP-Bestätigung.
Automatische Wiederholungen
Fehlerhafte und unklare Versuche verwenden Backoff. Standard im Code sind ein Erstversuch und fünf Wiederholungen; die Abstände beginnen bei 30 Sekunden und verdoppeln sich, begrenzt auf eine Stunde. Der Request-Timeout beträgt standardmäßig zehn Sekunden. Diese Werte sind konfigurierbar und keine Zusage für Zustellzeiten. Für den Betrieb ist der angezeigte nächste Versuch maßgeblich.
HTTPS-Ziele müssen öffentlich erreichbar sein und dürfen nicht weiterleiten. DNS-Probleme, Netzwerkfehler, Timeouts und erfolglose HTTP-Antworten erscheinen im Verlauf. Sind die automatischen Versuche ausgeschöpft, endet die Zustellung in Dead-Letter.
Fehler prüfen und erneut zustellen
- Öffne Entwicklung → Webhooks → Zustellverlauf.
- Filtere nach Endpunkt und Status und öffne Versuche und Payload ansehen.
- Prüfe HTTP-Ergebnis, Fehler und Versuche. Kontrolliere Zieladresse, Secret, Erreichbarkeit und Mapping.
- Behebe die Ursache und aktiviere gegebenenfalls den pausierten Endpunkt.
- Wähle Erneut zustellen und prüfe den neuen Versuch sowie das Ausführungsprotokoll deines Zielsystems.
Replay behält event_id und den exakten Body; nur der Signaturzeitstempel wird erneuert. Ein bereits verarbeitetes Ereignis kann erneut eintreffen. Umgehe damit weder Consent-Prüfungen noch die Deduplizierung von CRM-Aktivitäten.
Unabhängige Flow-Zustellung
Flow-Webhooks verwenden dieselben Retry-Standardwerte und behalten beim Replay Snapshot und Ereignis-ID. Der Flow läuft nach dauerhafter Übergabe sofort weiter, einschließlich Kunden-E-Mails bei Empfängerausfall. Replay führt weder Sequenz noch E-Mails erneut aus. Prüfe den Schrittverlauf oder Sequenzen → Verlauf → Webhook-Zustellungen.
Das standardmäßige 256-KiB-Bodylimit gilt nur für Flow-Zustellungen, Tests und Replay. payload_too_large ist ohne HTTP-Anfrage endgültig und stoppt keine späteren Flow-Schritte. Unabhängige Flow-Webhooks übernehmen die folgende Workspace-Reihenfolgeabhängigkeit nicht; ihre HTTP-Anfragen können außerhalb der Schrittreihenfolge eintreffen.
Workspace-Reihenfolgegarantie
Für denselben Endpunkt und Lead wartet booking.created auf eine protokollierte 2xx-Zustellung des ausgewählten lead.captured. Retry, Backoff und Dead-Letter heben die Abhängigkeit nicht auf. Ein erfolgreiches Replay des Capture kann die wartende Buchung freigeben. Die Oberfläche zeigt Wartet auf lead.captured.
Die Abhängigkeit entfällt, wenn der Endpunkt ursprünglich nur Buchungsereignisse auswählte oder das Capture vor seiner Anlage lag. Replays behalten ihre ursprüngliche Zuordnung; spätere Filteränderungen erzeugen keine historische Abhängigkeit. Ein später fehlgeschlagenes Replay hebt einen bereits erfolgreichen Capture nicht auf.
Es gibt keine globale Reihenfolgegarantie zwischen Ereignissen, Leads oder Endpunkten. Die Zusage betrifft den Beginn der HTTP-Zustellung nach Capture-Annahme, nicht die Reihenfolge paralleler Arbeit im Zielsystem. Vergleiche Zeitstempel und speichere Ereignishistorie, statt den zuletzt angekommenen Request als neuesten Zustand zu behandeln.
Pausen und Lücken
Ereignisse vor Endpunktanlage oder während einer Pro-Zugriffspause werden nicht nachgeliefert. Für einen Abgleich kannst du die dokumentierten Listen-/Delta-Operationen der API nutzen. Der Ereignis-Snapshot bleibt unverändert; den aktuellen Buchungszustand liest du bei Bedarf gesondert aus.