Webhooks in het kort

Met een webhook laat PostBuddy je eigen systeem weten wat er met je post gebeurt, op het moment dat het gebeurt. Bijvoorbeeld: een kaart is gereed, een kaart heeft aandacht nodig of een kaart is onderweg. Je systeem ontvangt een kort bericht op een webadres dat je zelf kiest. Dat heet een endpoint.

#Heb je er een nodig?

#Een endpoint instellen

Owners, Admins en Developers kunnen webhooks beheren.

1. Open Developers en kies het tabblad Webhooks.
2. Kies Nieuw endpoint.
3. Vul de URL in die je ontwikkelaar je geeft. Die moet beginnen met https.
4. Voeg een Omschrijving toe, bijvoorbeeld "Statusupdates CRM".
5. Kies onder Abonnement welke berichten worden verstuurd: hele Eventfamilies, zoals alle events van poststukken, of Specifieke events, zoals item.completed.
6. Kies onder Poststukken voor Live en test, Alleen live of Alleen test.
7. Kies Endpoint aanmaken en geef de ondertekeningssleutel aan je ontwikkelaar. Die wordt maar één keer getoond.

Je abonnement kan het aantal endpoints beperken.

#Controleren of het werkt

Open het menu van een endpoint:

• Test versturen stuurt direct een testbericht.
• Afleveringen toont elk bericht met de pogingen, het antwoord van je systeem en de inhoud. Kies Opnieuw versturen om een bericht nog een keer te sturen.

Antwoordt je systeem niet, dan probeert PostBuddy het 24 uur lang opnieuw. Zijn tien berichten achter elkaar bij elke poging mislukt, dan wordt het endpoint uitgeschakeld en krijgen Owners, Admins en Developers een melding.

#Geen endpoint mogelijk?

Sommige systemen kunnen geen berichten ontvangen. Die kunnen dezelfde events in plaats daarvan zelf bij PostBuddy ophalen. Het tabblad Events toont deze events van de laatste 30 dagen.

Je ontwikkelaar vindt de technische details, zoals hoe je de handtekening controleert, in de handleiding over webhooks.