MailerLite

Giới thiệu

Tích hợp MailerLite thêm khách hàng đã thanh toán vào MailerLite khi xảy ra các sự kiện thanh toán. Tích hợp này có thể thêm khách hàng vào các nhóm, lưu dữ liệu thanh toán trong các trường subscriber và bắt đầu các workflow automation, giúp danh sách email phản ánh hoạt động thanh toán thực tế. MailerLite là nền tảng email marketing dành cho newsletter, campaign và automation. Sử dụng tích hợp này để quản lý subscriber dựa trên hoạt động thanh toán, phục vụ chuỗi onboarding, phân khúc khách hàng và các campaign nhắm mục tiêu.

Tích hợp này xác thực bằng API key của MailerLite. Để tạo API key, hãy mở trang Integrations của MailerLite và nhấp vào Generate new token.

Bắt đầu

Open the Webhook Section

Trong bảng điều khiển Dodo Payments, đi đến Developer → Webhooks và nhấp vào Add endpoint.

Hộp thoại Add endpoint với MailerLite được chọn trong menu thả xuống Integration

Select MailerLite

Trong danh sách Integration, chọn MailerLite.

Enter API Key

Dán API key MailerLite vào trường API key. Dodo Payments gửi API key này dưới dạng header Authorization trong mỗi lần gửi.

Configure Transformation

Chỉnh sửa mã trong Transformation code để mỗi sự kiện trở thành một yêu cầu subscriber của MailerLite. Hãy bắt đầu từ các ví dụ bên dưới.

Test & Create

Trong Test this code, chạy transformation với một payload mẫu, sau đó nhấp vào Create endpoint.

Done

Các sự kiện thanh toán hiện sẽ thêm và cập nhật subscriber trong các nhóm MailerLite của bạn.

Ví dụ Mã Biến đổi

Hầu hết các ví dụ đều gửi yêu cầu POST đến API subscriber của MailerLite. MailerLite sẽ tạo subscriber hoặc cập nhật subscriber hiện có với cùng địa chỉ email. Thao tác upsert này không xóa các trường hoặc nhóm mà bạn bỏ qua.

Thêm Customer khi Thanh toán thành công

Ví dụ này thêm customer vào một nhóm khi thanh toán thành công. Thay your-group-id-here bằng ID nhóm 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;
}

Thêm Subscriber vào Nhiều nhóm dựa trên Product

Ví dụ này thêm mọi customer đã thanh toán vào nhóm customers, đồng thời thêm những customer thanh toán từ $100 trở lên vào nhóm 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;
}

Thêm Subscriber mới khi Kích hoạt Subscription

Ví dụ này thêm customer vào hai nhóm subscriber và lưu thông tin plan khi subscription trở nên active.

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

Cập nhật Subscriber khi Hủy Subscription

Ví dụ này cập nhật một subscriber hiện có khi subscription bị hủy. Ví dụ gửi một yêu cầu POST upsert được định danh bằng địa chỉ email, vì endpoint cập nhật PUT của MailerLite yêu cầu ID subscriber của MailerLite, trong khi payload của Dodo Payments không chứa thông tin này. Thao tác upsert thêm subscriber vào group đã rời bỏ và giữ nguyên các group khác của họ.

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

Thêm Customer với Custom Fields

Ví dụ này lưu trữ thông tin vị trí, liên hệ và thanh toán trong các trường subscriber. Trước tiên, hãy tạo các custom fields trong MailerLite như được mô tả trong Thiết lập 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;
}

Kích hoạt Automation qua Event

Ví dụ này cập nhật một trường trigger sau mỗi lần thanh toán thành công. Tạo một automation trong MailerLite bắt đầu khi last_payment_trigger thay đổi.

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

Mẹo

Tạo custom fields trong MailerLite trước khi sử dụng chúng trong một transformation.
Sử dụng các group để phân khúc customer theo sản phẩm, cấp độ plan hoặc hành vi mua hàng.
Thiết lập các workflow automation trong MailerLite bắt đầu khi một trường được cập nhật.
Gửi yêu cầu POST đến /subscribers để thực hiện upsert, qua đó tránh lỗi subscriber trùng lặp.
Lưu metadata thanh toán trong các custom fields để hiểu rõ hơn về customer của bạn.
Kiểm thử với một group nhỏ trước khi bật integration cho tất cả các khoản thanh toán.

Thiết lập Custom Fields

Tạo từng custom field trong MailerLite trước khi một transformation ghi dữ liệu vào đó:

