MailerLite

Pendahuluan

Integrasi MailerLite menambahkan pelanggan yang membayar ke MailerLite saat event pembayaran terjadi. Integrasi ini dapat menambahkan pelanggan ke grup, menyimpan data pembayaran di field subscriber, dan memulai alur kerja automasi, sehingga daftar email Anda mencerminkan aktivitas pembayaran yang sebenarnya. MailerLite adalah platform email marketing untuk newsletter, kampanye, dan automasi. Gunakan integrasi ini untuk mengelola subscriber berdasarkan aktivitas pembayaran, untuk rangkaian onboarding, segmentasi pelanggan, dan kampanye tertarget.

Integrasi ini melakukan autentikasi menggunakan API key MailerLite. Untuk membuatnya, buka halaman Integrations MailerLite dan klik Generate new token.

Memulai

Open the Webhook Section

Di dasbor Dodo Payments, buka Developer → Webhooks lalu klik Add endpoint.

Dialog Add endpoint dengan MailerLite dipilih di dropdown Integration

Select MailerLite

Di daftar Integration, pilih MailerLite.

Enter API Key

Tempel API key MailerLite ke field API key. Dodo Payments mengirimkannya sebagai header Authorization pada setiap pengiriman.

Configure Transformation

Edit kode di bawah Transformation code agar setiap event menjadi request subscriber MailerLite. Mulailah dari contoh di bawah.

Test & Create

Di bawah Test this code, jalankan transformasi terhadap payload contoh, lalu klik Create endpoint.

Done

Event pembayaran kini menambahkan dan memperbarui subscriber di grup MailerLite Anda.

Contoh Kode Transformasi

Sebagian besar contoh mengirim request POST ke API subscriber MailerLite. MailerLite membuat subscriber, atau memperbarui subscriber yang sudah ada dengan alamat email yang sama. Upsert ini tidak pernah menghapus field atau grup yang tidak Anda sertakan.

Tambahkan Pelanggan saat Pembayaran Berhasil

Contoh ini menambahkan pelanggan ke satu grup saat pembayaran berhasil. Ganti your-group-id-here dengan ID grup 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;
}

Tambahkan Subscriber ke Beberapa Grup Berdasarkan Produk

Contoh ini menambahkan setiap pelanggan yang membayar ke grup customers, dan juga menambahkan pelanggan yang membayar $100 atau lebih ke grup premium.

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;
}

Tambahkan Subscriber Baru saat Aktivasi Subscription

Contoh ini menambahkan pelanggan ke dua grup subscriber dan menyimpan detail paket saat subscription menjadi aktif.

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;
}

Perbarui Subscriber saat Pembatalan Subscription

Contoh ini memperbarui subscriber yang sudah ada ketika subscription dibatalkan. Contoh ini mengirim upsert POST berdasarkan alamat email, karena endpoint update PUT milik MailerLite memerlukan ID subscriber MailerLite, yang tidak terdapat dalam payload Dodo Payments. Upsert tersebut menambahkan subscriber ke grup churned dan mempertahankan grup lainnya.

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;
}

Menambahkan Customer dengan Custom Fields

Contoh ini menyimpan detail lokasi, kontak, dan pembayaran di kolom subscriber. Buat custom fields di MailerLite terlebih dahulu, seperti yang dijelaskan dalam Penyiapan Custom Fields.

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;
}

Memicu Automation melalui Event

Contoh ini memperbarui field pemicu pada setiap pembayaran yang berhasil. Buat automation di MailerLite yang dimulai ketika last_payment_trigger berubah.

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;
}

Tips

Buat custom fields di MailerLite sebelum menggunakannya dalam transformation.
Gunakan grup untuk mengelompokkan customer berdasarkan produk, tingkat plan, atau perilaku pembelian.
Siapkan workflow automation di MailerLite yang dimulai ketika sebuah field diperbarui.
Kirim request POST ke /subscribers untuk melakukan upsert, sehingga menghindari error subscriber duplikat.
Simpan metadata pembayaran di custom fields untuk mempelajari lebih lanjut tentang customer Anda.
Uji dengan grup kecil sebelum mengaktifkan integrasi untuk semua pembayaran.

Penyiapan Custom Fields

