Vai al contenuto principale

Webhooks: invia risposte ai tuoi strumenti in tempo reale

Connetti Survio a Slack, al tuo CRM, helpdesk oppure ai fogli di lavoro: ogni risposta attiva subito un’azione automatica. Guida alla configurazione passo dopo passo.

I webhooks ti permettono di far arrivare ogni risposta del Sondaggio direttamente su qualsiasi strumento che il tuo team già usa – appena qualcuno invia una risposta. Dimentica le esportazioni, il copia e incolla e le perdite di tempo. Appena arriva una nuova risposta, Survio la invia subito all’indirizzo che decidi tu.

👋 Non serve essere esperti per usarlo. Se non sei sicuro da dove iniziare, vai sulla pagina Webhooks e clicca su Richiedi la configurazione Esperto — raccontaci cosa vuoi ottenere e il nostro team lo farà per te: lo configureremo, lo testeremo e ti consegneremo un webhook pronto all’uso. Non serve scrivere codice. Oppure connettiti con il nostro team tecnico via email: techsupport@survio.com

Ecco come funziona, in breve: arriva una risposta e Survio la invia all’istante a tutti gli strumenti che hai connesso — tutto in tempo reale e senza sforzo.

Una risposta viene consegnata a tutti gli strumenti collegati contemporaneamente — CRM, helpdesk, canale di team, pannello principale

Cosa puoi fare con un webhook?

Un webhook è semplicemente un indirizzo dove far arrivare i dati. Una volta che lo connetti, ogni nuova risposta del Sondaggio viene inviata lì automaticamente. Poi tutto dipende dallo strumento che riceve la risposta. Ecco alcune configurazioni tipiche:

  • Salva i clienti insoddisfatti: un punteggio basso avvisa subito il tuo team e segnala il contatto nel tuo CRM — così puoi intervenire prima che lasci una recensione pubblica negativa.

  • Non lasciarti scappare nessun lead: una risposta “Richiedi una demo” appare nel tuo CRM (HubSpot, Salesforce, Pipedrive...) appena viene inviata — nessun inserimento manuale.

  • Proteggi il tuo brand: una risposta da 1 stella avvisa subito il tuo team su Slack, Teams o via email in pochi secondi, così niente passa inosservato.

  • Gestisci automaticamente i reclami: i feedback negativi diventano un ticket di supporto nel tuo sistema di supporto clienti.

  • Tieni i report aggiornati in tempo reale: ogni risposta viene inserita direttamente in un foglio di lavoro, data warehouse o Pannello principale BI che hai configurato — così i tuoi report restano aggiornati senza nessuna esportazione manuale. Survio invia i Dati; il Pannello principale lo crei tu o lo connetti come preferisci.

Ecco alcuni di questi flussi completi — dalla risposta in arrivo, alle azioni dello strumento, fino all’attività del tuo team:

Soddisfazione del cliente

Salvataggio clienti detrattori: Net Promoter Score (NPS) 3/10 → webhook → ticket helpdesk → il tuo team → ti contatta entro 1 ora → cliente salvato

Flusso promoter: Net Promoter Score (NPS) 10/10 → webhook → tool recensioni → invito automatico email → nuova recensione pubblica

Flusso CRM: risposta → webhook → contatto CRM aggiornato → record segnalato → task follow-up al commerciale

Feedback dei dipendenti

Flusso HR: risposta eNPS → webhook → piattaforma HR aggiornata → manager avvisato → fissato incontro 1:1

Smistamento linguistico: il langCode della risposta la invia al team regionale corrispondente


Come aggiungere un webhook

I webhooks sono una funzione Premium. Se non trovi l’opzione descritta qui sotto, potresti dover fare l'upgrade del piano.

Per connettere un webhook ti serve solo una cosa: l’Endpoint URL. È semplicemente l’indirizzo web dove l’altro strumento riceve i Dati in arrivo. Non lo generi tu — lo strumento di destinazione (Slack, Zapier, Make, n8n, il tuo CRM o sistema) lo genera per te e tu lo incolli su Survio. Se non sai dove trovarlo, è proprio per questo che c’è l’opzione Richiedi la configurazione Esperto.

Passo 1 — Apri la pagina Webhooks

Apri il Sondaggio, vai su Raccogli risposte, quindi seleziona Webhooks sotto “Automazioni & integrazioni” nella barra laterale a sinistra.

Pagina Webhooks di Survio, stato vuoto, con il pulsante Aggiungi un webhook

Passo 2 — Clicca su “Aggiungi un webhook”

