Introduzione
Sincronizza automaticamente i tuoi clienti paganti con le liste di iscrizione di MailerLite quando si verificano eventi di pagamento. Aggiungi i clienti a gruppi specifici, attiva flussi di automazione e mantieni aggiornate le tue liste di email marketing con dati di pagamento reali. MailerLite è una potente piattaforma di email marketing per newsletter, campagne e automazioni. Questa integrazione ti aiuta a gestire automaticamente gli iscritti in base all’attività di pagamento - perfetta per sequenze di onboarding, segmentazione dei clienti e campagne di marketing mirate.Questa integrazione richiede la tua chiave API di MailerLite per l’autenticazione. Puoi generarne una dalla tua pagina delle integrazioni di MailerLite.
Iniziare
Apri la sezione Webhook
Nel tuo dashboard di Dodo Payments, vai su Webhook + Aggiungi Endpoint ed espandi il menu a discesa delle integrazioni.

Configura la trasformazione
Modifica il codice di trasformazione per formattare i dati degli iscritti per l’API di MailerLite.
Testa e crea
Testa con payload di esempio e fai clic su Crea per attivare la sincronizzazione degli iscritti.
Esempi di codice di trasformazione
Aggiungi cliente al pagamento riuscito
add_customer.js
Aggiungi iscritto a più gruppi in base al prodotto
product_segmentation.js
Aggiungi nuovo iscritto all’attivazione dell’abbonamento
subscription_subscriber.js
Aggiorna iscritto alla cancellazione dell’abbonamento
subscription_cancelled.js
Aggiungi cliente con campi personalizzati
custom_fields.js
Attiva automazione tramite evento
trigger_automation.js
Suggerimenti
- Crea campi personalizzati in MailerLite prima di usarli nelle tue trasformazioni
- Usa gruppi per segmentare i clienti per prodotto, piano o comportamento d’acquisto
- Imposta flussi di automazione in MailerLite che si attivano sugli aggiornamenti dei campi
- Usa il comportamento upsert (POST a /subscribers) per evitare errori di iscritti duplicati
- Memorizza i metadati di pagamento in campi personalizzati per migliori approfondimenti sui clienti
- Testa con un piccolo gruppo prima di abilitare per tutti i pagamenti
Configurazione dei campi personalizzati
Prima di utilizzare i campi personalizzati, devi crearli in MailerLite:- Vai al tuo dashboard di MailerLite
- Naviga su Campi iscritti
- Fai clic su Crea campo e aggiungi campi come:
total_spent(Numero)customer_since(Data)subscription_plan(Testo)payment_method(Testo)last_payment_amount(Numero)
Risoluzione dei problemi
Gli iscritti non vengono aggiunti
Gli iscritti non vengono aggiunti
- Verifica che la chiave API sia corretta e attiva
- Controlla che l’indirizzo email sia valido (conforme a RFC 2821)
- Assicurati che gli ID dei gruppi siano corretti ed esistano nel tuo account
- Nota: Gli iscritti disiscritti, rimbalzati o di spam non possono essere riattivati tramite API
I campi personalizzati non si aggiornano
I campi personalizzati non si aggiornano
- Verifica che i campi personalizzati esistano in MailerLite prima di usarli
- Controlla che i nomi dei campi corrispondano esattamente (case-sensitive)
- Assicurati che i valori dei campi corrispondano al tipo previsto (testo, numero, data)
Errori di limite di frequenza
Errori di limite di frequenza
- L’API di MailerLite ha un limite di frequenza di 120 richieste al minuto
- Usa endpoint batch se stai elaborando molti iscritti
- Implementa strategie di backoff per scenari ad alto volume
Assegnazione del gruppo non funzionante
Assegnazione del gruppo non funzionante
- Verifica che gli ID dei gruppi siano stringhe numeriche
- Controlla che i gruppi esistano nel tuo account MailerLite
- Nota: Usare PUT con i gruppi rimuoverà l’iscritto dai gruppi non elencati
Riferimento API
L’API degli iscritti di MailerLite accetta i seguenti parametri chiave:| Parametro | Tipo | Richiesto | Descrizione |
|---|---|---|---|
email | string | Sì | Indirizzo email valido (RFC 2821) |
fields | object | No | Oggetto con coppie nome/valore dei campi |
fields.name | string | No | Nome di battesimo dell’iscritto |
fields.last_name | string | No | Cognome dell’iscritto |
fields.company | string | No | Nome dell’azienda |
fields.country | string | No | Paese |
fields.city | string | No | Città |
fields.phone | string | No | Numero di telefono |
groups | array | No | Array di ID di gruppi a cui aggiungere l’iscritto |
status | string | No | Uno tra: attivo, disiscritto, non confermato, rimbalzato, spam |
subscribed_at | string | No | Data nel formato yyyy-MM-dd HH:mm:ss |
ip_address | string | No | Indirizzo IP dell’iscritto |