Webhooks

Webhooks pozwalają odbierać zdarzenia zgody jako żądania HTTP POST do własnego endpointu. Użyj webhooków do synchronizacji stanu zgody z backendem, CRM lub hurtownią danych.

Konfigurowanie webhooka

1. Przejdź do Panel → Właściwość → Webhooks → Dodaj endpoint
2. Wprowadź URL endpointu (musi być HTTPS)
3. Wybierz zdarzenia do wysyłania
4. Skopiuj swój sekret webhooka (używany do weryfikacji podpisu)
5. Zapisz

Zdarzenia

Zdarzenie	Wyzwalacz
consent.created	Użytkownik udziela zgody po raz pierwszy
consent.updated	Użytkownik zmienia swoje wybory zgody
consent.expired	Zapisana zgoda osiąga datę wygaśnięcia
consent.reset	Zastosowano reset zgody na poziomie właściwości

Format ładunku

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

Weryfikacja podpisów

Zawsze weryfikuj nagłówek X-ConsentForge-Signature przed przetworzeniem. Zobacz Bezpieczeństwo webhooków, aby uzyskać przykłady kodu.

Testowanie webhooków

Użyj przycisku Test w ustawieniach webhooków w panelu, aby wysłać przykładowy ładunek do swojego endpointu. Możesz również użyć webhook.site do testów lokalnych.

Przeglądanie historii dostarczeń

Panel → Właściwość → Webhooks → Dziennik dostarczeń pokazuje wszystkie próby dostarczenia z kodami statusu i treściami odpowiedzi.