Webhooks

Mit Webhooks können Sie Einwilligungs-Events als HTTP POST-Anfragen an Ihren eigenen Endpunkt empfangen. Verwenden Sie Webhooks, um den Einwilligungsstatus mit Ihrem Backend, CRM oder Data Warehouse zu synchronisieren.

Webhook einrichten

1. Gehen Sie zu Dashboard → Property → Webhooks → Endpunkt hinzufügen
2. Geben Sie Ihre Endpunkt-URL ein (muss HTTPS sein)
3. Wählen Sie aus, welche Events gesendet werden sollen
4. Kopieren Sie Ihr Webhook-Secret (wird zur Signaturverifizierung verwendet)
5. Speichern

Events

Event	Auslöser
consent.created	Nutzer erteilt zum ersten Mal eine Einwilligung
consent.updated	Nutzer ändert seine Einwilligungsauswahl
consent.expired	Gespeicherte Einwilligung erreicht das Ablaufdatum
consent.reset	Property-weiter Einwilligungs-Reset angewendet

Payload-Format

{
  "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..."
  }
}

Signaturen verifizieren

Verifizieren Sie immer den X-ConsentForge-Signature-Header, bevor Sie die Anfrage verarbeiten. Code-Beispiele finden Sie unter Webhook-Sicherheit.

Webhooks testen

Verwenden Sie die Schaltfläche Testen in den Dashboard-Webhook-Einstellungen, um ein Beispiel-Payload an Ihren Endpunkt zu senden. Für lokale Tests können Sie auch webhook.site verwenden.

Zustellungsverlauf anzeigen

Dashboard → Property → Webhooks → Zustellungsprotokoll zeigt alle Zustellungsversuche mit Statuscodes und Antwort-Bodys.