Creare un URL webhook in Xendy

  1. Accedi a Xendy e scegli Tutti i contatti nel menu a sinistra. Clicca su Nuovo segmento in alto a destra.
  2. Scegli Manuale e clicca su Avanti.
  3. Dai un titolo al segmento e clicca su Crea segmento. Verrai portato direttamente nel nuovo segmento.
  4. Clicca su Aggiungi contatti in alto a destra e scegli Tramite un webhook.
  5. Si apre un pop-up con codice di esempio contenente il webhook URL e il tuo token Authorization: Bearer. Conserva questi dati, ti serviranno in Zapier.

Attenzione: assicurati di copiare correttamente il webhook secret. Un secret non valido o vuoto viene immediatamente rifiutato con un messaggio di errore HTTP 401. Il secret non appare mai nei messaggi di errore o nei log, quindi verificalo con attenzione prima di configurare la connessione in Zapier.

Aggiungere contatti tramite un webhook è possibile solo con un abbonamento attivo o durante il periodo di prova. Senza abbonamento, Xendy mostra un messaggio per effettuare l'upgrade e il webhook rifiuta la richiesta con codice di errore 403.

Configurare Zapier

  1. Vai su zapier.com e crea un account.
  2. Scegli un piano a pagamento — i webhook sono disponibili solo sui piani a pagamento.
  3. Accedi e clicca su Create Zap.

Creare uno Zap

Configurare il trigger

  • Scegli l'app da cui provengono i dati (ad es. Google Forms o Shopify).
  • Seleziona l'evento che avvia lo Zap (ad es. nuovo invio o nuovo ordine).
  • Testa la connessione in modo che Zapier possa recuperare i dati di esempio.

Configurare l'azione

  • Scegli Webhooks by Zapier come app di azione.
  • Seleziona POST come metodo.
  • Incolla l'URL del webhook che hai creato in Xendy.
  • Imposta il tipo su JSON.
  • Aggiungi il token in Custom Request Headers: Authorization: Bearer abc123 (usa il tuo token completo). Il valore inizia sempre con Bearer seguito da uno spazio.

Mappare i campi

  • Collega i campi della tua app a Xendy.
  • email è obbligatorio.
  • Usa il nome come first_name e il cognome come last_name (entrambi facoltativi).

Testare

  • Invia i dati di test da Zapier.
  • Controlla in Xendy (Tutti i contatti → il tuo segmento) se i dati sono stati ricevuti correttamente.
  • Non arriva nulla? In Impostazioni → API → Attività (solo per il ruolo Proprietario) trovi sotto Webhook in entrata ogni chiamata con la risposta di Xendy.

Attivare lo Zap

  • Il test funziona correttamente? Clicca su Turn on Zap.
  • I nuovi invii arriveranno d'ora in poi automaticamente in Xendy.
  • Vuoi inviare subito un'email di benvenuto ai nuovi contatti? Collega un'automazione email con tipo di invio Immediato al segmento.

Aggiungere campi extra

CampoNome campoObbligatorio
Indirizzo e-mailemailSì
Nomefirst_nameNo
Cognomelast_nameNo
Altri campia tua sceltaNo

Gli altri campi puoi nominarli come preferisci. Vengono aggiunti automaticamente in Xendy e possono essere utilizzati in seguito nei segmenti o nella personalizzazione. Xendy converte i nomi dei campi in minuscolo, trasforma gli spazi in underscore e rimuove gli altri caratteri. I campi annidati (oggetti o liste) non vengono salvati da Xendy: invia ogni campo come valore separato.

Domande frequenti

Se il campo email è assente nel payload JSON o non contiene un indirizzo email valido, la richiesta webhook fallirà (Xendy risponderà con customer:invalid-email) e nessun contatto verrà aggiunto a Xendy. Assicurati sempre che il campo email sia incluso e mappato correttamente.

Se invii un indirizzo e-mail già presente in Xendy, Xendy aggiornerà i dati di quel contatto e lo aggiungerà al tuo segmento. Se il contatto si era precedentemente disiscritto, verrà nuovamente iscritto. Invia quindi solo i contatti che hanno dato il loro consenso.

Sì. Vai in Xendy su Contatti bloccati, clicca su Nuovo segmento e crea una lista di blocco con Blocco manuale. In quella lista clicca su Aggiungi contatti bloccati e scegli Tramite un webhook. Usa quell'URL webhook nel tuo Zap: ogni indirizzo e-mail che invii verrà disiscritto da tutte le tue e-mail.

Joeri Ras

Scritto da

Joeri Ras

Fondatore e comproprietario @ Xendy

Preferisci un contatto diretto?

Articoli correlati

Integrazioni

Collegare Gravity Forms a Xendy

Con Gravity Forms puoi creare facilmente moduli in WordPress. Grazie all'integrazione con Xendy, le risposte finiscono automaticamente in un segmento statico, così puoi usare i nuovi contatti subito per newsletter o automazioni e-mail.

Leggi di più
Integrazioni

Collegare il tuo negozio Lightspeed a Xendy

Collegando Lightspeed a Xendy, i dati di clienti, ordini e prodotti vengono sincronizzati automaticamente ogni notte. In questo modo puoi creare segmenti basati sul comportamento d'acquisto e mostrare i prodotti direttamente nelle tue e-mail. Con due script nel tuo webshop puoi anche fare il follow-up dei carrelli abbandonati.

Leggi di più
Integrazioni

Collegare il negozio Magento 2 a Xendy

Collegando Magento 2 a Xendy, i dati di clienti, ordini e prodotti vengono sincronizzati automaticamente ogni notte. In questo modo puoi creare segmenti basati sul comportamento d'acquisto, mostrare raccomandazioni di prodotti personalizzate e fare follow-up sui carrelli abbandonati. Attenzione: i carrelli abbandonati in Magento 2 funzionano solo per i clienti che hanno effettuato l'accesso al tuo negozio online. Xendy li recupera durante l'importazione notturna.

Leggi di più
Integrazioni

Collegare il negozio Shopify a Xendy

Collegando Shopify a Xendy, i tuoi clienti, ordini e prodotti vengono importati in Xendy. In questo modo puoi creare segmenti basati sul comportamento d'acquisto e inserire prodotti nelle tue e-mail. Puoi collegare tramite l'app Xendy in Shopify oppure con un'app personalizzata dal Shopify Dev Dashboard. Tramite l'app Xendy le modifiche arrivano immediatamente, i carrelli abbandonati funzionano e le disiscrizioni vengono sincronizzate in entrambe le direzioni. Con un'app personalizzata i tuoi dati vengono aggiornati ogni notte.

Leggi di più