Een webhook testen en storingen vinden

Webhooks falen stil. Waar je ziet wat er is verstuurd, wat er terugkwam, en de vier gebruikelijke oorzaken van een storing.

Webhooks falen stil. Waar je ziet wat er is verstuurd, wat er terugkwam, en de vier gebruikelijke oorzaken van een storing.

Waarom vuurt mijn webhook niet?

• Het andere systeem ontvangt niets.
• Het werkte in de test en niet in productie.
• Sommige tickets komen daar aan en andere niet.

Kijk eerst naar de activiteit

Zendesk legt aanroepen van webhooks vast, met wat er is verstuurd en wat er terugkwam. Dat beantwoordt de meeste vragen meteen: of hij überhaupt is aangeroepen, en zo ja wat de andere kant zei.

Geen vastgelegde aanroep betekent dat de trigger niet is afgegaan, en dat is een triggerprobleem en geen webhookprobleem.

Oplossingsstappen

1. De trigger paste niet

Kijk naar de gebeurtenissen op het ticket. Staat de trigger er niet bij, dan zijn de voorwaarden de oorzaak.

2. De authenticatie mislukte

Een 401 of 403 in het antwoord. De inloggegevens zijn verlopen, of het token is aan de andere kant vervangen zonder dat iemand Zendesk heeft bijgewerkt. Na een paar maanden zeer gebruikelijk.

3. De inhoud werd geweigerd

Een 400. Het andere systeem vond de vorm van wat er binnenkwam niet goed, vaak doordat een plaatsaanduiding naar niets is opgelost en ongeldige inhoud achterliet.

4. Het eindpunt is verhuisd of ligt plat

Een time-out of een 404. Iemand heeft het adres gewijzigd, of het ontvangende systeem is niet beschikbaar.

Wat er na een storing gebeurt

Een mislukte aanroep wordt tot vijf keer opnieuw geprobeerd, en een aanroep die binnen 12 seconden geen antwoord krijgt geldt als mislukt en gaat op dezelfde voet opnieuw.

Wat er níet gebeurt is uitzetten: opeenvolgende storingen schakelen de webhook niet uit. Wat ze wel kunnen doen is zijn circuit breaker laten tripten, en die kent twee drempels, allebei over vijf minuten gemeten: 70 procent van de aanroepen die een fout teruggeeft, of meer dan 1.000 foutantwoorden.

Hoe dan ook vertelt niets je dat, tenzij iemand meekijkt, en daar is het activiteitenlogboek voor. Dat toont ook hoeveel aanroepen de webhook de afgelopen zeven dagen deed, dus een lijn die stil is gevallen zie je daar voordat iemand het meldt.

Zie ook

• Een webhook maken en aan een trigger hangen
• Waarom mijn trigger niet afging
• Waarom staat er een lege regel waar mijn plaatsaanduiding hoort