I webhook consentono a Smartsupp di inviare notifiche in tempo reale a qualsiasi URL scelto — nel momento in cui si apre una conversazione, viene creato un contatto o viene consegnato un messaggio, il sistema ne viene immediatamente informato. Questo articolo spiega cosa sono i webhook, come configurarli nel pannello di controllo 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 all’URL scelto ogni volta che si verifica un evento selezionato. Invece di eseguire il polling delle modifiche, i tuoi strumenti ricevono i dati nel momento stesso in cui accade qualcosa.
I casi d’uso tipici includono:
Piattaforme di automazione — attivare flussi di lavoro in Make, n8n o strumenti simili per aggiungere contatti a un CRM, inviare notifiche a Slack o registrare lead in un foglio di calcolo
Sistemi interni — inviare dati di conversazioni e contatti a dashboard, data warehouse o sistemi di ticketing in tempo reale
Notifiche — avvisare il team quando le conversazioni vengono valutate o quando la consegna dei messaggi non va a buon fine
Suggerimento: I webhook sono disponibili nel piano Plus e superiori — Plus include 1 webhook, Expert ne include 3 e Ultimate offre un limite personalizzato. Confronta i piani →
Creare un webhook
Configurare un webhook richiede solo pochi passaggi nel pannello di controllo di Smartsupp:
1. Apri Impostazioni e naviga alla sezione Webhook.
2. Fai clic 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 desideri ricevere (vedi l’elenco completo nella sezione successiva).
4. Salva il webhook. Da quel momento in poi, gli eventi selezionati vengono consegnati come richieste HTTP POST con payload JSON.
Nota: I webhook precedentemente configurati continuano a funzionare normalmente. Sono in corso lavori per rendere tutti i webhook esistenti visibili e gestibili dalla nuova sezione del pannello.
Eventi disponibili
Smartsupp può notificare il tuo endpoint su eventi in tre categorie. Seleziona solo gli eventi di cui il tuo flusso di lavoro ha effettivamente bisogno — questo mantiene snello l’endpoint ed evita traffico non necessario.
Contatti
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Conversazioni
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Visitatori
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Risorse correlate: Documentazione per sviluppatori Smartsupp — schemi completi del payload JSON per ogni tipo di evento.
Testare il webhook
Prima di andare in 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 webhook nel pannello, fai clic su Invia test. Smartsupp invierà un payload di esempio all’URL del tuo endpoint. Controlla il tuo servizio ricevente per confermare che i dati siano arrivati nel formato previsto.
Suggerimento: In Make, lo scenario deve essere attivo e in ascolto prima di inviare il test. In n8n, passa il nodo Webhook al suo URL di produzione e assicurati che il flusso di lavoro sia attivo.
Consegna, tentativi e sicurezza
Smartsupp è progettato per consegnare gli eventi webhook in modo affidabile, anche quando l’endpoint è temporaneamente non disponibile.
Formato — tutti gli eventi vengono inviati come richieste HTTP POST con un corpo JSON che descrive l’evento e i suoi dati
Risposta — l’endpoint deve rispondere con un codice di stato HTTP 2xx il più rapidamente possibile; risposte lente possono ritardare i tentativi
Tentativi — se la consegna non va a buon fine, Smartsupp riprova con ritardi crescenti per un massimo di 3 giorni
Disabilitazione automatica — gli endpoint che falliscono in modo persistente vengono disabilitati automaticamente; è possibile riabilitarli nel pannello in qualsiasi momento
Sicurezza — ogni richiesta webhook è firmata in modo da poter verificare che provenga effettivamente da Smartsupp; consulta docs.smartsupp.com per i dettagli sulla verifica della firma
Nota: Se il tuo endpoint è disabilitato a causa di errori ripetuti, riabilitalo in Impostazioni → Webhook dopo aver risolto il problema sottostante. Smartsupp riprenderà immediatamente l’invio degli eventi.
Collegare Smartsupp a Make o n8n
Collegare Smartsupp a una piattaforma di automazione richiede quattro passaggi. Il processo è lo stesso per Make e n8n — differisce solo il nodo trigger.
1. In Make, aggiungi un trigger Webhook → Webhook personalizzato e copia l’URL generato. In n8n, aggiungi un nodo trigger Webhook e copia il suo URL di produzione.
2. In Smartsupp, vai su Impostazioni → Webhook, crea un nuovo webhook e incolla l’URL copiato.
3. Seleziona gli eventi necessari e salva il webhook.
4. Fai clic su Invia test in modo che Make o n8n acquisiscano la struttura dei dati — poi costruisci il resto dello scenario o del flusso di lavoro su quella base.
Suggerimento: In Make, attiva lo 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.
Cosa fare dopo?
Smartsupp REST API — esplora l’API completa per leggere e scrivere dati Smartsupp in modo programmatico.
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 e-commerce e altro.
💡 Hai bisogno di ulteriore assistenza? Contatta il nostro team di supporto — siamo felici di aiutarti!