はじめに
Dodo PaymentsをZapierを通じて数千のアプリやサービスに接続します。支払いイベントが発生したときにZapsをトリガーすることで、ワークフローを自動化し、メールの送信からスプレッドシートの更新、タスクの作成など、さまざまな作業を行うことができます。
この統合には、Zap の構成から Zapier の webhook URL が必要です。
始め方
Open the Webhook Section
Dodo Payments ダッシュボードで Webhooks → + Add Endpoint に移動し、統合のドロップダウンを展開します。 Select Zapier
Zapier 統合カードを選択します。
Create Zap in Zapier
Zapier で「Webhooks by Zapier」をトリガーとして新しい Zap を作成し、webhook URL をコピーします。
Paste Webhook URL
Zapier の webhook URL をエンドポイント構成に貼り付けます。
Configure Transformation
変換コードを編集して Zapier ワークフロー用にデータを整形します。
Test & Create
サンプルのペイロードでテストし、Create をクリックして統合を有効にします。
Done!
🎉 支払いイベントで Zapier ワークフローが自動的にトリガーされるようになります。
変換コードの例
基本的なウェブフックペイロード
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.payload = {
event_type: webhook.eventType,
payment_id: p.payment_id,
amount: (p.total_amount / 100).toFixed(2),
currency: p.currency || "USD",
customer_email: p.customer.email,
customer_name: p.customer.name,
payment_method: p.payment_method || "unknown",
timestamp: webhook.payload.timestamp
};
}
return webhook;
}
サブスクリプションイベントハンドラー
function handler(webhook) {
const s = webhook.payload.data;
switch (webhook.eventType) {
case "subscription.active":
webhook.payload = {
event_type: "subscription_started",
subscription_id: s.subscription_id,
customer_email: s.customer.email,
customer_name: s.customer.name,
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,
timestamp: webhook.payload.timestamp
};
break;
case "subscription.cancelled":
webhook.payload = {
event_type: "subscription_cancelled",
subscription_id: s.subscription_id,
customer_email: s.customer.email,
cancelled_at: s.cancelled_at,
cancel_at_next_billing: s.cancel_at_next_billing_date,
timestamp: webhook.payload.timestamp
};
break;
}
return webhook;
}
争議アラートハンドラー
function handler(webhook) {
if (webhook.eventType.startsWith("dispute.")) {
const d = webhook.payload.data;
webhook.payload = {
event_type: webhook.eventType,
dispute_id: d.dispute_id,
payment_id: d.payment_id,
amount: (d.amount / 100).toFixed(2),
status: d.dispute_status,
stage: d.dispute_stage,
remarks: d.remarks || "",
urgent: webhook.eventType === "dispute.opened",
timestamp: webhook.payload.timestamp
};
}
return webhook;
}
人気のZapierユースケース
- Gmail/Outlook から支払い確認メールを送信
- Mailchimp/ConvertKit でメールシーケンスを作成
- Slack/Discord 通知を送信
- Google Sheets に記録を作成
- HubSpot/Salesforce に連絡先を追加
- Pipedrive/Close で案件を作成
- Airtable で顧客レコードを更新
- Monday.com にアクティビティを記録
- Asana/Trello でタスクを作成
- Notion に ToDo を追加
- カレンダーイベントを作成
- Twilio 経由で SMS 通知を送信
ヒント
- Zapierの解析を容易にするためにペイロード構造をシンプルに保つ
- すべてのイベントで一貫したフィールド名を使用する
- ワークフローのタイミングのためにタイムスタンプを含める
- 本番環境に移行する前にサンプルデータでZapをテストする
- 条件付きロジックのためにZapierの組み込みフィルターを使用する
トラブルシューティング
- webhook URL が正しくアクティブであることを確認
- Zapier で Zap がオンになっていることを確認
- ペイロード構造が Zapier の期待に沿っていることを確認
- Zapier ダッシュボードで webhook 配信をテスト
Data not mapping correctly
- Zapier アクションステップのフィールド名を確認
- データ型が期待される形式と一致していることを確認
- Zapier のテスト機能でマッピングをデバッグ
- 変換コードが有効な JSON を返すことを確認
