Overzicht
Nadat je een Webhook hebt aangemaakt, kun je een testgebeurtenis versturen om te controleren of het ontvangende systeem de gegevens van Appical goed ontvangt.
Daarnaast kun je via Delivery History bekijken welke gebeurtenissen Appical heeft geprobeerd te versturen en onderzoeken waarom een verzending eventueel is mislukt.
Voorbeeld
Je hebt een Webhook aangemaakt met de Trigger course.completed, maar de verwachte gegevens verschijnen niet in het ontvangende systeem.
Via Delivery History kun je controleren of Appical de gebeurtenis heeft verstuurd en welke reactie het ontvangende systeem heeft teruggestuurd.
Stappen om een Webhook te testen
→ Een testgebeurtenis versturen
Ga naar Instellingen > Webhooks en open de Webhook die je wilt testen.
Klik op Send test event (Testgebeurtenis versturen).
Appical verstuurt vervolgens voorbeeldgegevens van een fictieve gebruiker (Jane Doe). Hiervoor wordt de eerste Trigger gebruikt die voor de Webhook is ingesteld.
→ De verzendgeschiedenis bekijken
Open Delivery History van de Webhook.
Hier vind je een overzicht van alle verzendpogingen, inclusief:
Event: De gebeurtenis die de Webhook heeft geactiveerd.
Response code: De HTTP-statuscode die het ontvangende systeem heeft teruggestuurd.
Time: Het tijdstip van de verzending.
Status: Of de verzending is geslaagd of mislukt.
Je kunt de verzendgeschiedenis filteren op Status en Trigger.
Klik op een verzending om meer informatie te bekijken over het verzoek dat Appical heeft verstuurd en de reactie van het ontvangende systeem.
📌 Let op: Een verzending wordt als geslaagd beschouwd wanneer het ontvangende systeem binnen 30 seconden reageert met een HTTP-statuscode in de 2xx-reeks.
Verzendingen, opnieuw proberen en mislukte verzoeken
Appical probeert elke gebeurtenis één keer te versturen. Mislukte verzendingen worden niet automatisch opnieuw geprobeerd. Er zijn momenteel ook geen plannen om automatische nieuwe pogingen toe te voegen.
Wil je een mislukte verzending opnieuw versturen? Dan kan dit handmatig via Delivery History.
We raden aan om binnenkomende Webhook-verzoeken eerst in een wachtrij (queue) op te slaan. Het ontvangende systeem kan dan direct een 2xx-statuscode terugsturen en de gegevens daarna vanuit de wachtrij verwerken.
Zo blijft de reactietijd ruim binnen de limiet van 30 seconden en voorkom je dat een trage of mislukte verwerking aan de kant van het ontvangende systeem ervoor zorgt dat een gebeurtenis verloren gaat.
Waar moet je rekening mee houden?
Geslaagde verzending: Het ontvangende systeem reageert binnen 30 seconden met een 2xx-statuscode. Andere reacties, zoals 3xx, 4xx, 5xx, een time-out, een onbereikbare server of een SSL-fout, worden als mislukt geregistreerd.
Verwerkingstijd: Webhook-verzoeken worden op de achtergrond verstuurd, meestal binnen enkele seconden. Ze hebben echter de laagste prioriteit van de achtergrondtaken in Appical. Bij grotere processen, zoals het importeren van veel gebruikers, kan de verzending daardoor langer duren. Gebeurtenissen kunnen ook in een andere volgorde binnenkomen dan waarin ze hebben plaatsgevonden.
Delivery History: Hier vind je alle verzendpogingen, inclusief de gebeurtenis, responsecode, het tijdstip en de status. Je kunt filteren op status en Trigger.
Verzendgegevens: Klik op een verzending om de request headers, request body, response status, response headers en response body te bekijken. De response body wordt afgekapt na 64 KB. Gevoelige gegevens in headers, zoals Authorization, Cookie en API-sleutels, worden weergegeven als
[REDACTED].Opnieuw versturen (Replay): Met het replay-icoon kun je een gebeurtenis opnieuw versturen. Hierbij gebruikt Appical dezelfde inhoud en dezelfde
webhook-id, maar wordt er een nieuwe verzendpoging aangemaakt. Dit werkt alleen als de Webhook is ingeschakeld.Herhaalde fouten: Als een Webhook meerdere keren mislukt, wordt deze niet automatisch uitgeschakeld en ontvang je geen melding. Controleer daarom zelf regelmatig de verzendgeschiedenis.
Bewaartermijn: De verzendgeschiedenis blijft beschikbaar totdat de Webhook wordt verwijderd.
Stappen om problemen met een Webhook op te lossen
→ Controleer de verzendstatus
Open de mislukte verzending via Delivery History en bekijk de responsecode en eventuele foutmelding.
Een verzending kan mislukken wanneer:
Het ontvangende systeem een 3xx-, 4xx- of 5xx-statuscode terugstuurt.
Het ontvangende systeem niet binnen 30 seconden reageert.
De opgegeven URL niet bereikbaar is.
Er een SSL-fout optreedt.
Als er geen reactie is ontvangen, wordt bij de responsecode een '—' weergegeven.
Open de details van de verzending om de bijbehorende foutmelding te bekijken.
→ Controleer het ontvangende systeem
Heeft Appical het verzoek verstuurd, maar geeft het ontvangende systeem een foutmelding terug? Controleer dan de instellingen van het ontvangende systeem.
Let hierbij op het volgende:
URL: Controleer of het adres correct is en bereikbaar is via internet.
Methode (Method): Controleer of het ontvangende systeem de geselecteerde HTTP-methode ondersteunt.
Aangepaste headers (Custom headers): Controleer of eventuele verplichte headers, zoals authenticatiegegevens, correct zijn ingesteld.
Beschikbaarheid: Controleer of het ontvangende systeem actief is en binnen 30 seconden op het verzoek kan reageren.
→ Een mislukte gebeurtenis opnieuw versturen
Appical probeert mislukte Webhook-verzendingen niet automatisch opnieuw.
Wil je een gebeurtenis opnieuw versturen? Volg dan deze stappen:
Ga naar Instellingen > Webhooks.
Open de betreffende Webhook en ga naar Delivery History.
Zoek de mislukte verzending.
Klik op het replay-icoon om de gebeurtenis opnieuw te versturen.
Appical verstuurt dezelfde gebeurtenis opnieuw en registreert dit als een nieuwe verzendpoging.
Let op: De Webhook moet zijn ingeschakeld voordat je een gebeurtenis opnieuw kunt versturen.
📌 Belangrijk:
Als verzendingen meerdere keren mislukken, wordt de Webhook niet automatisch uitgeschakeld en ontvang je geen waarschuwing.
Vermoed je dat gebeurtenissen niet goed aankomen? Controleer dan de Delivery History.
Webhook-verzoeken worden meestal binnen enkele seconden verstuurd, maar bij grotere achtergrondprocessen kan dit langer duren. Ook kunnen gebeurtenissen in een andere volgorde aankomen dan waarin ze zijn aangemaakt.
👉 Heeft dit artikel je geholpen? Laat het ons weten via de knoppen hieronder. Kom je er nog niet uit? Neem dan gerust contact op met ons Supportteam. We helpen je graag verder!