Buat setiap custom field di MailerLite sebelum transformation menulis ke dalamnya:

Buka dasbor MailerLite Anda.
Buka Subscribers → Fields.
Klik Create field dan tambahkan field seperti:
- total_spent (Number)
- customer_since (Date)
- subscription_plan (Text)
- payment_method (Text)
- last_payment_amount (Number)

Pemecahan Masalah

Subscribers Not Being Added

Periksa bahwa API key sudah benar dan aktif.
Periksa bahwa alamat email valid menurut RFC 2821.
Periksa bahwa setiap group ID sudah benar dan ada di akun Anda.
MailerLite tidak mengaktifkan kembali subscriber yang terpental atau ditandai sebagai junk melalui API. Untuk berlangganan kembali subscriber yang sebelumnya berhenti berlangganan, tambahkan resubscribe: true ke body POST.

Custom Fields Not Updating

Periksa bahwa setiap custom field ada di MailerLite.
Periksa bahwa nama field sama persis. Nama field peka huruf besar-kecil.
Periksa bahwa setiap nilai sesuai dengan jenis field: text, number, atau date.

Rate Limit Errors

MailerLite API mengizinkan 120 request per menit.
Gunakan batch endpoint saat memproses banyak subscriber.
Tambahkan strategi backoff untuk skenario bervolume tinggi.

Group Assignment Not Working

Periksa bahwa group ID berupa string numerik.
Periksa bahwa grup tersebut ada di akun MailerLite Anda.
Request PUT dengan groups menghapus subscriber dari setiap grup yang tidak dicantumkan. Request POST hanya menambahkan grup.

Referensi API

Endpoint create atau upsert subscriber MailerLite menerima parameter utama berikut:

Parameter	Type	Required	Description
`email`	string	Yes	Alamat email valid (RFC 2821)
`fields`	object	No	Object dengan pasangan nama/nilai field
`fields.name`	string	No	Nama depan subscriber
`fields.last_name`	string	No	Nama belakang subscriber
`fields.company`	string	No	Nama perusahaan
`fields.country`	string	No	Negara
`fields.city`	string	No	Kota
`fields.phone`	string	No	Nomor telepon
`groups`	array	No	Array group ID untuk menambahkan subscriber ke dalamnya
`status`	string	No	Salah satu dari: `active`, `unsubscribed`, `unconfirmed`, `bounced`, `junk`
`subscribed_at`	string	No	Tanggal dalam format `yyyy-MM-dd HH:mm:ss`
`ip_address`	string	No	Alamat IP subscriber
`resubscribe`	boolean	No	Atur ke `true` untuk berlangganan kembali subscriber yang sebelumnya berhenti berlangganan

Untuk dokumentasi API lengkap, lihat MailerLite Developers.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Kode Transformasi

Tambahkan Pelanggan saat Pembayaran Berhasil

Tambahkan Subscriber ke Beberapa Grup Berdasarkan Produk

Tambahkan Subscriber Baru saat Aktivasi Subscription

Perbarui Subscriber saat Pembatalan Subscription

Menambahkan Customer dengan Custom Fields

Memicu Automation melalui Event

Tips

Penyiapan Custom Fields

Pemecahan Masalah

Referensi API

​Pendahuluan

​Memulai

​Contoh Kode Transformasi

​Tambahkan Pelanggan saat Pembayaran Berhasil

​Tambahkan Subscriber ke Beberapa Grup Berdasarkan Produk

​Tambahkan Subscriber Baru saat Aktivasi Subscription

​Perbarui Subscriber saat Pembatalan Subscription

​Menambahkan Customer dengan Custom Fields

​Memicu Automation melalui Event

​Tips

​Penyiapan Custom Fields

​Pemecahan Masalah

​Referensi API

Pendahuluan

Memulai

Contoh Kode Transformasi

Tambahkan Pelanggan saat Pembayaran Berhasil

Tambahkan Subscriber ke Beberapa Grup Berdasarkan Produk

Tambahkan Subscriber Baru saat Aktivasi Subscription

Perbarui Subscriber saat Pembatalan Subscription

Menambahkan Customer dengan Custom Fields

Memicu Automation melalui Event

Tips

Penyiapan Custom Fields

Pemecahan Masalah

Referensi API