Webhooks & API: e-mail integreren in je eigen systeem

Waarom integreren?

E-mail staat niet op zichzelf. Het is verbonden met je CRM, je helpdesk, je boekhoudsoftware, je projectmanagement. Door e-mail te integreren via webhooks of API, creëer je automatische workflows.

Voorbeelden

• Nieuwe klant mailt → Automatisch contactpersoon aanmaken in CRM
• Factuurvraag → Ticket aanmaken in helpdesk
• Bestelling geannuleerd → Notificatie naar Slack
• Support verzoek → Prioriteit bepalen en toewijzen

Webhooks: push-notificaties

Een webhook stuurt automatisch een HTTP POST naar jouw URL wanneer er iets gebeurt.

Beschikbare events

Webhook payload voorbeeld

json
{
  "event": "message.received",
  "thread_id": "clx123...",
  "from": "klant@bedrijf.nl",
  "to": "support@jouwdomein.nl",
  "subject": "Vraag over factuur",
  "body_text": "Hallo, ik heb een vraag...",
  "timestamp": "2026-02-25T10:30:00Z"
}

Webhook instellen

1. Ga naar Instellingen → Webhooks
2. Klik Nieuwe webhook
3. Vul je URL in (bijv. https://jouwapp.nl/api/webhook)
4. Selecteer de events
5. Kopieer het webhook secret voor verificatie

REST API: pull data

De REST API laat je data ophalen en acties uitvoeren.

Authenticatie

Authorization: Bearer jouw-api-key

Endpoints

Threads ophalen:

GET /api/v1/threads?status=open&domain=jouwdomein.nl

Thread details:

GET /api/v1/threads/:id

Antwoord versturen:

POST /api/v1/threads/:id/reply
{
  "body": "Bedankt voor je bericht..."
}

Best practices

1. Verifieer webhook signatures — Controleer het secret om spoofing te voorkomen
2. Retry logica — Webhooks falen soms, bouw retry-logica in
3. Rate limiting — Respecteer API-limieten
4. Idempotency — Verwerk dezelfde webhook niet twee keer

Conclusie

Webhooks en API's maken e-mail een bouwsteen in je tech-stack. Begin met één integratie, test grondig, en breid uit naarmate je behoeften groeien.