はじめに
AutoSendとDodo Paymentsの統合により、成功した取引から失敗した試行、返金確認まで、すべての支払いイベントに対してリアルタイムのメール通知を自動的に送信できます。
AutoSendの強力なメールAPIを使用して、支払いイベントのトランザクションメールを送信します。
この統合には、認証のためにAutoSend APIキーが必要です。APIキーは、AutoSendダッシュボードの設定 > APIキーの下にあります。
始め方
AutoSendをDodo Paymentsに統合するための手順は次のとおりです。
Webhookセクションを開く
Dodo PaymentsダッシュボードのWebhookセクションに移動します。 AutoSend統合を選択
利用可能な統合のリストからAutoSendを選択します。
変換を設定
支払いイベントに基づいてメールコンテンツをカスタマイズするために、JavaScript変換ハンドラーを設定します。
テストと作成
Webhook設定をテストして、メールが正しく送信されることを確認し、その後統合を作成します。
アクティベーション完了
🎉 あなたのAutoSend統合は現在アクティブで、設定された支払いイベントに対して自動的にメールを送信します。
コード例
支払い確認メール
支払いが正常に処理されたときに確認メールを送信します：
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: "payments@mail.yourdomain.com",
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: "support@yourdomain.com",
name: "Support Team",
},
};
}
return webhook;
}
サブスクリプション歓迎メール
新しいサブスクリプションが作成されたときに歓迎メールを送信します：
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: "subscriptions@mail.yourdomain.com",
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: "support@yourdomain.com",
name: "Support Team",
},
};
}
return webhook;
}
支払い失敗通知
支払いが失敗したときに通知メールを送信します：
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: "billing@mail.yourdomain.com",
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: "billing@yourdomain.com",
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が正しく、AutoSendでアクティブであることを確認
dynamicData キーがテンプレートで使用されている変数と一致していることを確認- すべての必須テンプレート変数が提供されていることを確認
- AutoSendダッシュボードでテンプレートを独立してテスト
