I webhook consentono a Smartsupp di inviare notifiche in tempo reale a qualsiasi URL tu scelga — non appena si apre una conversazione, viene creato un contatto o viene consegnato un messaggio, il tuo sistema ne viene informato. Questo articolo spiega cosa sono i webhook, come configurarli nella dashboard e come collegarli a piattaforme di automazione come Make e n8n.

Abbiamo suddiviso l'articolo in alcune sezioni:

A cosa servono i webhook?

Un webhook è un messaggio HTTP automatico che Smartsupp invia a un URL di tua scelta ogni volta che si verifica un evento selezionato. Anziché controllare periodicamente la presenza di modifiche, i tuoi strumenti ricevono i dati non appena accade qualcosa.

Tra i casi d'uso più comuni:

Piattaforme di automazione — attiva flussi di lavoro in Make, n8n o strumenti simili per aggiungere contatti a un CRM, pubblicare notifiche su Slack o registrare lead in un foglio di calcolo
Sistemi interni — invia dati su conversazioni e contatti a dashboard, data warehouse o sistemi di ticketing in tempo reale
Notifiche — avvisa la tua squadra quando vengono valutate le conversazioni o quando la consegna dei messaggi non riesce

Suggerimento: I webhook sono disponibili con il Piano Plus e quelli superiori — Plus include 1 webhook, Expert ne include 3 e Ultimate offre un limite personalizzato. Confronta i piani →

Crea un webhook

Per configurare un webhook bastano pochi passaggi nella tua dashboard Smartsupp:

1. Apri Impostazioni E vai alla sezione Webhook .
2. Clicca per aggiungere un nuovo webhook e inserisci il tuo URL dell'endpoint — l'indirizzo a cui Smartsupp invierà i dati degli eventi.
3. Seleziona gli Eventi Che vuoi ricevere (consulta l'elenco completo nella sezione successiva).
4. Salva il webhook. Da quel momento, gli eventi selezionati vengono consegnati tramite richieste HTTP POST con payload JSON.

Nota: I webhook configurati in precedenza continuano a funzionare normalmente. Stiamo lavorando per rendere tutti i webhook esistenti visibili e gestibili dalla nuova sezione della dashboard.

⚠️ Hai creato webhook in passato? I webhook meno recenti non sono ancora visibili in questa sezione — continuano a funzionare come prima. Stiamo unificando il vecchio e il nuovo sistema per rendere tutto gestibile da un unico posto.

Eventi disponibili

Smartsupp può notificare al tuo endpoint eventi di tre categorie. Seleziona solo gli eventi di cui il tuo flusso di lavoro ha effettivamente bisogno — in questo modo riduci il carico sul tuo endpoint ed eviti traffico superfluo.

Contatti

contact.created
contact.updated
contact.acquired
contact.banned
contact.unbanned

Conversazioni

conversation.opened
conversation.closed
conversation.closed_by_contact
conversation.rated
conversation.agent_assigned
conversation.agent_unassigned
conversation.agent_joined
conversation.agent_left
conversation.agent_replied
conversation.bot_replied
conversation.contact_replied
conversation.message_delivered
conversation.message_delivery_failed

Visitatori

visitor.connected
visitor.disconnected
visitor.updated
visitor.typing
visitor.triggered
visitor.replied

Risorse correlate: Documenti per sviluppatori Smartsupp — schemi completi dei payload JSON per ogni tipo di evento.

Testa il tuo webhook

Prima di passare alla produzione, usa la funzione di test integrata per verificare che il tuo endpoint sia raggiungibile e che il tuo scenario Make o n8n sia configurato correttamente.

Dalle impostazioni del webhook nella dashboard, clicca su Invia test. Smartsupp invierà un payload di esempio all'URL del tuo endpoint. Controlla il servizio che riceve i dati per confermare che siano arrivati nel formato previsto.

Suggerimento: In Make, il tuo scenario deve essere attivo e in ascolto prima di inviare il test. In n8n, imposta il nodo Webhook sul suo URL di produzione e assicurati che il flusso di lavoro sia attivo.

Consegna, nuovi tentativi e sicurezza

Smartsupp è progettato per consegnare gli eventi webhook in modo affidabile, anche quando il tuo endpoint è temporaneamente non disponibile.

Formato — tutti gli eventi vengono inviati tramite richieste HTTP POST con un corpo JSON che descrive l'evento e i relativi dati
Risposta — il tuo endpoint dovrebbe rispondere con un codice di stato HTTP 2xx il più rapidamente possibile; risposte lente possono ritardare i nuovi tentativi
Nuovi tentativi — se la consegna non riesce, Smartsupp riprova a intervalli crescenti per un massimo di 3 giorni
Disattivazione automatica — gli endpoint che continuano a non rispondere correttamente vengono disattivati automaticamente; puoi riattivarli nella dashboard in qualsiasi momento
Sicurezza — ogni richiesta webhook è firmata, così puoi verificare che provenga effettivamente da Smartsupp; consulta docs.smartsupp.com Per i dettagli sulla verifica della firma

Nota: Se il tuo endpoint viene disattivato a causa di errori ripetuti, riattivalo in Impostazioni → Webhook Dopo aver risolto il problema alla base degli errori. Smartsupp riprenderà immediatamente a inviare gli eventi.

Collega Smartsupp a Make o n8n

Per collegare Smartsupp a una piattaforma di automazione bastano quattro passaggi. Il procedimento è lo stesso per Make e n8n — cambia solo il nodo di attivazione.

1. In Make, aggiungi un trigger Webhook → Webhook personalizzato E copia l'URL generato. In n8n, aggiungi un nodo di attivazione Webhook E copia il suo URL di produzione.
2. In Smartsupp, vai a Impostazioni → Webhook, crea un nuovo webhook e incolla l'URL copiato.
3. Seleziona gli eventi che ti servono e salva il webhook.
4. Clicca su Invia test Affinché Make o n8n acquisisca la struttura dei dati — poi usala come base per creare il resto del tuo scenario o flusso di lavoro.

Suggerimento: In Make, attiva il tuo scenario prima di inviare il test — altrimenti i dati del webhook non verranno acquisiti. In n8n, usa l'URL di Produzione (non l'URL di test) quando configuri il webhook Smartsupp.

E adesso?

API REST di Smartsupp — esplora l'API completa per leggere e scrivere i dati di Smartsupp tramite codice.
Automazioni — configura automazioni basate su regole che si attivano direttamente all'interno di Smartsupp senza uno strumento esterno.
Panoramica delle integrazioni — scopri tutte le integrazioni native disponibili con CRM, piattaforme di e-commerce e altro ancora.

💡 Hai bisogno di altro aiuto? Contatta il nostro Team di assistenza — saremo felici di aiutarti!

Webhook: collega Smartsupp a Make, n8n e ai tuoi strumenti