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 MailerLite Integrations page.
Iniziare
Open the Webhook Section
Nel tuo cruscotto Dodo Payments, vai a Webhooks + Add Endpoint ed espandi il menu a discesa delle integrazioni.

Configure Transformation
Modifica il codice di trasformazione per formattare i dati degli iscritti per l’API di MailerLite.
Test & Create
Testa con payload di esempio e clicca su Create 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:- Accedi al tuo cruscotto MailerLite
- Vai su Subscribers Fields
- Clicca su Create field e aggiungi campi come:
total_spent(Number)customer_since(Date)subscription_plan(Text)payment_method(Text)last_payment_amount(Number)
Risoluzione dei problemi
Subscribers not being added
Subscribers not being added
- 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 e presenti nel tuo account
- Nota: gli iscritti cancellati, rimbalzati o contrassegnati come spam non possono essere riattivati tramite API
Custom fields not updating
Custom fields not updating
- Verifica che i campi personalizzati esistano in MailerLite prima di utilizzarli
- Controlla che i nomi dei campi corrispondano esattamente (distinguendo maiuscole/minuscole)
- Assicurati che i valori dei campi corrispondano al tipo previsto (text, number, date)
Rate limit errors
Rate limit errors
- L’API di MailerLite ha un limite di 120 richieste al minuto
- Utilizza endpoint batch se stai processando molti iscritti
- Implementa strategie di backoff per scenari ad alto volume
Group assignment not working
Group assignment not working
- Verifica che gli ID dei gruppi siano stringhe numeriche
- Controlla che i gruppi esistano nel tuo account MailerLite
- Nota: l’uso di 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 | Obbligatorio | Descrizione |
|---|---|---|---|
email | string | Yes | Indirizzo email valido (RFC 2821) |
fields | object | No | Oggetto con coppie nome/valore dei campi |
fields.name | string | No | Nome dell’iscritto |
fields.last_name | string | No | Cognome dell’iscritto |
fields.company | string | No | Nome azienda |
fields.country | string | No | Paese |
fields.city | string | No | Città |
fields.phone | string | No | Numero di telefono |
groups | array | No | Array di ID dei gruppi a cui aggiungere l’iscritto |
status | string | No | Uno tra: active, unsubscribed, unconfirmed, bounced, junk |
subscribed_at | string | No | Data nel formato yyyy-MM-dd HH:mm:ss |
ip_address | string | No | Indirizzo IP dell’iscritto |