WAButton

Webhook Pro

Webhook lead WhatsApp per n8n

Ogni nuovo lead invia JSON a n8n con un POST. Nessuna app extra da installare. Piano Pro.

Configurazione in 5 min Destinazione: Dashboard → Notifications → Webhook

Collega i lead WAButton a n8n

Crea un URL di cattura in n8n, incollalo in Notifiche, invia un test e aggiungi un'azione.

  1. 1

    Aggiungi un nodo Webhook in n8n

    Crea un workflow. Aggiungi il nodo core Webhook come trigger. Imposta HTTP Method su POST. Lascia l'autenticazione su None: WAButton invia JSON e due header, non un segreto condiviso.

    Consiglio: Usa Respond Immediately, così n8n restituisce 200 prima che i nodi successivi finiscano.

  2. 2

    Copia il Test URL e mettiti in ascolto

    In alto nel pannello del nodo, seleziona Test URL e copialo. Clicca su Listen for Test Event (oppure Execute workflow). Ora n8n è in attesa di un POST.

    Consiglio: Il Test URL funziona solo mentre l'editor è in ascolto. Per il traffico reale serve il Production URL, dopo aver pubblicato.

  3. 3

    Incolla l'URL in WAButton e invia un test

    Nell'editor del widget apri Notifications. Attiva Send leads to a webhook (Pro). Incolla il Test URL di n8n. Clicca sul pulsante di test. n8n dovrebbe mostrare il JSON nel nodo Webhook.

    Consiglio: Un invio di esempio include "test": true. Filtra su quel campo se non vuoi lead di test in Sheets.

    {
      "event": "lead.created",
      "version": 1,
      "deliveryId": "sample-delivery-id",
      "sentAt": "2026-09-10T12:00:00.000Z",
      "widget": { "id": "YOUR_WIDGET_UUID", "name": "Your widget" },
      "lead": {
        "id": "sample-lead-id",
        "submittedAt": "2026-09-10T12:00:00.000Z",
        "answers": {
          "name": "Jane Sample",
          "email": "jane@example.com",
          "message": "This is a sample lead from your WAButton test request."
        },
        "contact": {
          "email": "jane@example.com",
          "whatsappReplyUrl": "https://wa.me/15550192831"
        },
        "metadata": {
          "country": "ES",
          "deviceType": "desktop",
          "referrer": "https://example.com/pricing"
        }
      }
    }
  4. 4

    Mappa un'azione, poi vai live

    Aggiungi un nodo Google Sheets, Slack o email. Mappa {{ $json.body.lead.answers.email }}, {{ $json.body.lead.contact.whatsappReplyUrl }} e {{ $json.body.widget.name }}. Pubblica il workflow. Copia il Production URL dal nodo Webhook e sostituisci il Test URL in WAButton. Salva.

    Consiglio: Gli header X-WAButton-Event e X-WAButton-Delivery sono presenti in ogni POST, se in seguito aggiungi un'espressione Only Run If.

Perché inviare i lead WAButton tramite n8n

Il payload è già strutturato

event è sempre lead.created. answers, contact e metadata arrivano come JSON, non come un blocco di testo email.

Test URL, poi Production URL

n8n ti dà entrambi. Ascolta un evento di test, poi pubblica e passa WAButton all'URL di produzione.

Rispondi subito

n8n può confermare la ricezione del POST prima che venga eseguito il resto del workflow. WAButton riprova in caso di risposta non 2xx, quindi un passaggio lento del CRM non dovrebbe trattenere la risposta HTTP.

Pulsante di test identico alla produzione

Il pulsante Send test request della dashboard usa la stessa struttura JSON, con test: true, così puoi filtrare le esecuzioni di prova.

Domande frequenti

Quale piano WAButton include i webhook?

Dal piano Pro in su. La scheda Notifications mostra un badge Pro finché non passi a un piano superiore. Dopo il passaggio a un piano inferiore l'invio viene rifiutato, anche se un URL risulta ancora salvato.

Perché il mio lead reale non è mai arrivato a n8n?

Il Test URL smette di ricevere dati quando esci da Listen for Test Event. Pubblica il workflow e incolla il Production URL in WAButton.

WAButton firma il corpo della richiesta?

Per ora no. Considera l'URL come il segreto: non condividerlo pubblicamente. L'opzione Header auth di n8n non viene usata, a meno che in futuro non aggiungiamo un segreto condiviso.

I visitatori li hai già. Dai loro .

Portare più traffico sul sito costa tempo e denaro. Un pulsante WhatsApp ti aiuta a convincere più persone tra quelle che già lo visitano, finché sono ancora interessate.

Una riga di codice. Nessuna carta di credito. Nessuna attesa.