Mở bảng điều khiển MailerLite.
Đi đến Subscribers → Fields.
Nhấp vào Create field và thêm các trường như:
- total_spent (Number)
- customer_since (Date)
- subscription_plan (Text)
- payment_method (Text)
- last_payment_amount (Number)

Khắc phục sự cố

Subscribers Not Being Added

Kiểm tra để đảm bảo API key chính xác và đang hoạt động.
Kiểm tra để đảm bảo địa chỉ email hợp lệ theo RFC 2821.
Kiểm tra để đảm bảo mỗi group ID chính xác và tồn tại trong tài khoản của bạn.
MailerLite không kích hoạt lại các subscriber bị bounce hoặc bị đánh dấu là spam thông qua API. Để đăng ký lại một subscriber trước đây đã hủy đăng ký, hãy thêm resubscribe: true vào phần body của POST.

Custom Fields Not Updating

Kiểm tra để đảm bảo từng custom field tồn tại trong MailerLite.
Kiểm tra để đảm bảo tên trường khớp chính xác. Tên trường phân biệt chữ hoa chữ thường.
Kiểm tra để đảm bảo mỗi giá trị khớp với kiểu trường: text, number hoặc date.

Rate Limit Errors

MailerLite API cho phép 120 request mỗi phút.
Sử dụng batch endpoint khi xử lý nhiều subscriber.
Thêm chiến lược backoff cho các tình huống có lưu lượng lớn.

Group Assignment Not Working

Kiểm tra để đảm bảo group ID là các chuỗi số.
Kiểm tra để đảm bảo các group tồn tại trong tài khoản MailerLite của bạn.
Một yêu cầu PUT với groups sẽ xóa subscriber khỏi mọi group không được liệt kê. Một yêu cầu POST chỉ thêm group.

Tham chiếu API

Endpoint tạo hoặc upsert subscriber của MailerLite chấp nhận các tham số chính sau:

Parameter	Type	Required	Description
`email`	string	Yes	Địa chỉ email hợp lệ (RFC 2821)
`fields`	object	No	Object chứa các cặp tên trường/giá trị
`fields.name`	string	No	Tên của subscriber
`fields.last_name`	string	No	Họ của subscriber
`fields.company`	string	No	Tên công ty
`fields.country`	string	No	Quốc gia
`fields.city`	string	No	Thành phố
`fields.phone`	string	No	Số điện thoại
`groups`	array	No	Mảng group ID để thêm subscriber vào
`status`	string	No	Một trong các giá trị: `active`, `unsubscribed`, `unconfirmed`, `bounced`, `junk`
`subscribed_at`	string	No	Ngày theo định dạng `yyyy-MM-dd HH:mm:ss`
`ip_address`	string	No	Địa chỉ IP của subscriber
`resubscribe`	boolean	No	Đặt thành `true` để đăng ký lại một subscriber trước đây đã hủy đăng ký

Để xem tài liệu API đầy đủ, hãy xem MailerLite Developers.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Giới thiệu

Bắt đầu

Ví dụ Mã Biến đổi

Thêm Customer khi Thanh toán thành công

Thêm Subscriber vào Nhiều nhóm dựa trên Product

Thêm Subscriber mới khi Kích hoạt Subscription

Cập nhật Subscriber khi Hủy Subscription

Thêm Customer với Custom Fields

Kích hoạt Automation qua Event

Mẹo

Thiết lập Custom Fields

Khắc phục sự cố

Tham chiếu API

​Giới thiệu

​Bắt đầu

​Ví dụ Mã Biến đổi

​Thêm Customer khi Thanh toán thành công

​Thêm Subscriber vào Nhiều nhóm dựa trên Product

​Thêm Subscriber mới khi Kích hoạt Subscription

​Cập nhật Subscriber khi Hủy Subscription

​Thêm Customer với Custom Fields

​Kích hoạt Automation qua Event

​Mẹo

​Thiết lập Custom Fields

​Khắc phục sự cố

​Tham chiếu API

Giới thiệu

Bắt đầu

Ví dụ Mã Biến đổi

Thêm Customer khi Thanh toán thành công

Thêm Subscriber vào Nhiều nhóm dựa trên Product

Thêm Subscriber mới khi Kích hoạt Subscription

Cập nhật Subscriber khi Hủy Subscription

Thêm Customer với Custom Fields

Kích hoạt Automation qua Event

Mẹo

Thiết lập Custom Fields

Khắc phục sự cố

Tham chiếu API