Dove trovi l'API?

Vai su Impostazioni → API. La pagina ha tre schede: Chiavi, Webhook e Attività. Solo gli utenti con il ruolo Proprietario vedono questa pagina.

  • URL base: https://api.v2.xendy.me/v1
  • Documentazione (OpenAPI): https://api.v2.xendy.me/v1/openapi.json. Puoi aprirla senza chiave API e importarla in strumenti come Postman.

Creare una chiave API

  1. Nella scheda Chiavi clicca su Crea chiave API.
  2. Assegna alla chiave un Nome riconoscibile, ad esempio Collegamento negozio online.
  3. Scegli per ogni tipo di dato cosa può fare la chiave: Lettura e/o Scrittura. Non concedere più permessi di quanti ne abbia bisogno il tuo collegamento.
  4. Clicca su Crea. Copia la chiave e clicca su Ho salvato il valore. La chiave viene mostrata una sola volta.

Includi la chiave in ogni richiesta come header: Authorization: Bearer xnd_live_.... La chiave determina automaticamente a quale account si riferisce.

Tipo di datoLetturaScrittura
ContattiRecuperare i contattiCreare, aggiornare, iscrivere e disiscrivere i contatti e aggiungerli o rimuoverli da una lista
Liste e audienceRecuperare liste e segmentiCreare una lista
CampagneRecuperare le campagne–
Invio–Inviare o pianificare una campagna esistente come newsletter
ReportRecuperare le statistiche di newsletter e automazioni–
AccountIl token per i carrelli abbandonati (necessario per il plugin WordPress)–
WebhookRecuperare i webhookRegistrare e rimuovere i webhook

Attenzione: con Invio (scrittura) la chiave può inviare newsletter reali ai tuoi contatti. Attivalo solo se il tuo collegamento ne ha bisogno.

Revocare una chiave API

Nell'elenco delle chiavi vedi per ciascuna i Permessi e quando è stata usata l'ultima volta (Ultimo utilizzo). Se vuoi smettere di usare una chiave, clicca sull'icona del cestino sotto Elimina e conferma. I collegamenti che usano quella chiave smettono di funzionare immediatamente. Questa operazione non può essere annullata.

Webhook: Xendy ti invia un messaggio

Con un webhook, Xendy invia automaticamente una richiesta POST al tuo URL quando accade qualcosa. Puoi scegliere tra tre eventi:

  • Record DNS non più corretti (dns-records.failed)
  • Record DNS ripristinati (dns-records.recovered)
  • Importazione negozio online fallita (webshop-import.failed)
  1. Nella scheda Webhook clicca su Aggiungi webhook.
  2. Inserisci l'URL (solo https) e scegli gli Eventi.
  3. Clicca su Aggiungi. Copia il secret del webhook che appare: lo vedi una sola volta.

Ogni messaggio è in JSON con id, event, created_at e data, e include gli header Xendy-Event, Xendy-Delivery e Xendy-Signature. Con la firma verifichi che il messaggio provenga davvero da Xendy. Xendy-Signature ha la forma t=<timestamp>,v1=<firma>: la firma è un HMAC-SHA256 di <t>.<body> con il tuo secret. Rifiuta i messaggi il cui t è più vecchio di 5 minuti. Un esempio in JavaScript è disponibile nella documentazione.

Rispondi entro 10 secondi con un codice di stato 2xx. Se la consegna non riesce, Xendy riprova dopo 1, 5 e 30 minuti. Se cinque eventi consecutivi falliscono completamente, Xendy imposta il webhook su Disabilitato. Ogni tentativo è visibile nella scheda Attività, sotto Webhook in uscita.

Limiti

  • 120 richieste al minuto per chiave
  • Azioni di scrittura: 60 al minuto
  • Invio: 10 al minuto

Se superi questi limiti, ricevi HTTP 429. Quando invii una newsletter, includi un header Idempotency-Key: entro 24 ore lo stesso valore restituisce la stessa newsletter, invece di un secondo invio.

Domande frequenti

No. Xendy mostra una chiave una sola volta e non la conserva in forma leggibile. Crea una nuova chiave, inseriscila nel tuo collegamento e poi revoca quella vecchia.

No. Una chiave API (xnd_live_...) funziona solo sull'API e una chiave MCP (xnd_mcp_...) solo per gli assistenti AI tramite MCP. Con una chiave MCP sull'API ricevi il codice di errore 401.

Significa che cinque eventi consecutivi non sono stati consegnati, nemmeno dopo i tentativi successivi. Nella scheda Attività (tipo Webhook in uscita) puoi vedere cosa ha risposto il tuo server. Risolvi il problema, elimina il webhook e aggiungilo di nuovo.

Nella scheda Webhook configuri i messaggi che Xendy invia al tuo sistema. Se vuoi inviare tu stesso i contatti a Xendy, usa in un segmento Aggiungi contatti → Tramite un webhook. Questo funziona con un token dedicato invece di una chiave API. Vedi Collegamento tramite Zapier.

Nella scheda Attività vedi ogni chiamata con stato, durata e i dati inviati. Vedi Visualizzare l'attività API.

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ù