Con i webhooks, Survio può inviare una Risposta al sondaggio a qualsiasi strumento che tu e il tuo team già usate – proprio nell’istante in cui qualcuno lo compila. Niente export, niente copia-incolla, nessuna attesa. Appena arriva una risposta, Survio la invia subito all’URL che hai scelto.
I webhooks sono una funzione Premium. Se non vedi l'opzione descritta qui sotto, potrebbe essere necessario fare l'Upgrade del piano prima.
Cosa puoi fare con un webhook?
Un webhook è solo un indirizzo di consegna. Una volta che ne connetti uno, ogni nuova Risposta al sondaggio viene inviata lì automaticamente, in tempo reale. Cosa succede dopo dipende dallo strumento che la riceve. Esempi comuni:
Retention: un punteggio basso crea un alert e una task nel tuo CRM, così puoi ricontattare la persona lo stesso giorno.
Crescita: un lead dal modulo “Richiedi una demo” compare all'istante su HubSpot, Salesforce o qualsiasi CRM.
Tutela del brand: una recensione da 1 stella fa scattare all’istante un alert su Slack, Teams o per email.
Supporto: feedback negativo diventa un ticket di supporto su Zendesk o una task in Jira automaticamente.
Analytics: ogni risposta confluisce su Google Sheets o Power BI, così il tuo Pannello principale è sempre aggiornato.
Non hai nessuno che possa configurare tutto questo lato tuo? Usa il pulsante "Ottieni configurazione esperta" nella pagina dei Webhooks: indica al team di Survio cosa vuoi attivare e loro configureranno, testeranno e ti passeranno un webhook già funzionante. Nessun codice necessario.
Come aggiungere un webhook
Step 1 — Apri la pagina Webhooks
Apri il tuo Sondaggio, vai su Raccogli risposte, poi seleziona Webhooks sotto "Automazioni e integrazioni" nella barra laterale sinistra.
Step 2 — Clicca su "Aggiungi un webhook"
Clicca sul pulsante + Aggiungi un webhook in alto a destra. Si aprirà una finestra che chiede l'endpoint URL, cioè l'indirizzo dello strumento o piattaforma di automazione (ad es. Zapier, Make, n8n o il tuo server) dove Survio deve mandare i Dati delle risposte.
Step 3 — Incolla il tuo URL webhook
Incolla l’URL fornito dallo strumento nel campo Webhook URL. Deve sempre cominciare con https:// – i link http:// non sono accettati e l'URL non può contenere username o password.
Step 4 — (Opzionale) Aggiungi intestazioni HTTP
Alcuni strumenti richiedono una chiave o token di autenticazione per ogni richiesta. Clicca su + Aggiungi intestazione, poi inserisci il nome della header (ad esempio X-Api-Key) e il suo valore. Puoi aggiungere fino a 20 intestazioni per webhook. Dopo il salvataggio, i valori delle header sono oscurati e non potranno più essere visualizzati – solo sostituiti se necessario.
Step 5 — Salva
Clicca su Salva webhook. Il nuovo webhook apparirà nella lista "I tuoi webhooks", attivo di default. Da questo momento, ogni nuova Risposta al sondaggio verrà mandata a quell'URL automaticamente.
Gestione dei tuoi webhooks
Attivare o disattivare un webhook
Usa l'interruttore accanto a un webhook per metterlo in pausa o riattivarlo quando vuoi. Non elimina nulla: si ferma (o riprende) solo la consegna. Nota che mettere in pausa/riattivare non reinvia quello che è arrivato quanto era off.
Modificare un webhook
Clicca su Modifica per cambiare l'URL o aggiornare le intestazioni. I valori delle intestazioni già salvate sono protetti – dovrai inserirne uno nuovo se vuoi modificarlo.
Eliminare un webhook
Clicca sull'icona del cestino accanto a un webhook per rimuoverlo. Survio ti chiederà conferma – eliminare un webhook è definitivo e interrompe subito qualsiasi cosa collegata, quindi controlla che non serva più realmente.
Quali dati invia un webhook?
Ogni volta che qualcuno invia il Sondaggio, Survio spedisce una richiesta HTTPS POST al tuo Webhook URL con un corpo JSON che contiene:
Il tipo di evento (al momento sempre una nuova Risposta al sondaggio)
L'ID del Sondaggio a cui appartiene la risposta
La risposta completa: un ID risposta univoco, il timestamp di invio, l’email del Rispondente (se raccolta), il canale da cui è arrivata la risposta (per es. link diretto, email, QR code, Popup), la lingua della risposta, eventuali Parametri URL personalizzati (come tag UTM), e la risposta a ogni Domanda
Questa è la stessa struttura dati usata anche nell’API di Survio, quindi se il tuo strumento già supporta le Risposte Survio, funzionerà anche coi payload dei webhooks.
Quanti webhooks puoi aggiungere?
Il numero di webhooks per Sondaggio dipende dal piano:
Piano | Webhooks per Sondaggio |
Free | Non disponibile |
Mini | 1 |
Standard | 3 |
Pro / Business / Enterprise / Custom | 10 |
Contano sia i webhooks attivi che quelli in pausa – disattivare non libera uno slot, solo eliminandolo lo liberi. Le consegne via webhook contano per la quota Risposte del piano: se esaurisci le risposte disponibili per il periodo, le consegne si mettono in pausa e riprendono al prossimo ciclo di fatturazione (le Risposte vengono comunque archiviate in Survio).