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

はじめに

AutoSendとDodo Paymentsの統合により、成功した取引から失敗した試行、返金確認まで、すべての支払いイベントに対してリアルタイムのメール通知を自動的に送信できます。 AutoSendの強力なメールAPIを使用して、支払いイベントのトランザクションメールを送信します。
この統合には、認証のためにAutoSend APIキーが必要です。APIキーは、AutoSendダッシュボードの設定 > APIキーの下にあります。

始め方

AutoSendをDodo Paymentsに統合するための手順は次のとおりです。
1

Webhookセクションを開く

Dodo PaymentsダッシュボードのWebhookセクションに移動します。
エンドポイントと統合のドロップダウンを追加
2

AutoSend統合を選択

利用可能な統合のリストからAutoSendを選択します。
3

APIキーを入力

認証のためにAutoSend APIキーを提供します。APIキーは、AutoSendダッシュボードの設定 > APIキーの下にあります。

APIキーの作成と管理方法を学ぶ

APIキーの作成と管理に関する詳細な手順は、AutoSendのドキュメントを参照してください。
4

変換を設定

支払いイベントに基づいてメールコンテンツをカスタマイズするために、JavaScript変換ハンドラーを設定します。
5

テストと作成

Webhook設定をテストして、メールが正しく送信されることを確認し、その後統合を作成します。
6

アクティベーション完了

🎉 あなたのAutoSend統合は現在アクティブで、設定された支払いイベントに対して自動的にメールを送信します。

コード例

支払い確認メール

支払いが正常に処理されたときに確認メールを送信します:
payment_confirmation.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "[email protected]",
        name: "Your Company",
      },
      subject: "Payment Successful - Thank you for your purchase!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        paymentId: p.payment_id,
        paymentDate: new Date(p.created_at).toLocaleDateString(),
      },
      replyTo: {
        email: "[email protected]",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

サブスクリプション歓迎メール

新しいサブスクリプションが作成されたときに歓迎メールを送信します:
subscription_welcome.js
function handler(webhook) {
  if (webhook.eventType === "subscription.created") {
    const s = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: s.customer.email,
        name: s.customer.name,
      },
      from: {
        email: "[email protected]",
        name: "Your Company",
      },
      subject: "Welcome to your subscription!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: s.customer.name,
        planName: s.plan.name,
        billingInterval: s.billing_interval,
        nextBillingDate: new Date(s.next_billing_at).toLocaleDateString(),
        subscriptionId: s.subscription_id,
      },
      replyTo: {
        email: "[email protected]",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

支払い失敗通知

支払いが失敗したときに通知メールを送信します:
payment_failure.js
function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "[email protected]",
        name: "Your Company Billing",
      },
      subject: "Payment Failed - Action Required",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        failureReason: p.failure_reason,
        paymentId: p.payment_id,
        retryUrl: `https://yourdomain.com/billing/retry/${p.payment_id}`,
      },
      replyTo: {
        email: "[email protected]",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

ベストプラクティス

  • 送信者ドメインを確認する: 送信者のメールドメインがAutoSendで確認されていることを確認し、配信率を向上させ、認証の問題を回避します。確認されたドメインは、メールがスパムフォルダに入るのを防ぐのに役立ちます。
  • パーソナライズのために動的データを使用する: dynamicDataフィールドを使用して、顧客固有の情報(名前、支払い金額、サブスクリプションの詳細など)でメールをパーソナライズします。パーソナライズされたメールは、エンゲージメント率が高くなります。
  • 明確な件名を書く: メールの目的を明確に示す説明的な件名を書く。スパムトリガーワードを避け、件名は簡潔に(50文字以内)保ちます。
  • 本番前にテストする: 本番環境で送信する前に、必ずメールをテストします。これにより、メールコンテンツが正しく表示され、すべての動的データが適切にマッピングされていることが確認できます。

APIリファレンス

AutoSend APIの完全な詳細、すべての利用可能なパラメータおよびエラーコードについては、AutoSend APIドキュメントを訪問してください。

トラブルシューティング

  • APIキーが正しくアクティブであることを確認
  • 送信者ドメインがAutoSendで確認されていることを確認
  • 受信者のメールアドレスが有効であることを確認
  • AutoSendの送信制限とクォータを確認
  • APIエンドポイントURLが正しいことを確認: https://api.autosend.com/v1/mails/send
  • ペイロードに必要なパラメータが含まれていることを確認
  • JSON構造がAutoSend APIフォーマットに一致していることを確認
  • すべての必須フィールドが存在することを確認(to, from, templateIdまたはhtml/text)
  • メールアドレスが正しくフォーマットされていることを確認
  • テンプレートを使用している場合、templateIdが有効であることを確認
  • dynamicDataキーがテンプレート変数と一致していることを確認
  • テンプレートIDが正しくアクティブであることを確認
  • dynamicDataキーがテンプレートで使用されている変数と一致していることを確認
  • すべての必須テンプレート変数が提供されていることを確認
  • AutoSendダッシュボードでテンプレートを独立してテスト