Webhook Lead — invia ogni lead al tuo strumento
Configura un webhook del team per ricevere una copia di ogni lead in entrata sul tuo strumento (Google Sheet, CRM…), in parallelo all'inoltro ai network.
Aggiornata il 16 giugno 2026
Oltre a inoltrare le lead ai network, puoi farne arrivare una copia anche al tuo strumento — un Google Sheet, il tuo CRM, un'automazione. Imposti un solo URL e RoyLead, a ogni lead che entra, ci invia i dati. È in parallelo all'inoltro ai network: non lo rallenta e non lo sostituisce.
Apri il tuo team e vai nella scheda Inoltro Lead:
📌 La sezione compare solo per i team Media Buyer ed è modificabile solo da owner e admin. È un URL per team.
Prepara l'URL del tuo strumento
Il webhook invia una richiesta POST con dati JSON. Un Google Sheet non la riceve da solo: serve un ricevitore in mezzo che trasformi quei dati in righe del foglio. Le opzioni più comuni:
- Google Apps Script — pubblichi uno script come "Web app" e ottieni un URL
…/exec. Gratis. - Zapier / Make / n8n — crei un trigger "Webhook" e ottieni un URL da incollare.
Configura il ricevitore per scrivere i campi che ti servono (vedi sotto cosa inviamo), poi copia il suo URL.
⚠️ L'URL deve essere https. Un URL
httpo non valido viene rifiutato.
Incolla l'URL e fai il Test
Nella sezione Webhook Lead incolla l'URL nel campo, poi clicca Test.
RoyLead invia al tuo URL una lead di esempio. Se vedi Webhook raggiungibile, il ricevitore funziona: vai al Passo 3. Se vedi un errore, controlla che l'URL sia corretto e che il ricevitore sia pubblicato/attivo.
Salva
Clicca Salva. Da questo momento ogni lead che entra nel team viene inviata al tuo URL.
Per disattivare il webhook in qualsiasi momento, svuota il campo e salva.
Cosa viene inviato
A ogni lead RoyLead fa una POST con questo JSON:
{
"leadId": "lead_a1b2c3...",
"status": "pending",
"rejectionReason": null,
"campaignName": "Nome Campagna",
"landingPageName": "Nome Landing",
"country": "IT",
"createdAt": "2026-06-16T10:00:00.000Z",
"formData": { "nome": "Mario", "cognome": "Rossi", "telefono": "+393331234567", "email": "[email protected]" }
}
| Campo | Cosa contiene |
|---|---|
leadId | ID univoco della lead in RoyLead |
status | Stato: pending, rejected, duplicate, error… |
rejectionReason | Motivo dello scarto, se presente (altrimenti null) |
campaignName / landingPageName | Campagna e landing di provenienza |
country | Paese della lead |
createdAt | Data/ora di ingresso (formato ISO) |
formData | Tutti i campi compilati nel form |
Quali lead ricevi
Ricevi tutte le lead che entrano nel team: valide, scartate, doppioni ed errori di configurazione. Così vedi il tuo volume grezzo completo.
🔒 Le submission bot (riempiono la trappola anti-spam) non vengono inviate: è traffico automatico, non vere lead, e ti sporcherebbe il foglio.
Non confonderlo con il Webhook Token
Sono due cose diverse:
- Webhook Lead (questa guida): RoyLead invia i lead al tuo strumento.
- Webhook Token (in Impostazioni → Credenziali Network): il network invia a RoyLead gli aggiornamenti di stato (approvato/rifiutato).
Risoluzione problemi
| Cosa succede | Possibile causa | Soluzione |
|---|---|---|
| Il Test dà errore | URL sbagliato o ricevitore non pubblicato | Ricontrolla l'URL; pubblica/attiva il ricevitore |
| L'URL non viene accettato al salvataggio | Non è https o non è valido | Usa un URL https://… completo |
| Non vedo la sezione Webhook Lead | Permessi o tipo di team | Solo owner/admin di team Media Buyer la vedono |
| Arrivano i dati ma non finiscono nel foglio | Il ricevitore non mappa i campi | Sistema lo script/Zap che scrive le righe |
In sintesi
💡 Prepara un ricevitore (Apps Script/Zapier), incolla il suo URL https in Inoltro Lead → Webhook Lead, fai Test e Salva. Da lì ogni lead arriva anche da te, in tempo reale.
Pronto a metterlo in pratica?
Crea il tuo account RoyLead e parti in pochi minuti.