Webhooks

Webhooks en events bij KLICBOT — notificaties bij statuswijzigingen en exports.

Webhooks en Events

De KLICBOT API ondersteunt webhooks zodat externe systemen en AI-agenten automatisch op de hoogte worden gebracht van veranderingen (Pro/Enterprise, configuratie via dashboard of contract).

Typische events (integratie)

Event Wanneer
melding.created Aanvraag aangemaakt
melding.submitted Ingediend bij Kadaster
checklist.completed Checklist-moment afgerond
export.ready Export beschikbaar
logboek.entry.added Nieuwe logboekregel

Exacte eventnamen en payloads worden per tenant vastgelegd.

Voorbeeld payload

{
  "event": "melding.submitted",
  "timestamp": "2026-05-21T08:45:12Z",
  "data": {
    "melding_id": "mel_9f8k2p",
    "project_id": "proj_12345",
    "status": "submitted"
  }
}

Best practices

  • Gebruik unieke webhook-URL’s per integratie
  • Valideer signature of gedeeld secret
  • Implementeer idempotente verwerking (retries)
  • Antwoord met 2xx na persist

Zie ook API Overview en klic-api-koppeling.