Naar de inhoud

Webhook: bezorging en nieuwe pogingen

Wanneer een webhookbericht als bezorgd telt en wanneer meetpiloot het opnieuw probeert. Vijf nieuwe pogingen, verspreid over ruim zeven uur.

PlusVoor ontwikkelaars2 min lezen
Op deze pagina3
  1. Nieuwe pogingen
  2. Wanneer meetpiloot het opnieuw probeert
  3. Dubbele berichten herkennen
Beschikbaar in Plus.

Een bericht telt als bezorgd zodra het ontvangende systeem binnen 5 seconden antwoordt met een 2xx-status. Antwoord dus snel en doe het zware werk pas na het antwoord. Een traag adres wordt na 5 seconden afgebroken.

Nieuwe pogingen

Lukt de eerste poging niet, dan probeert meetpiloot het automatisch opnieuw, met steeds meer tijd ertussen:

  1. Directpoging 1
  2. +1 minpoging 2
  3. +5 minpoging 3
  4. +15 minpoging 4
  5. +60 minpoging 5
  6. +360 minpoging 6

De eerste poging gaat direct. Daarna volgen vijf nieuwe pogingen, 1, 5, 15, 60 en 360 minuten na de vorige. De laatste poging valt zo ruim zeven uur na de eerste.

Wanneer meetpiloot het opnieuw probeert

Antwoord van je systeemWat er gebeurt
2xxBezorgd.
Geen antwoord binnen 5 seconden, of geen verbindingNieuwe poging volgens het schema.
408 of 429Nieuwe poging volgens het schema. Deze codes betekenen "probeer het later".
5xxNieuwe poging volgens het schema.
Andere 4xx, zoals 400, 401 of 404Geen nieuwe poging. Het systeem heeft het bericht bewust geweigerd, bijvoorbeeld door een verkeerd adres of een handtekening die niet klopt.

Lukt ook de laatste poging niet, dan staat de bezorging als Mislukt in het overzicht Laatste berichten in je dashboard, met de laatste foutmelding.

Dubbele berichten herkennen

meetpiloot bezorgt elk bericht minstens één keer. Valt een antwoord weg, bijvoorbeeld omdat je systeem het bericht wel verwerkte maar niet op tijd antwoordde, dan kan hetzelfde bericht nog een keer komen.

Elk bericht heeft daarom de header X-Meetpiloot-Delivery met een vaste ID. Die ID blijft bij elke nieuwe poging van dezelfde bezorging gelijk. Sla hem op en verwerk een bericht met een ID die je al kent niet opnieuw. Antwoord dan wel gewoon met een 2xx, zodat meetpiloot stopt met proberen.

Je raakt geen aanvraag kwijt

De lead blijft altijd in je dashboard staan, ook als de bezorging mislukt. Je kunt hem daar bekijken en zelf in je CRM zetten.

Kom je er niet uit?

Mail ons of open een ticket vanuit je dashboard. Antwoord binnen 1 tot 2 werkdagen.