I webhooks consentono a Survio di inviare una risposta al sondaggio a qualsiasi strumento usato già dal tuo team — nell’esatto momento in cui qualcuno la invia. Niente esportazioni, niente copia-incolla, nessuna attesa. Appena arriva una risposta, Survio la inoltra subito all’indirizzo che scegli tu.
👋 Non serve essere dei tecnici per usarli. Se non sai da dove iniziare, apri la pagina dei Webhooks e clicca su Impostazione esperto — dicci cosa vuoi ottenere, e il nostro team lo configurerà, lo testerà e ti consegnerà un webhook già funzionante. Non serve codice. Oppure mettiti in contatto con il nostro team tecnico via email: techsupport@survio.com
Ecco l’idea intera in una sola immagine: appena arriva una risposta, Survio la consegna a tutti gli strumenti che hai connesso — tutto in una volta, in tempo reale.
Cosa puoi fare con un webhook?
Un webhook è solo un indirizzo di consegna. Una volta che ne colleghi uno, ogni nuova risposta al sondaggio viene inviata lì in automatico. Cosa succede dopo dipende dallo strumento ricevente. Alcuni degli scenari più comuni:
Salva i clienti insoddisfatti: un punteggio basso avvisa subito il tuo team e segnala il contatto nel CRM — così puoi intervenire prima che quella persona lasci una recensione pubblica negativa.
Non perdere mai un lead: una risposta “Richiedi una demo” appare nel tuo CRM (HubSpot, Salesforce, Pipedrive…) nel momento in cui viene inviata — senza inserimento manuale.
Proteggi il tuo brand: una risposta da 1 stella invia una notifica al team su Slack, Teams o via email in pochi secondi, così niente sfugge.
Gestisci i reclami in automatico: un feedback negativo diventa subito un ticket nel sistema di assistenza clienti.
Tieni i report sempre aggiornati: ogni risposta viene inviata direttamente a un foglio di calcolo, data warehouse o dashboard BI che hai configurato tu — così i tuoi report restano sempre aggiornati senza esportazioni manuali. Survio invia i dati; la dashboard la crei o colleghi tu.
Ecco alcuni di questi scenari dall’inizio alla fine — dall’arrivo della risposta, a cosa fa lo strumento con i dati, fino all’azione del tuo team:
Soddisfazione del cliente
Feedback dei dipendenti
Come aggiungere un webhook
I webhooks sono una funzionalità Premium. Se non vedi l’opzione descritta sotto, potrebbe essere necessario fare l’upgrade prima.
Per connettere un webhook ti serve una cosa sola: una URL endpoint. È semplicemente l’indirizzo web su cui l’altro strumento riceve i dati in arrivo. Non devi crearla tu — lo genera lo strumento ricevente (Slack, Zapier, Make, n8n, il tuo CRM o il tuo sistema), e va incollata su Survio. Se non sai dove trovarla, è esattamente ciò per cui serve Impostazione esperto.
Passaggio 1 — Apri la pagina dei Webhooks
Apri il tuo sondaggio, vai su Raccogli risposte, poi seleziona Webhooks sotto “Automazioni & integrazioni” nella barra laterale sinistra.
Passaggio 2 — Clicca su “Aggiungi un webhook”
Clicca sul pulsante + Aggiungi un webhook in alto a destra. Si aprirà una finestra che ti chiede la URL endpoint — l’indirizzo dello strumento o piattaforma di automazione (ad esempio Zapier, Make, n8n, o il tuo server) dove Survio dovrà inviare i dati di risposta.
Passaggio 3 — Incolla la tua URL webhook
Incolla la URL che il tuo strumento ti ha fornito nel campo Webhook URL.
La URL deve iniziare con https:// — link http:// semplici non sono accettati, e la URL non può contenere username o password.
Passaggio 4 — (Opzionale) Aggiungi intestazioni HTTP
Alcuni strumenti richiedono una chiave di autenticazione o un token in ogni richiesta. Clicca su + Aggiungi intestazione, poi inserisci il nome dell’intestazione (ad esempio X-Api-Key) e il suo valore. Puoi aggiungere fino a 20 intestazioni per ogni webhook. Dopo il salvataggio, i valori delle intestazioni sono nascosti per sicurezza — puoi solo sostituirli, non vederli.
Non sai se ti serve? Di solito non serve. Aggiungi un’intestazione solo se il tuo strumento la richiede (per esempio una chiave API o un token per autenticare). Se hai dubbi, lascia il campo vuoto, oppure chiedi a chi gestisce quello strumento.
Passaggio 5 — Salva
Clicca su Salva webhook. Il nuovo webhook apparirà nell’elenco “I tuoi webhooks”, già attivo per impostazione predefinita. Da questo momento, ogni nuova risposta a questo sondaggio verrà inviata automaticamente a quella URL.
Gestire i tuoi webhooks
Attivare o disattivare un webhook
Usa l’interruttore vicino a ciascun webhook per metterlo in pausa o riattivarlo quando vuoi. Non elimina nulla — semplicemente interrompe (o riprende) le consegne. Nota che la sospensione e la riattivazione non rimanderanno le risposte arrivate mentre era disattivato.
Modificare un webhook
Clicca su Modifica per aggiornare la URL o modificare le intestazioni. I valori delle intestazioni appaiono oscurati per sicurezza — dovrai inserirne uno nuovo se vuoi cambiarlo.
Eliminare un webhook
Clicca sull’icona del cestino accanto al webhook per rimuoverlo.
Eliminare un webhook è permanente. Non possiamo recuperare webhook eliminati, e nemmeno reinviare le risposte che sono arrivate mentre era eliminato o sospeso — quelle consegne sono perse. Assicurati che niente di importante dipenda più da quella connessione prima di rimuoverla.
Quali dati invia un webhook?
Ogni volta che qualcuno invia il tuo sondaggio, Survio manda una richiesta POST HTTPS alla URL del webhook con un corpo JSON che contiene:
Il tipo di evento (attualmente, sempre una nuova risposta al sondaggio)
L’ID del sondaggio a cui appartiene la risposta
La risposta completa: un ID univoco di risposta, data e ora dell’invio, canale da cui è arrivata (ad esempio link diretto, email, QR code, pop-up), lingua della risposta, eventuali parametri URL personalizzati (come i tag UTM), e la risposta a ogni domanda
Vuoi l’email del rispondente? Leggila dalla risposta alla domanda email, oppure dai parametri URL personalizzati. Il campo email separato nei dati resta vuoto quando l’email è data tramite una domanda o un parametro URL.
È la stessa struttura dati usata in tutta l’API di Survio, quindi se il tuo strumento già capisce le risposte Survio, capirà anche i payload dei webhook. Ecco un esempio di dati inviati:
Quanti webhook puoi aggiungere?
Il numero di webhook per sondaggio dipende dal piano scelto:
Piano | Webhooks per sondaggio |
Free | Non disponibile |
Mini | 1 |
Standard | 3 |
Pro Business / Enterprise / Custom | 10 |
Sia i webhook attivi sia quelli in pausa contano per questo limite — solo eliminandone uno liberi lo slot, non mettendolo in pausa.
I webhooks non consumano le tue risposte. Il limite risposte del piano si applica solo alla raccolta delle risposte. Quanti webhook aggiungi, e dove vanno i dati, non cambia nulla.