Webhooks
Webhooks ermöglichen es Ihnen, Einwilligungsereignisse als HTTP-POST-Anfragen an Ihren eigenen Endpunkt zu empfangen. Verwenden Sie Webhooks, um den Einwilligungsstatus mit Ihrem Backend, CRM oder Data Warehouse zu synchronisieren.
Webhook einrichten
- Gehen Sie zu Dashboard → Property → Webhooks → Endpunkt hinzufügen
- Geben Sie Ihre Endpunkt-URL ein (muss HTTPS sein)
- Wählen Sie aus, welche Ereignisse gesendet werden sollen
- Kopieren Sie Ihr Webhook-Geheimnis (wird zur Signaturüberprüfung verwendet)
- Speichern
Ereignisse
| Ereignis | Auslöser |
|---|---|
consent.created | Nutzer gibt zum ersten Mal Einwilligung |
consent.updated | Nutzer ändert seine Einwilligungsentscheidungen |
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 überprüfen
Überprüfen Sie immer den Header X-ConsentForge-Signature, bevor Sie verarbeiten. Codebeispiele finden Sie unter Webhook-Sicherheit.
Webhooks testen
Verwenden Sie die Schaltfläche Test in den Dashboard-Webhook-Einstellungen, um einen Beispiel-Payload an Ihren Endpunkt zu senden. Sie können auch webhook.site für lokale Tests verwenden.
Zustellungshistorie anzeigen
Dashboard → Property → Webhooks → Zustellungsprotokoll zeigt alle Zustellungsversuche mit Statuscodes und Antworttexten.