Webhooks & Events

Introductie

Webhooks stellen je in staat om real-time updates te ontvangen over gebeurtenissen in je AI-klantenservice systeem. Dit is ideaal voor het synchroniseren van data en het triggeren van acties in je eigen systemen.

Webhook Configuratie

Je kunt webhooks configureren in het dashboard onder Instellingen > Webhooks. Voor elke webhook moet je specificeren:

• Endpoint URL
• Event types om te ontvangen
• Secret key voor verificatie

Event Types

Payload Format

{
  "event_type": "string",
  "timestamp": "ISO8601 string",
  "data": {
    // Event-specifieke data
  }
}

Beveiliging

// Node.js voorbeeld
const crypto = require('crypto');

const isValidSignature = (payload, signature, secret) => {
  const hmac = crypto.createHmac('sha256', secret);
  const digest = hmac.update(payload).digest('hex');
  return signature === digest;
}

Retry Mechanisme

Bij een mislukte webhook delivery proberen we de volgende intervallen:

• Na 30 seconden
• Na 5 minuten
• Na 30 minuten
• Na 2 uur
• Na 6 uur

Best Practices

1. Snelle Response

   Reageer snel op webhook requests (binnen 5 seconden) om timeouts te voorkomen.

2. Idempotentie

   Verwerk events idempotent om dubbele verwerking te voorkomen.

3. Logging

   Log alle ontvangen webhooks voor debugging en monitoring.