MailerLite

Introduzione

L’integrazione con MailerLite aggiunge i tuoi clienti paganti a MailerLite quando si verificano eventi di pagamento. Può aggiungere i clienti ai gruppi, memorizzare i dati di pagamento nei campi degli iscritti e avviare flussi di automazione, così le tue liste email riflettono l’attività reale dei pagamenti. MailerLite è una piattaforma di email marketing per newsletter, campagne e automazioni. Usa questa integrazione per gestire gli iscritti in base all’attività dei pagamenti, per le sequenze di onboarding, la segmentazione dei clienti e le campagne mirate.

Questa integrazione esegue l’autenticazione con una chiave API di MailerLite. Per crearne una, apri la pagina delle integrazioni di MailerLite e fai clic su Generate new token.

Iniziare

Open the Webhook Section

Nella dashboard di Dodo Payments, vai a Developer → Webhooks e fai clic su Add endpoint.

Finestra di dialogo per l'aggiunta di un endpoint con MailerLite selezionato nel menu a discesa Integration

Select MailerLite

Nell’elenco Integration, seleziona MailerLite.

Enter API Key

Incolla la chiave API di MailerLite nel campo API key. Dodo Payments la invia come intestazione Authorization a ogni invio.

Configure Transformation

Modifica il codice in Transformation code in modo che ogni evento diventi una richiesta a un iscritto di MailerLite. Inizia dagli esempi seguenti.

Test & Create

In Test this code, esegui la trasformazione su un payload di esempio, quindi fai clic su Create endpoint.

Done

Gli eventi di pagamento ora aggiungono e aggiornano gli iscritti nei tuoi gruppi MailerLite.

Esempi di codice di trasformazione

La maggior parte degli esempi invia una richiesta POST all’API degli iscritti di MailerLite. MailerLite crea l’iscritto oppure aggiorna quello esistente con lo stesso indirizzo email. Questo upsert non rimuove mai i campi o i gruppi omessi.

Aggiungere un cliente dopo un pagamento completato

Questo esempio aggiunge il cliente a un gruppo quando un pagamento va a buon fine. Sostituisci your-group-id-here con l’ID di un gruppo MailerLite.

add_customer.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: p.customer.email,
      fields: {
        name: p.customer.name,
        last_name: ""
      },
      groups: ["your-group-id-here"],
      status: "active"
    };
  }
  return webhook;
}

Aggiungere un iscritto a più gruppi in base al prodotto

Questo esempio aggiunge ogni cliente pagante a un gruppo di clienti e aggiunge anche a un gruppo premium i clienti che pagano almeno $100.

product_segmentation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    
    // Determine groups based on product or amount
    const groups = ["customers-group-id"];
    
    // Add to premium group if high-value purchase
    if (p.total_amount >= 10000) { // $100+
      groups.push("premium-customers-group-id");
    }
    
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: p.customer.email,
      fields: {
        name: p.customer.name,
        last_purchase_amount: (p.total_amount / 100).toFixed(2),
        last_purchase_date: new Date(webhook.payload.timestamp).toISOString().split('T')[0],
        payment_id: p.payment_id
      },
      groups: groups,
      status: "active"
    };
  }
  return webhook;
}

Aggiungere un nuovo iscritto all’attivazione dell’abbonamento

Questo esempio aggiunge il cliente a due gruppi di iscritti e memorizza i dettagli del piano quando un abbonamento diventa attivo.

subscription_subscriber.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: s.customer.email,
      fields: {
        name: s.customer.name,
        subscription_plan: s.product_id,
        subscription_amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
        billing_frequency: s.payment_frequency_interval,
        subscription_start: new Date().toISOString().split('T')[0]
      },
      groups: ["subscribers-group-id", "active-subscriptions-group-id"],
      status: "active"
    };
  }
  return webhook;
}

Aggiornare un iscritto alla cancellazione dell’abbonamento

Questo esempio aggiorna un iscritto esistente quando un abbonamento viene annullato. Invia una richiesta POST di upsert utilizzando l’indirizzo email come chiave, perché l’endpoint di aggiornamento PUT di MailerLite richiede l’ID dell’iscritto MailerLite, che non è presente nel payload di Dodo Payments. L’upsert aggiunge l’iscritto al gruppo dei clienti persi e mantiene gli altri gruppi a cui appartiene.

subscription_cancelled.js

function handler(webhook) {
  if (webhook.eventType === "subscription.cancelled") {
    const s = webhook.payload.data;
    // POST upserts by email; PUT needs the MailerLite subscriber ID
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: s.customer.email,
      fields: {
        subscription_status: "cancelled",
        cancellation_date: new Date().toISOString().split('T')[0]
      },
      groups: ["churned-customers-group-id"]
    };
  }
  return webhook;
}

Aggiungere un cliente con campi personalizzati

Questo esempio memorizza i dati relativi a posizione, contatto e pagamento nei campi dell’iscritto. Crea prima i campi personalizzati in MailerLite, come descritto in Configurazione dei campi personalizzati.

