Cos'è un webhook? Guida per chi non programma: collegare il chatbot ai tuoi strumenti
Un webhook è un messaggio automatico che un'app invia a un'altra nel momento in cui succede qualcosa. Ecco come funzionano i webhook del chatbot, in cosa differiscono da un'API e…

In questo articolo
Allora, cos'è un webhook? Un webhook è un messaggio automatico che un'app invia a un'altra nel momento in cui succede qualcosa, per esempio quando il tuo chatbot acquisisce un nuovo lead. Invece di avere gli altri strumenti che chiedono "c'è qualcosa di nuovo?" ogni pochi minuti, è il chatbot ad avvisarli subito.
Pensa alla differenza tra andare a controllare la cassetta della posta ogni ora e avere un campanello. Il campanello suona solo quando c'è davvero qualcuno alla porta.
Di seguito: come funzionano i webhook del chatbot, in cosa si differenziano da un'API, quali eventi conviene inviare e come renderli sicuri.
In sintesi
- Un webhook spinge i dati verso un altro sistema quando si verifica un evento; un'API di solito è qualcosa che interroghi tu per prelevare i dati.
- I webhook utili per un chatbot scattano su eventi di business, come un nuovo lead, un passaggio a un operatore o una conversazione chiusa.
- Le firme HMAC dimostrano che un messaggio è autentico, e i nuovi tentativi di invio fanno sì che una breve interruzione non faccia perdere dati.
Cos'è un webhook, in parole semplici?
Un webhook ha tre parti:
- Un evento: succede qualcosa nell'app di origine, per esempio un visitatore lascia la propria email in chat.
- Un URL: l'indirizzo del sistema che riceve, spesso chiamato endpoint. Lo incolli nelle impostazioni dell'app di origine.
- Un payload: un piccolo pacchetto di dati, di solito in JSON, che descrive cosa è successo.
Quando si verifica l'evento, l'app di origine invia il payload a quell'URL. Il sistema che lo riceve lo legge e fa qualcosa di utile: crea un contatto, pubblica un avviso, aggiunge una riga a un foglio di calcolo. Nessuno deve premere un pulsante o scrivere uno script che controlli le modifiche.
Non devi nemmeno costruire da solo la parte che riceve. Piattaforme di automazione come Zapier, Make e n8n possono generare un URL di webhook per te in pochi clic, ed è per questo che i webhook sono alla portata anche di chi non programma.
Webhook e API: qual è la differenza?
Spesso vengono trattati come rivali, ma lavorano in coppia. Un'API (application programming interface) è un insieme di porte di accesso a un'app a cui bussi per leggere o modificare dati. Un webhook è l'app che bussa alla tua porta quando succede qualcosa.
Senza webhook, l'unico modo per sapere dei nuovi eventi è il polling: chiedere all'API ancora e ancora se è cambiato qualcosa.
| Webhook (push) | Polling dell'API (pull) | |
|---|---|---|
| Chi avvia la comunicazione | L'app di origine, quando si verifica un evento | Il tuo sistema, a intervalli programmati |
| Velocità | Quasi in tempo reale | Veloce quanto il tuo intervallo di polling |
| Ideale per | Avvisi, sincronizzazione di nuovi record, avvio di flussi di lavoro | Esportazioni massive, report, ricerche su richiesta |
| Configurazione | Incolli un URL, scegli gli eventi | Scrivi uno script o un job programmato |
| Rischio principale | Messaggi persi se chi riceve non è raggiungibile (gestito con i nuovi tentativi) | Ritardi, richieste sprecate, limiti di frequenza |
Molte integrazioni usano entrambi. Un webhook dice "la conversazione 123 è appena passata a un operatore" e il sistema che lo riceve chiama poi l'API se gli servono più dettagli.
Webhook per chatbot: eventi di esempio che vale la pena inviare
I webhook per chatbot migliori corrispondono a momenti a cui il tuo team tiene già. Tre esempi comuni:
Nuovo lead acquisito
Un visitatore condivide i propri dati di contatto e risponde a una o due domande di qualificazione. Usi tipici: creare o aggiornare un contatto nel CRM, avvisare il canale del team commerciale o aggiungere il lead a una lista di nurturing (con il consenso). Visto che rispondere in fretta ai nuovi lead fa vincere più trattative, di solito è il primo webhook che i team configurano.
Conversazione passata a un operatore
L'assistente ha deciso che deve subentrare una persona, oppure è stato il cliente a chiederlo. Usi tipici: avvisare l'operatore di turno, aprire un ticket nell'help desk o segnalare un account prioritario. Il payload deve contenere il contesto su cui si basa il tuo processo di passaggio dal chatbot a un operatore, come intento, etichette e dati di contatto.
Conversazione chiusa
Una conversazione è terminata, risolta dall'IA o da un operatore. Usi tipici: registrarla per i report, aggiornare una dashboard o creare un'attività di follow-up.
Una regola semplice: iscriviti solo agli eventi su cui agirai davvero. Ogni webhook che attivi è una cosa in più da monitorare.
Sicurezza dei webhook: firme, nuovi tentativi e tracciamento delle consegne
Un URL di webhook è solo un indirizzo su internet. Cosa impedisce a qualcuno di inviargli falsi messaggi di "nuovo lead"? E cosa succede se il tuo server resta irraggiungibile per dieci minuti? Tre protezioni rispondono a queste domande.
Firme HMAC. Mittente e destinatario condividono una chiave segreta. Il mittente calcola una firma a partire dal payload e dalla chiave e la include in ogni richiesta. Il destinatario la ricalcola e rifiuta tutto ciò che non corrisponde, così i messaggi falsificati o manomessi non passano.
Nuovi tentativi. Se il destinatario non conferma la ricezione, il mittente riprova più tardi, di solito con intervalli sempre più lunghi tra un tentativo e l'altro. Una breve interruzione non significa perdere dati.
Circuit breaker e tracciamento delle consegne. Se un endpoint continua a fallire, un circuit breaker sospende le consegne per un po' invece di bombardare un server guasto. I log delle consegne mostrano cosa è stato inviato e se è andato a buon fine, così puoi fare debug senza tirare a indovinare.
Dal lato di chi riceve, alcune buone abitudini evitano la maggior parte dei problemi:
- Verifica la firma prima di usare i dati.
- Rispondi subito con un codice di successo, poi esegui le operazioni pesanti in background.
- Aspettati dei duplicati: un nuovo tentativo può consegnare lo stesso evento due volte, quindi usa l'ID dell'evento per saltare le ripetizioni.
- Usa solo endpoint HTTPS.
- Inoltra solo i dati personali di cui lo strumento che riceve ha bisogno; le regole del GDPR per i chatbot IA valgono anche quando i dati escono dalla chat.
Come Conviro gestisce i webhook in tempo reale
Conviro offre webhook in tempo reale. Gli eventi arrivano al tuo endpoint nel momento in cui si verificano, firmati con HMAC così puoi verificare ogni richiesta, inviati di nuovo in automatico se la consegna fallisce e protetti da un circuit breaker. Il tracciamento delle consegne mostra cosa è stato inviato e se è arrivato.
Puoi indirizzare questi webhook verso il tuo codice o verso uno strumento no-code: Conviro si collega anche a Zapier, Make e n8n e offre un'API REST con autenticazione tramite bearer token e chiavi con permessi limitati per prelevare i dati su richiesta. Tutto questo è disponibile dal piano Pro in su. La documentazione per sviluppatori spiega payload e verifica delle firme, e la pagina delle integrazioni di automazione mostra le strade no-code.
Domande frequenti
Cos'è un webhook in parole semplici?
Un webhook è una notifica automatica che un'app invia a un'altra quando si verifica un evento specifico. Dai all'app di origine un URL, scegli gli eventi e, ogni volta, l'app invia a quell'URL un piccolo pacchetto di dati. Funziona come un campanello per il software: il sistema che riceve viene a sapere subito dei cambiamenti invece di controllare di continuo.
Serve uno sviluppatore per usare i webhook?
Non sempre. Piattaforme di automazione come Zapier, Make e n8n generano un URL di webhook per te e ti permettono di collegare i dati in arrivo ad azioni in un editor visuale. Uno sviluppatore diventa utile quando costruisci un tuo endpoint, verifichi le firme nel codice o colleghi un sistema interno senza un connettore già pronto.
Un webhook è più veloce di un'API?
Per sapere dei nuovi eventi, sì. Un webhook arriva pochi istanti dopo l'evento, mentre il polling di un'API è veloce solo quanto la frequenza dei tuoi controlli. Per i dati storici o per dettagli aggiuntivi, l'API è lo strumento giusto. La maggior parte delle integrazioni ben fatte usa i webhook per notificare e l'API per cercare informazioni.
Cosa succede se il mio endpoint webhook non è raggiungibile?
Dipende dal mittente. I buoni sistemi di webhook ritentano le consegne fallite per un certo periodo, così le brevi interruzioni non fanno perdere dati, e alcuni sospendono le consegne verso un endpoint che continua a fallire. Verifica se il tuo fornitore ritenta l'invio e assicurati che il tuo endpoint possa gestire senza problemi lo stesso evento ricevuto due volte.
Prossimi passi
Scegli un evento su cui agiresti già oggi, di solito i nuovi lead, e collegalo allo strumento in cui il tuo team lavora già. Quando funziona in modo affidabile, aggiungi i passaggi a un operatore e le conversazioni chiuse. Inizia gratis con Conviro per configurare il tuo assistente, poi passa al piano Pro quando sei pronto a collegare i webhook.
Pubblicato da
Conviro
Condivide approfondimenti su supporto clienti basato su IA, automazione chatbot e strategie di crescita SaaS.
Sviluppa su Conviro
Collega i workflow conversazionali al tuo stack
Consulta le risorse per sviluppatori e i pattern di integrazione prima di progettare l’implementazione.
Articoli correlati
Altri post
Engineering
IMAP o POP3 (e SMTP)? Come collegare una casella di assistenza a un assistente IA
7 min di lettura
Leggi l'articolo

Engineering
7 modi di usare un'API per chatbot: costruire sulle conversazioni di assistenza
7 min di lettura
Leggi l'articolo