Wesender
Webhooks

Realtime events in jouw systeem

Je applicatie heeft direct actie nodig bij een bounce, een geopende bevestiging of een mislukte bezorging. Webhooks sturen een HTTP-verzoek naar jouw endpoint op het moment dat het event plaatsvindt — geen polling, geen vertraging, geen gemiste updates.

Start gratis Bekijk webhook-functie →
Events

Welke events ontvangt jouw systeem?

Voor elk relevant e-mailgebeurtenis stuurt Wesender een POST-verzoek naar jouw webhook-endpoint. De payload is JSON en bevat het bericht-ID, het event-type, het tijdstempel en aanvullende gegevens afhankelijk van het type event.

Zo kun je bounces direct verwerken in je CRM, een klant automatisch e-mailen als er een bezorgprobleem is, of statistieken bijhouden in je eigen database.

Webhook events
email.delivered
E-mail geaccepteerd door ontvangende server
email.bounced
Hard bounce — adres bestaat niet
email.soft_bounce
Soft bounce — tijdelijk probleem
email.opened
Ontvanger heeft de e-mail geopend
email.clicked
Ontvanger heeft een link aangeklikt
email.complained
Ontvanger markeerde als spam
email.failed
Verzenden permanent mislukt
Webhook-documentatie →
Waarom het telt

Reageer direct, zonder te pollen

Polling — periodiek de API opvragen of er nieuwe events zijn — is traag, verspillt API-aanroepen en zorgt voor onnodige vertraging. Webhooks draaien dat om: Wesender roept jou aan zodra er iets is.

01

Automatische bounce-verwerking

Bij een hard bounce wil je het e-mailadres direct markeren als ongeldig in je systeem. Met een webhook doet je applicatie dat automatisch, zonder menselijk handelen of vertraagde rapportage.

02

Realtime klantcommunicatie

Stuur een follow-up als een onboarding-e-mail niet is bezorgd. Trigger een in-app notificatie als een factuur is geopend. Webhooks maken je e-mailstroom onderdeel van je productlogica.

03

Eigen logging en analyse

Sla alle e-mailgebeurtenissen op in je eigen database voor rapportages op maat. Analyseer welke e-mailtypes het vaakst bounced, welke het best worden geopend, en stuur je communicatiestrategie bij.

Beveiliging

Geverifieerd met HMAC-SHA256

Elk webhook-verzoek van Wesender bevat een cryptografische handtekening in de header. Je verifieert deze handtekening met je webhook-geheim, zodat je zeker weet dat het verzoek echt van Wesender afkomstig is.

  • HMAC-SHA256 handtekening op elk verzoek in X-Wesender-Signature.
  • Automatisch herprobeert bij mislukking met exponential backoff.
  • Meerdere endpoints per domein, filterbaar per event-type.
  • Gemiste events zijn altijd opvraagbaar via de logs-API.
Node.js Handtekening verifiëren 
import crypto from "crypto"

function verify(payload, signature, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(payload)
    .digest("hex")

  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature)
  )
}

// In je route handler:
const sig = req.headers["x-wesender-signature"]
const ok  = verify(req.rawBody, sig, WEBHOOK_SECRET)
if (!ok) return res.status(401).end()
Webhook-documentatie →
Veelgestelde vragen

Vragen over webhooks

Welke webhook-events stuurt Wesender?
Wesender stuurt events voor: bezorging (delivered), hard bounce, soft bounce, open (geopend), klik, spam-klacht en mislukt verzenden. Elk event bevat het bericht-ID, tijdstempel, ontvanger en aanvullende details zoals de bounce-reden.
Hoe beveilig ik mijn webhook-endpoint?
Wesender voegt aan elk verzoek een HMAC-SHA256-handtekening toe in de header X-Wesender-Signature. Je verifieert deze handtekening met je webhook-geheim. Zo weet je zeker dat het verzoek van Wesender afkomstig is en niet van een derde.
Wat gebeurt er als mijn endpoint niet bereikbaar is?
Wesender herprobeert mislukte webhook-aflevering automatisch met exponential backoff. Als je endpoint na meerdere pogingen onbereikbaar blijft, kun je de events alsnog opvragen via de logs-API of het dashboard.
Kan ik meerdere webhook-endpoints instellen?
Ja. Je kunt per domein meerdere webhook-endpoints configureren en per endpoint kiezen voor welke events je notificaties wilt ontvangen.

Meer lezen:

Webhook-functie Realtime logs Transactioneel vs. marketing

Stel je webhook in en ontvang je eerste event binnen minuten. Gratis account, geen creditcard.

Start gratis Bekijk alle plannen →