Skip to main content
Met Webhooks hoort je eigen systeem direct van zendingen, bestellingen en track & trace. Gebeurt er een gebeurtenis die je hebt gekozen, bijvoorbeeld een zending die is verzonden, dan stuurt Zippendo een bericht naar een adres (URL) op je server. Dit wordt meestal door een ontwikkelaar ingesteld. Webhooks zijn inbegrepen bij elk abonnement (Free tot 5, Standard tot 10, Growth tot 25, Pro tot 100, Enterprise onbeperkt).

​
Waar vind je het

Open het organisatiemenu onderaan de zijbalk, klik op Beheren en dan op het tabblad Webhooks. Je ziet je webhooks en een knop Webhook toevoegen.

​
Een webhook toevoegen

1

Het venster openen

Klik op Webhook toevoegen (of op Je eerste webhook aanmaken als de lijst leeg is).
2

Naam en adres

Vul een Naam * en de Endpoint-URL * in, bijvoorbeeld https://your-server.com/webhooks/zippendo. Gebruik een adres dat met https:// begint.
3

De gebeurtenissen kiezen

Vink de Gebeurtenissen * aan die je wilt, zoals Zending verzonden of Track & trace bijgewerkt, of klik op Alles selecteren.
4

Opslaan

Klik op Webhook aanmaken. Zippendo stuurt nu elke gekozen gebeurtenis naar je adres. Je server moet snel antwoorden met een 2xx-status, zodat Zippendo weet dat het bericht is aangekomen.
Elk bericht bevat de naam van de gebeurtenis, de tijd en de gegevens van de zending, bestelling of track & trace. De exacte inhoud en hoe je de handtekening controleert, staan in de Snelstart voor webhooks.

​
Webhooks beveiligen

  • Handtekening: Zippendo ondertekent elk bericht met een geheim dat bij de webhook hoort. Je ontwikkelaar gebruikt het om te controleren of een bericht echt van Zippendo komt. De app toont het geheim niet. Een ontwikkelaar leest het via de API (het verzoek Get webhook in de API-referentie).
  • HTTPS: gebruik alleen https://-adressen, zodat de berichten onderweg versleuteld zijn.

​
Merken

Gebruikt je organisatie merken, dan kun je een webhook een merk geven. Hij ontvangt dan alleen de gebeurtenissen van dat merk. Een webhook zonder merk ontvangt de gebeurtenissen van elk merk. Stel het Merk in wanneer je de webhook toevoegt of bewerkt.

​
Een webhook pauzeren of verwijderen

  • Pauzeren: klik bij de webhook op Bewerken, haal het vinkje bij Actief weg en klik op Wijzigingen opslaan. Zippendo stopt met sturen naar dat adres, maar bewaart de webhook en het bijbehorende Afleverlog.
  • Verwijderen: klik op Verwijderen, typ de naam van de webhook in hoofdletters en bevestig. Er worden geen berichten meer naar dat adres gestuurd en het bijbehorende Afleverlog wordt verwijderd.
Elk veld, het afleverlog en testberichten: Webhooks.