Skip to main content
Un webhook è una notifica HTTP che Exoid invia al tuo sistema ogni volta che avviene un evento rilevante, ad esempio la ricezione di una nuova risposta. Ti serve quando vuoi che i dati arrivino nel tuo database, CRM o data warehouse nell’istante in cui vengono raccolti, senza export manuali.
Attivi i webhook da Impostazioni (toolbar laterale) → Webhook.

Il flusso di consegna

Quando un’intervista viene completata, Exoid esegue sei fasi in sequenza.
1

Validazione

Exoid verifica la correttezza e la struttura della risposta.
2

Formattazione

I dati vengono organizzati in un payload JSON pulito e coerente.
3

Firma digitale

Il payload viene firmato con HMAC-SHA256 usando il segreto della campagna.
4

Invio

I dati vengono inviati con una richiesta HTTPS POST al tuo endpoint.
5

Ritentativi automatici

In caso di errore temporaneo, Exoid ripete la richiesta fino a 7 volte in un’ora.
6

Logging

Ogni richiesta viene tracciata e resa disponibile nei log della dashboard.
Quello che succede dopo la partenza del POST dipende solo dalla risposta del tuo server: un successo chiude l’evento, un errore temporaneo rimette la stessa richiesta in coda, un errore permanente la ferma lì. Quando fallisce anche il settimo tentativo, l’evento viene abbandonato.

Logica dei ritentativi

Se l’endpoint non risponde o restituisce un codice temporaneo, Exoid effettua fino a 7 tentativi con ritardi progressivi.

Quando Exoid ritenta e quando no

La regola è una sola: 429, 5xx e gli errori di rete generano ritentativi. Gli errori 4xx di richiesta o autenticazione sono permanenti e l’evento va perso.
Un errore permanente (400, 401, 403, 404) non genera alcun ritentativo: l’evento viene perso. Se il tuo endpoint rifiuta una richiesta valida — per esempio perché la verifica della firma è implementata male — quella risposta non ti verrà mai riconsegnata.
Le richieste fallite restano consultabili nei log della dashboard con il relativo codice di stato.

Prossimi passi

Configurazione

Attiva il webhook, imposta URL e secret, verifica i log delle richieste.

Firma e sicurezza

Verifica la firma HMAC-SHA256 prima di accettare un payload.

Struttura del payload

Il modello dati completo, i tipi di risposta e un esempio integrale.