Webhook

I webhook ti permettono di ricevere eventi di consenso come richieste HTTP POST al tuo endpoint. Usa i webhook per sincronizzare lo stato del consenso con il tuo backend, CRM o data warehouse.

Configurare un webhook

1. Vai su Dashboard → Proprietà → Webhook → Aggiungi endpoint
2. Inserisci l'URL del tuo endpoint (deve essere HTTPS)
3. Seleziona gli eventi da inviare
4. Copia il tuo segreto webhook (usato per la verifica della firma)
5. Salva

Eventi

Evento	Trigger
consent.created	L'utente dà il consenso per la prima volta
consent.updated	L'utente cambia le sue scelte di consenso
consent.expired	Il consenso memorizzato raggiunge la data di scadenza
consent.reset	Reset del consenso a livello di proprietà applicato

Formato del payload

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

Verifica delle firme

Verifica sempre l'header X-ConsentForge-Signature prima di elaborare. Vedi Sicurezza webhook per esempi di codice.

Test dei webhook

Usa il pulsante Test nelle impostazioni webhook del Dashboard per inviare un payload di esempio al tuo endpoint. Puoi anche usare webhook.site per i test locali.

Visualizzare la cronologia delle consegne

Dashboard → Proprietà → Webhook → Log delle consegne mostra tutti i tentativi di consegna con codici di stato e corpi delle risposte.