メインコンテンツへスキップ

​
はじめに

支払いイベントが発生したときに、支払い顧客をMailerLiteの購読者リストに自動的に同期します。顧客を特定のグループに追加し、自動化ワークフローをトリガーし、実際の支払いデータでメールマーケティングリストを最新の状態に保ちます。 MailerLiteは、ニュースレター、キャンペーン、および自動化のための強力なメールマーケティングプラットフォームです。この統合により、支払い活動に基づいて購読者を自動的に管理できます。これは、オンボーディングシーケンス、顧客セグメンテーション、およびターゲットマーケティングキャンペーンに最適です。
この統合では認証のためにMailerLite APIキーが必要です。MailerLiteのIntegrationsページ から生成できます。

​
始め方

1

Open the Webhook Section

Dodo Payments ダッシュボードで Webhooks + Add Endpoint に移動し、インテグレーションのドロップダウンを展開します。
エンドポイント追加とインテグレーションのドロップダウン
2

Select MailerLite

MailerLite インテグレーションカードを選択します。
3

Enter API Key

設定でMailerLite APIキーを入力します。
4

Configure Transformation

変換コードを編集して、MailerLiteのAPI用に購読者データを整形します。
5

Test & Create

サンプルペイロードでテストし、Create をクリックして購読者同期を有効化します。
6

Done!

支払いイベントが自動的に顧客を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,
        company: p.customer.business_name || "",
        last_name: ""
      },
      groups: ["your-group-id-here"],
      status: "active"
    };
  }
  return webhook;
}

​
製品に基づいて複数のグループに購読者を追加

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

​
サブスクリプションのキャンセル時に購読者を更新

subscription_cancelled.js
function handler(webhook) {
  if (webhook.eventType === "subscription.cancelled") {
    const s = webhook.payload.data;
    // Use PUT to update existing subscriber
    webhook.url = "https://connect.mailerlite.com/api/subscribers/" + encodeURIComponent(s.customer.email);
    webhook.method = "PUT";
    webhook.payload = {
      fields: {
        subscription_status: "cancelled",
        cancellation_date: new Date().toISOString().split('T')[0]
      },
      groups: ["churned-customers-group-id"]
    };
  }
  return webhook;
}

​
カスタムフィールドを持つ顧客を追加

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,
        company: p.customer.business_name || "",
        country: p.customer.country || "",
        city: p.customer.city || "",
        phone: p.customer.phone || "",
        // 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;
}

​
イベントを介して自動化をトリガー

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の自動化ワークフローを設定します
  • 重複する購読者エラーを避けるために、upsert動作（/subscribersにPOST）を使用します
  • より良い顧客インサイトのために、カスタムフィールドに支払いメタデータを保存します
  • すべての支払いを有効にする前に、小さなグループでテストします

​
カスタムフィールドの設定

カスタムフィールドを使用する前に、MailerLiteで作成する必要があります：
  1. MailerLiteダッシュボードにアクセスします。
  2. Subscribers Fields に移動します。
  3. Create field をクリックし、次のようなフィールドを追加します:
    • total_spent (Number)
    • customer_since (Date)
    • subscription_plan (Text)
    • payment_method (Text)
    • last_payment_amount (Number)

​
トラブルシューティング

  • APIキーが正しく有効であることを確認します。
  • メールアドレスが有効であること（RFC 2821準拠）を確認します。
  • グループIDが正しいこと、かつアカウントに存在することを確認します。
  • 注意: 退会済み、バウンス、またはジャンクに分類された購読者はAPI経由で再アクティベートできません。
  • カスタムフィールドを使用する前にMailerLiteに存在することを確認します。
  • フィールド名が完全に一致していること（大文字小文字を区別）を確認します。
  • フィールド値が期待される型（テキスト、数値、日付）に一致していることを確認します。
  • MailerLite APIには1分あたり120件のレートリミットがあります。
  • 多数の購読者を処理する場合はバッチエンドポイントを使用します。
  • 高負荷シナリオではバックオフ戦略を実装します。
  • グループIDが数値文字列であることを確認します。
  • グループがMailerLiteアカウントに存在することを確認します。
  • 注意: グループを指定してPUTを使用すると、リストにないグループから購読者が削除されます。

​
APIリファレンス

MailerLite購読者APIは、次の主要なパラメータを受け入れます：
パラメータータイプ必須説明
emailstringYes有効なメールアドレス（RFC 2821）
fieldsobjectNoフィールド名/値のペアを持つオブジェクト
fields.namestringNo購読者の名
fields.last_namestringNo購読者の姓
fields.companystringNo会社名
fields.countrystringNo国
fields.citystringNo市区町村
fields.phonestringNo電話番号
groupsarrayNo購読者を追加するグループIDの配列
statusstringNo次のいずれか: active, unsubscribed, unconfirmed, bounced, junk
subscribed_atstringNo形式 yyyy-MM-dd HH:mm:ss の日付
ip_addressstringNo購読者のIPアドレス
完全なAPIドキュメントについては、MailerLite Developersを訪問してください。