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

​
はじめに

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

​
始め方

1

Webhookセクションを開く

Dodo Paymentsダッシュボードで、Webhooks + Add Endpointに移動し、統合のドロップダウンを展開します。
Add Endpoint and integrations dropdown
2

MailerLiteを選択

MailerLite統合カードを選択します。
3

APIキーを入力

設定にMailerLite APIキーを提供します。
4

変換を設定

MailerLiteのAPI用に購読者データをフォーマットするために変換コードを編集します。
5

テストと作成

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

完了！

支払いイベントは、今後自動的に顧客をあなたの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 (番号)
    • customer_since (日付)
    • subscription_plan (テキスト)
    • payment_method (テキスト)
    • last_payment_amount (番号)

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

  • APIキーが正しくアクティブであることを確認してください
  • メールアドレスが有効であることを確認してください（RFC 2821準拠）
  • グループIDが正しく、アカウントに存在することを確認してください
  • 注：購読解除、バウンス、または迷惑メールの購読者はAPIを介して再活性化できません
  • 使用する前にMailerLiteにカスタムフィールドが存在することを確認してください
  • フィールド名が正確に一致することを確認してください（大文字と小文字を区別）
  • フィールド値が期待されるタイプ（テキスト、番号、日付）と一致することを確認してください
  • MailerLite APIのレート制限は、1分あたり120リクエストです
  • 多くの購読者を処理する場合はバッチエンドポイントを使用してください
  • 高ボリュームのシナリオではバックオフ戦略を実装してください
  • グループIDが数値の文字列であることを確認してください
  • MailerLiteアカウントにグループが存在することを確認してください
  • 注：グループを使用してPUTを行うと、リストにないグループから購読者が削除されます

​
APIリファレンス

MailerLite購読者APIは、次の主要なパラメータを受け入れます：
パラメータ型必須説明
emailstringはい有効なメールアドレス（RFC 2821）
fieldsobjectいいえフィールド名/値ペアを持つオブジェクト
fields.namestringいいえ購読者の名
fields.last_namestringいいえ購読者の姓
fields.companystringいいえ会社名
fields.countrystringいいえ国
fields.citystringいいえ市
fields.phonestringいいえ電話番号
groupsarrayいいえ購読者を追加するグループIDの配列
statusstringいいえ次のいずれか：active、unsubscribed、unconfirmed、bounced、junk
subscribed_atstringいいえフォーマットyyyy-MM-dd HH:mm:ssの日付
ip_addressstringいいえ購読者のIPアドレス
完全なAPIドキュメントについては、MailerLite Developersを訪問してください。