Webhooks

Webhooks laten u toestemmingsgebeurtenissen ontvangen als HTTP POST-verzoeken naar uw eigen eindpunt. Gebruik webhooks om de toestemmingsstatus te synchroniseren met uw backend, CRM of datawarehouse.

Een webhook instellen

1. Ga naar Dashboard → Eigenschap → Webhooks → Eindpunt toevoegen
2. Voer uw eindpunt-URL in (moet HTTPS zijn)
3. Selecteer welke gebeurtenissen u wilt versturen
4. Kopieer uw webhookgeheim (gebruikt voor handtekeningverificatie)
5. Sla op

Gebeurtenissen

Gebeurtenis	Trigger
consent.created	Gebruiker geeft voor het eerst toestemming
consent.updated	Gebruiker wijzigt toestemmingskeuzes
consent.expired	Opgeslagen toestemming bereikt vervaldatum
consent.reset	Eigenschap-niveau toestemmingsherstel toegepast

Payload-formaat

{
  "event": "consent.created",
  "delivery_id": "del_abc123",
  "timestamp": "2026-03-09T12:00:00Z",
  "property_id": "prop_xyz",
  "data": {
    "receipt_id": "rec_def456",
    "policy_id": "pol_ghi789",
    "policy_version": 3,
    "choices": {
      "necessary": true,
      "analytics": true,
      "marketing": false,
      "functional": true
    },
    "region": "DE",
    "user_agent_hash": "sha256:abc...",
    "ip_hash": "sha256:def..."
  }
}

Handtekeningen verifiëren

Verifieer altijd de X-ConsentForge-Signature-header voor verwerking. Zie Webhook-beveiliging voor codevoorbeelden.

Webhooks testen

Gebruik de knop Test in de Dashboard webhook-instellingen om een voorbeeldpayload naar uw eindpunt te sturen. U kunt ook webhook.site gebruiken voor lokaal testen.

Leveringsgeschiedenis bekijken

Dashboard → Eigenschap → Webhooks → Leveringslog toont alle leveringspogingen met statuscodes en responsinhoud.