Webhook

I webhook vi consentono di ricevere eventi di consenso come richieste HTTP POST al vostro endpoint. Usate i webhook per sincronizzare lo stato del consenso con il vostro backend, CRM o data warehouse.

Configurare un webhook

1. Andate su Dashboard → Proprietà → Webhook → Aggiungi Endpoint
2. Inserite l'URL del vostro endpoint (deve essere HTTPS)
3. Selezionate quali eventi inviare
4. Copiate il vostro segreto webhook (usato per la verifica della firma)
5. Salvate

Eventi

Evento	Trigger
consent.created	L'utente dà il consenso per la prima volta
consent.updated	L'utente modifica le proprie scelte di consenso
consent.expired	Il consenso memorizzato raggiunge la data di scadenza
consent.reset	Reimposta 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

Verificate sempre l'intestazione X-ConsentForge-Signature prima di elaborare. Consultate Sicurezza Webhook per esempi di codice.

Testare i webhook

Usate il pulsante Test nelle impostazioni webhook del Dashboard per inviare un payload di esempio al vostro endpoint. Potete anche usare webhook.site per i test locali.

Visualizzare la cronologia delle consegne

Dashboard → Proprietà → Webhook → Log di Consegna mostra tutti i tentativi di consegna con codici di stato e corpi della risposta.