Webhook: gli eventi di Clara sui tuoi sistemi

Quando succede qualcosa in Clara — un messaggio, un caso, un appuntamento — lo comunico ai tuoi sistemi in tempo reale.

I webhook servono a far sapere ai tuoi sistemi cosa succede in Clara, nel momento in cui succede: un messaggio ricevuto, un caso che cambia stato, un appuntamento fissato.

È il complemento dell'API REST: con l'API sei tu a chiedere a Clara, col webhook è Clara ad avvisare te.

Si configurano in Admin → Impostazioni → Integrazioni, sezione Webhook.

Creare un webhook

Indichi l'URL del tuo sistema e scegli quali eventi ti interessano. Da quel momento, a ogni evento, invio una chiamata a quell'indirizzo con i dati.

Con Test verifichi subito che il tuo endpoint risponda, senza aspettare che l'evento capiti davvero.

Vedere cosa è stato consegnato

Ogni webhook ha la sua sezione Consegne: lo storico degli invii con l'esito. Se il tuo sistema non ha ricevuto qualcosa, è il primo posto dove guardare — spesso la risposta è lì (endpoint irraggiungibile, errore restituito, timeout).

Un webhook si può modificare, disattivare o eliminare in qualsiasi momento.

Quando usarli

• Aggiornare il gestionale quando in Clara si chiude una trattativa.
• Far partire un processo interno all'arrivo di una richiesta.
• Portare i dati in uno strumento di analisi senza interrogare l'API a intervalli.