Developers & API

Bouw Vrijwilligersassistent.nl in in uw eigen platform. Er zijn drie integratiepaden: de REST API, uitgaande webhooks en de embeddable chat-widget.

1. REST API v1

Authenticeer met een API-sleutel (Dashboard → Instellingen → API-sleutels). Volledige specificatie: openapi.json.

curl https://vrijwilligersassistent.nl/api/v1/volunteers \
  -H "Authorization: Bearer va_uw_sleutel"

GET/POST /api/v1/volunteers — vrijwilligers beheren
GET/PATCH/DELETE /api/v1/volunteers/:id
GET /api/v1/conversations — gesprekken lezen
GET/POST /api/v1/leads — leads en intakes

2. Webhooks

Ontvang realtime events zodra er iets verandert — de bidirectionele koppeling. Elke payload is ondertekend met HMAC-SHA256 in de X-VA-Signature-header.

volunteer.updated
hours.logged
lead.created
conversation.escalated

3. Chat-widget

Plaats de assistent op elke website met één regel. Vervang ORG_ID door uw organisatie-id (zichtbaar bij Dashboard → Kanalen).

<script src="https://vrijwilligersassistent.nl/widget.js" data-org="ORG_ID" defer></script>