Skip to main content
En webhook gör att Zippendo meddelar ett annat system om en händelse, till exempel Försändelse skickad eller Spårning uppdaterad. Du ställer in webhooks under Inställningar → Webhooks (öppna organisationsmenyn och klicka på Hantera). För varje händelse skickar Zippendo ett meddelande till den Endpoint-URL du angav. Det här är inte spårningswebhooks från transportörer. För dem, se Spårningswebhooks från transportörer.

​
Det här ser du

  • Ditt system tar aldrig emot något.
  • Leveransloggen för en webhook visar röda statuskoder eller text i kolumnen Fel.
  • Ditt system tar emot samma händelse mer än en gång.

​
Kontrollera först leveransloggen

Klicka på Leveranslogg på webhooken under Webhooks. Varje rad är ett försök, med Händelse, den Status som ditt system svarade med, Varaktighet och eventuellt Fel.
  • Inga leveranser än: Zippendo har inte försökt skicka något. Se ”Inget skickas” nedan.
  • En grön status: ditt system tog emot meddelandet. Leta efter problemet i ditt eget system.
  • En röd status eller Saknas med ett fel: ditt system godtog inte meddelandet. Se ”Leveranser misslyckas” nedan.

​
Inget skickas

​
Leveranser misslyckas

Zippendo räknar en leverans som lyckad bara när ditt system svarar med en lyckad status (200-299) inom 10 sekunder. Annars försöker Zippendo igen några gånger inom ungefär en minut, totalt 5 försök. Därefter skickas händelsen inte igen. När du har åtgärdat orsaken klickar du på Skicka test på webhooken. Du ser Testhändelsen har skickats och en ny rad visas i Leveransloggen.
Zippendo skickar inte misslyckade händelser på nytt senare. Om ditt system var nere en stund slår du upp de försändelser eller ordrar du missade i Zippendo-appen, eller hämtar dem via API:et.

​
Ditt system avvisar signaturen

Varje meddelande har en rubrik X-Webhook-Signature så att ditt system kan kontrollera att det verkligen kom från Zippendo. Det är en HMAC-SHA256 av meddelandets råa innehåll, skapad med webhookens hemlighet. Vanliga misstag:
  • Signaturen beräknas över meddelandet efter att det har tolkats och skrivits om, i stället för över det råa innehållet exakt som det togs emot.
  • Hemligheten från en annan webhook används. Varje webhook har sin egen hemlighet.
Detaljer och kodexempel: Snabbstart för webhooks.

​
Samma händelse kommer två gånger

Om ditt system svarade för långsamt eller med ett fel försöker Zippendo igen, även om ditt system hanterade det första försöket. Använd rubriken X-Webhook-Id för att känna igen ett meddelande som du redan har hanterat. Relaterat: Webhooks, Webhook-inställningar.