Skip to main content
Ein Webhook lässt Zippendo ein anderes System über ein Ereignis informieren, zum Beispiel Sendung versendet oder Sendungsverfolgung aktualisiert. Webhooks richtest du unter Einstellungen → Webhooks ein (öffne das Organisationsmenü und klicke auf Verwalten). Für jedes Ereignis sendet Zippendo eine Nachricht an die Endpunkt-URL, die du eingegeben hast. Das sind keine Webhooks zur Sendungsverfolgung der Versanddienstleister. Zu diesen siehe Webhooks zur Sendungsverfolgung.

​
Was du siehst

  • Dein System empfängt nie etwas.
  • Das Zustellprotokoll eines Webhooks zeigt rote Statuscodes oder Text in der Spalte Fehler.
  • Dein System empfängt dasselbe Ereignis mehrmals.

​
Zuerst das Zustellprotokoll prüfen

Klicke bei Webhooks beim Webhook auf Zustellprotokoll. Jede Zeile ist ein Versuch, mit dem Ereignis, dem Status, mit dem dein System geantwortet hat, der Dauer und eventuell einem Fehler.
  • Noch keine Zustellungen: Zippendo hat noch nichts zu senden versucht. Siehe „Es wird nichts gesendet“ unten.
  • Ein grüner Status: Dein System hat die Nachricht empfangen. Suche das Problem in deinem eigenen System.
  • Ein roter Status oder k. A. mit einem Fehler: Dein System hat die Nachricht nicht akzeptiert. Siehe „Zustellungen schlagen fehl“ unten.

​
Es wird nichts gesendet

​
Zustellungen schlagen fehl

Zippendo wertet eine Zustellung nur dann als erfolgreich, wenn dein System innerhalb von 10 Sekunden mit einem Erfolgsstatus (200-299) antwortet. Andernfalls versucht es innerhalb von etwa einer Minute noch einige Male, insgesamt 5 Versuche. Danach wird das Ereignis nicht erneut gesendet. Klicke nach der Behebung der Ursache beim Webhook auf Test senden. Du siehst Testereignis gesendet, und im Zustellprotokoll erscheint eine neue Zeile.
Zippendo sendet fehlgeschlagene Ereignisse später nicht erneut. Wenn dein System eine Weile nicht erreichbar war, suche die verpassten Sendungen oder Bestellungen in der Zippendo-App oder rufe sie über die API ab.

​
Dein System lehnt die Signatur ab

Jede Nachricht trägt einen Header X-Webhook-Signature, damit dein System prüfen kann, dass sie wirklich von Zippendo kommt. Es ist ein HMAC-SHA256 des rohen Nachrichtenkörpers, erstellt mit dem Secret des Webhooks. Häufige Fehler:
  • Die Signatur wird über die Nachricht berechnet, nachdem sie geparst und umgeschrieben wurde, statt über den rohen Körper genau so, wie er empfangen wurde.
  • Es wird das Secret eines anderen Webhooks verwendet. Jeder Webhook hat sein eigenes Secret.
Details und Codebeispiele: Webhooks-Schnellstart.

​
Dasselbe Ereignis kommt zweimal an

Wenn dein System zu langsam oder mit einem Fehler geantwortet hat, versucht Zippendo es erneut, auch wenn dein System den ersten Versuch verarbeitet hat. Nutze den Header X-Webhook-Id, um eine bereits verarbeitete Nachricht zu erkennen. Siehe auch: Webhooks, Webhook-Einstellungen.