MailerLite

介绍

MailerLite 集成会在付款事件发生时将您的付费客户添加到 MailerLite。它可以将客户添加到群组、在订阅者字段中存储付款数据并启动自动化工作流，从而让您的电子邮件列表反映真实的付款活动。 MailerLite 是一个用于新闻通讯、营销活动和自动化流程的电子邮件营销平台。您可以使用此集成根据付款活动管理订阅者，用于新客户引导流程、客户细分和定向营销活动。

此集成使用 MailerLite API key 进行身份验证。要创建 API key，请打开您的 MailerLite Integrations page，然后点击 Generate new token。

开始使用

Open the Webhook Section

在 Dodo Payments 控制面板中，前往 Developer → Webhooks，然后点击 Add endpoint。

添加 endpoint 对话框，Integration 下拉菜单中已选择 MailerLite

Select MailerLite

在 Integration 列表中选择 MailerLite。

Enter API Key

将 MailerLite API key 粘贴到 API key 字段中。Dodo Payments 会在每次发送时将其作为 Authorization 标头发送。

Configure Transformation

编辑 Transformation code 下的代码，使每个事件都转换为 MailerLite 订阅者请求。请从下面的示例开始。

Test & Create

在 Test this code 下，针对示例负载运行转换，然后点击 Create endpoint。

Done

现在，付款事件会在您的 MailerLite 群组中添加和更新订阅者。

转换代码示例

大多数示例都会向 MailerLite 订阅者 API 发送 POST 请求。MailerLite 会创建订阅者，或使用相同的电子邮件地址更新现有订阅者。此 upsert 不会删除您未包含的字段或群组。

在付款成功时添加客户

此示例会在付款成功时将客户添加到一个群组。请将 your-group-id-here 替换为 MailerLite 群组 ID。

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

根据产品将订阅者添加到多个群组

此示例会将每位付费客户添加到 customers 群组，并将支付金额达到 $100 或更高的客户同时添加到 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;
}

在订阅激活时添加新订阅者

此示例会在订阅变为活跃状态时，将客户添加到两个订阅者群组，并存储方案详细信息。

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

在订阅取消时更新订阅者

此示例会在订阅取消时更新现有订阅者。它会发送一个 POST upsert，并以电子邮件地址作为键，因为 MailerLite 的 PUT 更新 endpoint 需要 MailerLite 订阅者 ID，而 Dodo Payments 的 payload 中不包含该 ID。此 upsert 会将订阅者添加到流失群组，同时保留其所属的其他群组。

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

添加带自定义字段的客户

此示例会将位置、联系信息和付款详细信息存储在订阅者字段中。请先在 MailerLite 中创建自定义字段，具体说明请参阅自定义字段设置。

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

通过事件触发自动化

此示例会在每次付款成功时更新触发字段。在 MailerLite 中构建一个自动化流程，使其在 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;
}

提示

在转换中使用自定义字段之前，先在 MailerLite 中创建这些字段。
使用群组按产品、方案级别或购买行为对客户进行细分。
在 MailerLite 中设置自动化工作流，使其在字段更新时启动。
向 /subscribers 发送 POST 请求以执行 upsert，从而避免重复订阅者错误。
将付款元数据存储在自定义字段中，以便更深入地了解客户。
在为所有付款启用集成之前，先使用小规模群组进行测试。

自定义字段设置

在转换向每个自定义字段写入数据之前，先在 MailerLite 中创建该字段：

打开 MailerLite 控制面板。
前往 Subscribers → Fields。
点击 Create field，并添加以下字段：
- total_spent（Number）
- customer_since（Date）
- subscription_plan（Text）
- payment_method（Text）
- last_payment_amount（Number）

故障排除

Subscribers Not Being Added

检查 API key 是否正确且处于启用状态。
检查电子邮件地址是否符合 RFC 2821 要求。
检查每个群组 ID 是否正确，并且群组是否存在于你的账户中。
MailerLite 不会通过 API 重新激活退信或垃圾邮件订阅者。要重新订阅之前已取消订阅的订阅者，请将 resubscribe: true 添加到 POST body 中。

Custom Fields Not Updating

检查每个自定义字段是否存在于 MailerLite 中。
检查字段名称是否完全匹配。字段名称区分大小写。
检查每个值是否符合字段类型：文本、数字或日期。

Rate Limit Errors

MailerLite API 每分钟允许 120 个请求。
处理大量订阅者时，使用 batch endpoint。
在高流量场景中添加退避策略。

Group Assignment Not Working

检查群组 ID 是否为数字字符串。
检查这些群组是否存在于你的 MailerLite 账户中。
带有 groups 的 PUT 请求会将订阅者从未列出的所有群组中移除。POST 请求只会添加群组。

API 参考

MailerLite 的 create 或 upsert subscriber endpoint 接受以下关键参数：

Parameter	Type	Required	Description
`email`	string	Yes	有效的电子邮件地址（RFC 2821）
`fields`	object	No	包含字段名称/值对的对象
`fields.name`	string	No	订阅者的名字
`fields.last_name`	string	No	订阅者的姓氏
`fields.company`	string	No	公司名称
`fields.country`	string	No	国家/地区
`fields.city`	string	No	城市
`fields.phone`	string	No	电话号码
`groups`	array	No	要将订阅者添加到的群组 ID 数组
`status`	string	No	以下值之一：`active`、`unsubscribed`、`unconfirmed`、`bounced`、`junk`
`subscribed_at`	string	No	格式为 `yyyy-MM-dd HH:mm:ss` 的日期
`ip_address`	string	No	订阅者的 IP 地址
`resubscribe`	boolean	No	设置为 `true`，以重新订阅之前已取消订阅的订阅者

如需完整的 API 文档，请参阅 MailerLite Developers。

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

介绍

开始使用

转换代码示例

在付款成功时添加客户

根据产品将订阅者添加到多个群组

在订阅激活时添加新订阅者

在订阅取消时更新订阅者

添加带自定义字段的客户

通过事件触发自动化

提示

自定义字段设置

故障排除

API 参考

​介绍

​开始使用

​转换代码示例

​在付款成功时添加客户

​根据产品将订阅者添加到多个群组

​在订阅激活时添加新订阅者

​在订阅取消时更新订阅者

​添加带自定义字段的客户

​通过事件触发自动化

​提示

​自定义字段设置

​故障排除

​API 参考

介绍

开始使用

转换代码示例

在付款成功时添加客户

根据产品将订阅者添加到多个群组

在订阅激活时添加新订阅者

在订阅取消时更新订阅者

添加带自定义字段的客户

通过事件触发自动化

提示

自定义字段设置

故障排除

API 参考