Webhooks en Events

Outbound webhooks zitten in KLICBOT PRO. Configureer de URL in het dashboard onder Instellingen → API & integraties. KLICBOT POSTt JSON naar die URL wanneer een event firet.

Huidige scope: twee eventtypen. Geen signing-secret, geen in-app testevent en geen delivery-log in het dashboard (nog niet). Test met bv. webhook.site of een Zapier Catch Hook, daarna een echte levering of checklist-afronding.

Live events

Event	Wanneer
`project.completed`	KLIC-aanvraag / project is gereed (levering beschikbaar)
`checklist.completed`	WIBON-checklist afgerond

Envelope

Elke POST heeft deze vorm:

{
  "event": "project.completed",
  "company_id": "cmp_…",
  "company_name": "Voorbeeld BV",
  "timestamp": "2026-05-21T08:45:12.123456+00:00",
  "data": { }
}

Voorbeeld: `project.completed`

{
  "event": "project.completed",
  "company_id": "cmp_…",
  "company_name": "Voorbeeld BV",
  "timestamp": "2026-05-21T08:45:12.123456+00:00",
  "data": {
    "order_id": "26O0123456",
    "project_name": "Sleuf Hoofdstraat",
    "address": "Hoofdstraat 1, Amsterdam",
    "status": "GEREED",
    "pdf_url": "https://klicbot.nl/…",
    "submitted_at": "2026-05-20T14:02:00+00:00"
  }
}

Velden als pdf_url / submitted_at kunnen null zijn als ze nog niet gezet zijn.

Voorbeeld: `checklist.completed`

{
  "event": "checklist.completed",
  "company_id": "cmp_…",
  "company_name": "Voorbeeld BV",
  "timestamp": "2026-05-21T09:10:00.000000+00:00",
  "data": {
    "order_id": "26O0123456",
    "checklist_responses": { },
    "compliance_pdf_url": "https://klicbot.nl/…"
  }
}

Best practices

Unieke webhook-URL per integratie
Idempotente verwerking (retries mogelijk)
Antwoord met 2xx na persist (timeout ~10s aan onze kant)
Verwacht (nog) geen HMAC-signature; beveilig je endpoint zelf (geheim pad, IP-allowlist, enz.)

Zie ook API Overview en klic-api-koppeling.