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
1
Apri la sezione Webhook
Nel tuo dashboard di Dodo Payments, vai su Webhook + Aggiungi Endpoint ed espandi il menu a discesa delle integrazioni.

2
Seleziona MailerLite
Scegli la scheda di integrazione MailerLite.
3
Inserisci la chiave API
Fornisci la tua chiave API di MailerLite nella configurazione.
4
Configura la trasformazione
Modifica il codice di trasformazione per formattare i dati degli iscritti per l’API di MailerLite.
5
Testa e crea
Testa con payload di esempio e fai clic su Crea per attivare la sincronizzazione degli iscritti.
6
Fatto!
Gli eventi di pagamento sincronizzeranno ora automaticamente i clienti con le tue liste di MailerLite.
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 |