Webhookfouten
Symptoom A: Webhook-eindpunt retourneert 4xx/5xx
Hoe te controleren: Dashboard → Property → Webhooks → Afleveringslogboek — toont statuscodes en antwoordteksten.
Oorzaken en oplossingen:
| Statuscode | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
401 | Handtekeningverificatie mislukt | Controleer uw verificatiecode — zie Webhookbeveiliging |
400 | Uw eindpunt weigert het payload-formaat | Log de ruwe tekst en controleer deze aan de hand van het payload-schema |
404 | Eindpunt-URL is gewijzigd | Update de webhook-URL via Property → Webhooks → [Webhook] → Bewerken |
500 | Bug in uw webhookverwerker | Controleer uw serverlogboeken op de fout |
timeout | Uw eindpunt reageert te langzaam | Reageer direct met 200, verwerk asynchroon |
Symptoom B: Webhookhandtekeningverificatie mislukt
Oorzaak: Meest voorkomende redenen:
- Ondertekeningsstring onjuist opgebouwd — moet
{timestamp}.{ruwe_tekst}zijn (niet verwerkte JSON) - Een ander geheim gebruiken dan het geheim in het Dashboard
- Gebufferde/gewijzigde tekst lezen in plaats van de ruwe bytes
Oplossing: Zorg ervoor dat u de ruwe verzoektekst leest vóór JSON-parsing. In Express:
// MOET ruwe tekst-middleware gebruiken
app.use('/webhooks', express.raw({ type: '*/*' }));
Symptoom C: Webhookafleveringen zijn vertraagd
Oorzaak: ConsentForge probeert mislukte afleveringen opnieuw met exponentieel uitstel — vertragingen zijn normaal na initiële mislukkingen.
Oplossing: Los de onderliggende fout op (zie Symptoom A). Zodra uw eindpunt 2xx retourneert, zijn toekomstige afleveringen direct.
Symptoom D: Ontbrekende afleveringen — gebeurtenissen niet ontvangen
Hoe te controleren: Vergelijk het aantal afleveringen in het Dashboard-logboek met het ontvangen aantal op uw server.
Oorzaak: Sommige gebeurtenissen hebben alle herhalingspogingen uitgeput (5 pogingen over ~2 uur).
Oplossing: Property → Webhooks → Afleveringslogboek → Filter: Mislukt — gebruik de knop Opnieuw afspelen om mislukte afleveringen opnieuw te verzenden.