Webhook
Un webhook è il modo più rapido per portare una risposta del modulo nel tuo sistema. Non devi mai chiedere «ci sono novità?»: Gatherino chiama il tuo endpoint non appena arriva una risposta.
Da sapere: l'editor e l'account di Gatherino sono disponibili in inglese o ceco. I moduli compilati dai tuoi rispondenti possono essere mostrati in 18 lingue, inclusa questa.
Usi tipici
Scrittura nel tuo sistema
Un ordine direttamente nel tuo shop, un contatto nel tuo CRM, una candidatura in un database interno.
Collegamento di strumenti di automazione
Indirizza il webhook verso qualsiasi servizio che accetta webhook in ingresso, tipicamente Zapier, Make o n8n.
Notifiche personalizzate
Un messaggio in una chat interna, un gateway SMS o la tua dashboard.
Come configurarlo
- 1
Prepara un endpoint
Un URL sul tuo server che accetta una richiesta HTTPS POST con un corpo JSON.
- 2
Aggiungi l'URL al modulo
Inserisci l'URL del webhook nelle impostazioni del modulo oppure usa uno step webhook all'interno di un'automazione.
- 3
Elabora i dati
Il corpo contiene la risposta, inclusi i valori dei campi. Le chiavi sono gli ID dei campi del modulo: recuperane le etichette dal dettaglio del modulo tramite l'API.
- 4
Testalo
Invia una risposta di prova e verifica che il tuo sistema abbia ricevuto ed elaborato la richiesta.
Esempio di ricezione (Node.js)
Un ricevitore minimo che salva l'invio dal tuo lato:
app.post('/gatherino-hook', express.json(), (req, res) => {
const submission = req.body;
// submission.data holds the form field values
saveToDatabase(submission);
res.sendStatus(200); // respond fast, do the work in the background
});Sicurezza: i webhook raggiungono solo indirizzi HTTPS pubblici. Le chiamate verso intervalli IP interni e privati sono bloccate, così un webhook non può essere usato per sondare la tua rete interna. Proteggi il tuo endpoint con un token segreto nell'URL e verifica che il payload abbia la struttura prevista.
FAQ
In che formato sono i dati?
JSON che descrive l'invio: identificatore, timestamp, stato e un oggetto con i valori dei campi.
Cosa succede se il mio server è temporaneamente non disponibile?
Accetta la richiesta rapidamente e rinvia l'elaborazione in background. Puoi sempre recuperare i dati mancanti tramite la REST API.
Posso avere più di un webhook?
Sì: oltre al webhook a livello di modulo, puoi aggiungere step webhook all'interno delle automazioni, anche con condizioni.
Funziona con Zapier o Make?
Sì, basta incollare nel modulo l'URL del webhook in ingresso generato da questi servizi.
Correlati
Prova Gatherino gratis
Piano gratuito: 3 moduli e 100 risposte al mese. Nessuna carta di credito, dati ospitati nell'UE.
Inizia gratis →