Webhook: Zustellung und neue Versuche
Wann eine Webhook-Nachricht als zugestellt gilt und wann meetpiloot es erneut versucht. Fünf weitere Versuche, verteilt über gut sieben Stunden.
Eine Nachricht gilt als zugestellt, sobald das empfangende System innerhalb von 5 Sekunden mit einem 2xx-Status antwortet. Antworte also schnell und erledige die aufwendige Arbeit erst nach der Antwort. Eine langsame Adresse wird nach 5 Sekunden abgebrochen.
Neue Versuche
Klappt der erste Versuch nicht, versucht meetpiloot es automatisch erneut, mit jeweils mehr Zeit dazwischen:
- SofortVersuch 1
- +1 Min.Versuch 2
- +5 Min.Versuch 3
- +15 Min.Versuch 4
- +60 Min.Versuch 5
- +360 Min.Versuch 6
Der erste Versuch geht sofort raus. Danach folgen fünf weitere Versuche, 1, 5, 15, 60 und 360 Minuten nach dem vorherigen. Der letzte Versuch liegt damit gut sieben Stunden nach dem ersten.
Wann meetpiloot es erneut versucht
| Antwort deines Systems | Was passiert |
|---|---|
| 2xx | Zugestellt. |
| Keine Antwort innerhalb von 5 Sekunden, oder keine Verbindung | Neuer Versuch nach dem Zeitplan. |
| 408 oder 429 | Neuer Versuch nach dem Zeitplan. Diese Codes bedeuten "versuch es später". |
| 5xx | Neuer Versuch nach dem Zeitplan. |
| Andere 4xx, etwa 400, 401 oder 404 | Kein neuer Versuch. Das System hat die Nachricht bewusst abgelehnt, zum Beispiel wegen einer falschen Adresse oder einer Signatur, die nicht stimmt. |
Klappt auch der letzte Versuch nicht, steht die Zustellung in deinem Dashboard in der Übersicht Letzte Nachrichten als Fehlgeschlagen, mit der letzten Fehlermeldung.
Doppelte Nachrichten erkennen
meetpiloot stellt jede Nachricht mindestens einmal zu. Geht eine Antwort verloren, zum Beispiel weil dein System die Nachricht verarbeitet, aber nicht rechtzeitig geantwortet hat, kann dieselbe Nachricht noch einmal kommen.
Jede Nachricht hat deshalb den Header X-Meetpiloot-Delivery mit einer festen ID. Die ID bleibt bei jedem neuen Versuch derselben Zustellung gleich. Speichere sie und verarbeite eine Nachricht mit einer ID, die du schon kennst, nicht noch einmal. Antworte trotzdem mit einem 2xx, damit meetpiloot keine weiteren Versuche macht.
Auch interessant
Kommst du nicht weiter?
Schreib uns oder öffne ein Ticket in deinem Dashboard. Antwort innerhalb von 1 bis 2 Werktagen.