ループ

はじめに

Loops integrationはDodo PaymentsのイベントをLoops eventsに変換するため、支払い確認、サブスクリプションの更新、支払い失敗通知をLoops emailsとして送信できます。Transformationによって各payment eventがLoops eventにマッピングされ、そのeventがLoopsで対応するworkflowをトリガーします。

Loops API keyが必要です。Loopsで Settings → API に移動し、keyを生成します。

始め方

Open the Webhook Section

Dodo Payments ダッシュボードで、Developer → Webhooks に移動し、Add endpoint をクリックします。

Integration ドロップダウンで Loops が選択された Add endpoint ダイアログ

Select Loops

Integration listで Loops を選択します。

Enter API Key

Loops API keyを API key fieldに貼り付けます。Dodo PaymentsはすべてのdeliveryでAuthorization headerとして送信します。integrationがdestination URLを設定するため、入力する値はkeyのみです。

Configure Transformation

Transformation code の下にあるcodeを編集し、各eventをLoops eventに変換します。以下の例を参考にしてください。Subscribed events で、codeが処理するeventsを選択します。

Test & Create

Test this code でsample payloadに対してtransformationを実行し、Create endpoint をクリックします。

Done

これでpayment eventsがLoops経由でemailsをトリガーします。

変換コードの例

各例では、1つのevent typeをLoopsのSend an Event APIのbodyに書き換えます。bodyには、eventName、contactのemail、そしてLoops emailsで使用できるeventPropertiesが含まれます。

支払い確認メール

この例では、支払いが成功したときにpayment_confirmation eventを送信します。

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_confirmation",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        currency: p.currency || "USD",
        payment_method: p.payment_method || "unknown",
        payment_date: new Date(webhook.payload.timestamp).toLocaleDateString()
      }
    };
  }
  return webhook;
}

サブスクリプションのウェルカムメール

この例では、サブスクリプションがactiveになったときにsubscription_welcome eventを送信します。

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "subscription_welcome",
      email: s.customer.email,
      eventProperties: {
        customer_name: s.customer.name,
        subscription_id: s.subscription_id,
        product_id: s.product_id,
        amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
        frequency: s.payment_frequency_interval,
        next_billing: s.next_billing_date
      }
    };
  }
  return webhook;
}

支払い失敗通知

この例では、error messageとretry linkを含むpayment_failed eventを送信します。yourdomain.comを独自のdomainに置き換えてください。

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_failed",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        error_message: p.error_message || "Payment processing failed",
        retry_link: `https://yourdomain.com/retry-payment/${p.payment_id}`
      }
    };
  }
  return webhook;
}

ヒント

各eventにpayment_confirmationなどのわかりやすい名前を付け、Loops emailsを整理しやすくします。
emailsでpersonalizationに使用するcustomer propertiesを含めます。
Loopsで、送信する各event nameに対応するworkflowとemailを設定します。
events全体で同じproperty namesを使用します。
本番稼働前にemail deliveryをテストします。

トラブルシューティング

Emails Not Being Sent

API keyが正しく、有効であることを確認します。
各event nameが、Loops workflowをトリガーするeventと一致していることを確認します。
recipient email addressesが有効であることを確認します。
Loopsのsending limitsとquotasを確認します。

Transformation Errors

payloadがLoops API formatに一致していることを確認します。必要なのはeventNameと、emailまたはuserIdです。
必須fieldsがすべて存在することを確認します。
event namesが正しくフォーマットされていることを確認します。
各event propertyにstring、number、boolean、またはdate valueを指定します。
API keyのpermissionsを確認します。

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

はじめに

始め方

変換コードの例

支払い確認メール

サブスクリプションのウェルカムメール

支払い失敗通知

ヒント

トラブルシューティング

​はじめに

​始め方

​変換コードの例

​支払い確認メール

​サブスクリプションのウェルカムメール

​支払い失敗通知

​ヒント

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

はじめに

始め方

変換コードの例

支払い確認メール

サブスクリプションのウェルカムメール

支払い失敗通知

ヒント

トラブルシューティング