Configurare i webhook
Inviate eventi come nuovi lead o appuntamenti in modo automatico e firmato ai vostri sistemi.
Ultimo controllo: 2026-10-20
Con i webhook in uscita, Zentor App informa immediatamente i vostri sistemi quando succede qualcosa – per esempio: con il modulo di automazione inviate i nuovi lead al vostro CRM tramite webhook. I webhook li create voi stessi nell'area «Automazione», scheda «Webhook». Ogni consegna viene firmata con HMAC-SHA256 tramite la vostra chiave segreta e le consegne non riuscite vengono ripetute automaticamente. I webhook fanno parte del modulo aggiuntivo «Automazioni/n8n».
Passo dopo passo
- Aprire la scheda «Webhook»Aprite «Automazione» nella barra laterale e selezionate la scheda «Webhook».
- Creare un webhookIn «I suoi webhook» inserite un nome e l'indirizzo HTTPS del vostro sistema e scegliete gli eventi, ad esempio «Lead creato», «Appuntamento creato», «Appuntamento annullato», «Modulo inviato», «Ticket creato», «Stato del ticket modificato» o «Messaggio ricevuto». Fate clic su «Crea webhook».
- Conservare la chiave di firmaDopo la creazione, la vostra chiave di firma viene mostrata una sola volta. Conservatela in modo sicuro: il vostro sistema la usa per verificare la firma HMAC di ogni consegna. Se necessario, ne generate una nuova con «Rinnova chiave».
- Eseguire un invio di provaCon «Invia test» inviate una consegna di prova al vostro indirizzo e verificate così che il vostro sistema la accetti.
- Controllare le consegneIn «Consegne» vedete ogni consegna con evento, stato, numero di tentativi e prossimo tentativo pianificato.
- Ripetere le esecuzioni di workflow non riusciteZentor App ripete automaticamente le consegne dei webhook. Se invece inviate dati tramite un workflow con l'azione «Invia richiesta HTTP», riavviate voi stessi le esecuzioni non riuscite nella scheda «Esecuzioni» con «Ripeti».
Risultato atteso
Il vostro sistema riceve automaticamente gli eventi scelti, ne verifica la provenienza tramite la firma e ogni consegna è tracciabile nel registro.
Casi di errore frequenti
La scheda «Webhook» non è presente.
Causa: Il modulo aggiuntivo «Automazioni/n8n» non è stato sottoscritto per il vostro account.
Soluzione: Contattate Zentor; riceverete un'offerta per il modulo.
La consegna di prova non riesce.
Causa: Il vostro indirizzo non è raggiungibile, non usa un HTTPS valido oppure il vostro sistema risponde con un errore.
Soluzione: Verificate indirizzo e certificato del vostro sistema e assicuratevi che accetti richieste dall'esterno. Poi inviate di nuovo il test.
Il mio sistema rifiuta le consegne per una firma non valida.
Causa: Il vostro sistema usa una chiave di firma errata o non aggiornata.
Soluzione: Generate una nuova chiave con «Rinnova chiave» e inseritela nel vostro sistema.