Clicca sul pulsante + Aggiungi un webhook in alto a destra. Si apre una finestra che chiede l’Endpoint URL — l’indirizzo dello strumento o piattaforma di automazione (ad es. Zapier, Make, n8n o il tuo server) dove Survio dovrebbe inviare i Dati delle risposte.

Finestra Aggiungi un webhook con il campo Webhook URL vuoto

Passo 3 — Incolla la tua URL webhook

Incolla l’URL che il tuo strumento ti ha dato nel campo Webhook URL.

L’URL deve iniziare con https:// — i link http:// non sono accettati e l’URL non può contenere username o password.

Campo Webhook URL compilato con un endpoint di esempio

Passo 4 — (Opzionale) Aggiungi header HTTP

Alcuni strumenti richiedono una chiave di autenticazione (API key) o un token da allegare a ogni richiesta. Clicca su + Aggiungi header, poi inserisci il nome dell’header (ad esempio X-Api-Key) e il valore. Puoi aggiungere fino a 20 header per ogni webhook. Una volta salvati, i valori saranno nascosti e non potrai più vederli — solo sostituirli.

Non sei sicuro se ti serve? Per la maggior parte degli utenti non serve. Aggiungi un header solo se il tuo strumento di destinazione ti chiede esplicitamente una chiave API o un token da autenticare — ad esempio un header X-Api-Key con un valore segreto ricevuto dallo strumento. Se non sai cosa inserire, lascia vuoto oppure chiedi a chi gestisce lo strumento.

Sezione HTTP headers compilata con nome e valore

Passo 5 — Salva

Clicca su Salva webhook. Il tuo nuovo webhook appare nell’elenco “I tuoi webhooks” attivo di default. Da questo momento, ogni nuova risposta a questo Sondaggio viene inviata a quell’URL in automatico.

Webhook salvato che appare nell’elenco, attivato

Gestione dei tuoi webhooks

Attivare o disattivare un webhook

Usa il toggle accanto a un webhook per metterlo in pausa o riattivarlo in qualsiasi momento. Questo non elimina nulla — sospende solo le consegne (o le riavvia). Nota che mettere in pausa e riattivare non invia quanto arrivato mentre era disattivato.

Webhook disattivato nell’elenco

Modifica di un webhook

Clicca su Modifica per cambiare l’URL o aggiornare gli header. I valori degli header vengono mostrati come puntini per sicurezza — per modificarli, dovrai reinserirli.

Finestra Modifica webhook con valore header mascherato

Eliminare un webhook

Clicca l’icona del cestino accanto a un webhook per rimuoverlo.

L’eliminazione di un webhook è definitiva. Non possiamo ripristinare un webhook eliminato, né inviare di nuovo le risposte arrivate mentre era eliminato o in pausa — quelle consegne sono irrecuperabili. Assicurati che non serva più prima di rimuoverlo.

Finestra di conferma dell’eliminazione webhook

Quali dati invia un webhook?

Ogni volta che qualcuno compila il Sondaggio, Survio invia una richiesta HTTPS POST all’URL del webhook con un body JSON che contiene:

  • Il tipo di evento (attualmente è sempre una nuova risposta del Sondaggio)

  • L’ID del Sondaggio cui appartiene la risposta

  • La risposta completa: ID risposta univoco, data e ora di invio, email del Rispondente (se raccolta), canale di provenienza (ad esempio link diretto, email, codice QR, popup), lingua, eventuali Parametri URL personalizzati (come tag UTM) e le risposte a ogni Domanda

Questa è la stessa struttura dati usata per le API di Survio, quindi se il tuo strumento già capisce le risposte di Survio, funzioneranno anche con i webhook. Ecco come appare una consegna, con dati di esempio:

Esempio di payload JSON webhook che mostra eventType, surveyId e la risposta completa nel campo data

Quanti webhook puoi aggiungere?

Il numero di webhook per ogni Sondaggio dipende dal tuo piano:

Piano

Webhook per sondaggio

Free

Non disponibile

Mini

1

Standard

3

Pro Business / Enterprise / Custom

10

Sia i webhook attivi che quelli messi in pausa contano per questo limite — solo eliminandoli liberi uno slot, non basta disattivarli.

Le consegne dei webhook contano anche sulla Quota risposte del tuo piano. Se finisci le risposte del periodo, le consegne si mettono in pausa automaticamente e riprendono al prossimo ciclo di abbonamento — le risposte sono comunque salvate su Survio.

Hai ricevuto la risposta alla tua domanda?