Webhooki

Webhooki 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 Pulpit → Właściwość → Webhooki → Dodaj endpoint
2. Wprowadź URL endpointu (musi używać HTTPS)
3. Wybierz zdarzenia do wysłania
4. Skopiuj swój sekret webhooka (używany do weryfikacji podpisu)
5. Zapisz

Zdarzenia

Zdarzenie	Wyzwalacz
consent.created	Użytkownik po raz pierwszy wyraża zgodę
consent.updated	Użytkownik zmienia wybory dotyczące zgody
consent.expired	Przechowywana 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 przetwarzaniem. Przykłady kodu znajdziesz w Bezpieczeństwo webhooków.

Testowanie webhooków

Użyj przycisku Test w ustawieniach webhooka w Pulpicie, aby wysłać przykładowy ładunek do Twojego endpointu. Do testowania lokalnego możesz również użyć webhook.site.

Przeglądanie historii dostarczeń

Pulpit → Właściwość → Webhooki → Dziennik dostarczeń wyświetla wszystkie próby dostarczenia ze kodami statusu i treściami odpowiedzi.