custom_fields.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: p.customer.email,
      fields: {
        name: p.customer.name,
        country: p.billing?.country || "",
        city: p.billing?.city || "",
        phone: p.customer.phone_number || "",
        // Custom fields (must be created in MailerLite first)
        total_spent: (p.total_amount / 100).toFixed(2),
        customer_since: new Date().toISOString().split('T')[0],
        payment_method: p.payment_method || "unknown",
        currency: p.currency || "USD"
      },
      groups: ["paying-customers-group-id"],
      status: "active",
      subscribed_at: new Date().toISOString().replace('T', ' ').split('.')[0]
    };
  }
  return webhook;
}

Attivare un’automazione tramite un evento

Questo esempio aggiorna un campo trigger a ogni pagamento completato con successo. Crea un’automazione in MailerLite che inizi quando cambia last_payment_trigger.

trigger_automation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    
    // First, ensure subscriber exists
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: p.customer.email,
      fields: {
        name: p.customer.name,
        // Add a trigger field that your automation watches
        last_payment_trigger: new Date().toISOString(),
        last_payment_amount: (p.total_amount / 100).toFixed(2)
      },
      status: "active"
    };
    
    // Tip: Create an automation in MailerLite that triggers
    // when 'last_payment_trigger' field is updated
  }
  return webhook;
}

Suggerimenti

Crea i campi personalizzati in MailerLite prima di utilizzarli in una trasformazione.
Usa i gruppi per segmentare i clienti in base al prodotto, al livello del piano o al comportamento di acquisto.
Configura i flussi di lavoro di automazione in MailerLite in modo che inizino quando un campo viene aggiornato.
Invia una richiesta POST a /subscribers per eseguire un upsert, evitando così gli errori relativi agli iscritti duplicati.
Memorizza i metadati dei pagamenti nei campi personalizzati per conoscere meglio i tuoi clienti.
Esegui un test con un gruppo ristretto prima di abilitare l’integrazione per tutti i pagamenti.

Configurazione dei campi personalizzati

Crea ogni campo personalizzato in MailerLite prima che una trasformazione vi scriva:

Apri la dashboard di MailerLite.
Vai a Subscribers → Fields.
Fai clic 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

Verifica che la chiave API sia corretta e attiva.
Verifica che l’indirizzo email sia valido secondo RFC 2821.
Verifica che ogni ID gruppo sia corretto e presente nel tuo account.
MailerLite non riattiva tramite API gli iscritti con email rimbalzate o contrassegnati come spam. Per iscrivere nuovamente un iscritto che aveva annullato l’iscrizione, aggiungi resubscribe: true al corpo della richiesta POST.

Custom Fields Not Updating

Verifica che ogni campo personalizzato esista in MailerLite.
Verifica che i nomi dei campi corrispondano esattamente. Distinguono tra maiuscole e minuscole.
Verifica che ogni valore corrisponda al tipo di campo: testo, numero o data.

Rate Limit Errors

L’API di MailerLite consente 120 richieste al minuto.
Usa l’endpoint batch quando elabori molti iscritti.
Aggiungi una strategia di backoff per gli scenari ad alto volume.

Group Assignment Not Working

Verifica che gli ID gruppo siano stringhe numeriche.
Verifica che i gruppi esistano nel tuo account MailerLite.
Una richiesta PUT con groups rimuove l’iscritto da ogni gruppo non incluso nella richiesta. Una richiesta POST aggiunge soltanto gruppi.

Riferimento API

L’endpoint di MailerLite per creare o eseguire l’upsert di un iscritto accetta questi parametri principali:

Parametro	Tipo	Obbligatorio	Descrizione
`email`	string	Sì	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 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 gruppo 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
`resubscribe`	boolean	No	Imposta su `true` per iscrivere nuovamente un iscritto che aveva annullato l’iscrizione

Per la documentazione API completa, consulta Sviluppatori MailerLite.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduzione

Iniziare

Esempi di codice di trasformazione

Aggiungere un cliente dopo un pagamento completato

Aggiungere un iscritto a più gruppi in base al prodotto

Aggiungere un nuovo iscritto all’attivazione dell’abbonamento

Aggiornare un iscritto alla cancellazione dell’abbonamento

Aggiungere un cliente con campi personalizzati

Attivare un’automazione tramite un evento

Suggerimenti

Configurazione dei campi personalizzati

Risoluzione dei problemi

Riferimento API

​Introduzione

​Iniziare

​Esempi di codice di trasformazione

​Aggiungere un cliente dopo un pagamento completato

​Aggiungere un iscritto a più gruppi in base al prodotto

​Aggiungere un nuovo iscritto all’attivazione dell’abbonamento

​Aggiornare un iscritto alla cancellazione dell’abbonamento

​Aggiungere un cliente con campi personalizzati

​Attivare un’automazione tramite un evento

​Suggerimenti

​Configurazione dei campi personalizzati

​Risoluzione dei problemi

​Riferimento API

Introduzione

Iniziare

Esempi di codice di trasformazione

Aggiungere un cliente dopo un pagamento completato

Aggiungere un iscritto a più gruppi in base al prodotto

Aggiungere un nuovo iscritto all’attivazione dell’abbonamento

Aggiornare un iscritto alla cancellazione dell’abbonamento

Aggiungere un cliente con campi personalizzati

Attivare un’automazione tramite un evento

Suggerimenti

Configurazione dei campi personalizzati

Risoluzione dei problemi

Riferimento API