Microsoft Teams

はじめに

Microsoft Teams integration は Dodo Payments のイベントを Adaptive Cards として Teams チャネルに投稿するため、チームは支払い、サブスクリプションの変更、dispute を発生時に確認できます。Teams をビジネスチームの業務場所として利用している場合に使用してください。

このガイドでは、Microsoft Teams ワークスペースで webhook を作成するための管理者アクセス権があることを前提としています。

始め方

Open the Webhook Section

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

Add endpoint dialog with Teams selected in the Integration dropdown

Select Microsoft Teams

Integration リストで Teams を選択します。

Create Teams Webhook

Microsoft は Teams の Office 365 Incoming Webhook connectors を廃止したため、Workflows app を使用して webhook を作成します。

Teams で、通知を受信するチャネルを開きます。
チャネル名の横にある ⋯ をクリックし、Workflows を選択します。
Post to a channel when a webhook request is received テンプレートを選択します。
team とチャネルを確認し、Add workflow をクリックします。
Teams に表示される webhook URL をコピーします。

Paste Webhook URL

Teams webhook URL を Endpoint URL フィールドに貼り付けます。

Customize Transformation

Transformation code の下にあるコードを編集し、各イベントを Adaptive Card としてフォーマットします。以下の例を参考にしてください。

Test & Create

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

Done

Teams チャネルで Dodo Payments のイベントを Adaptive Cards として受信できるようになります。

Transformation Code Examples

各例では、event payload を 1 つの Adaptive Card attachment を含む Teams message に置き換えます。

Basic Payment Card

この例では、支払いが成功した際に amount、customer email、payment ID を投稿します。

payment_card.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      type: "message",
      attachments: [{
        contentType: "application/vnd.microsoft.card.adaptive",
        content: {
          type: "AdaptiveCard",
          body: [
            {
              type: "TextBlock",
              text: "✅ Payment Successful",
              weight: "Bolder",
              size: "Medium"
            },
            {
              type: "FactSet",
              facts: [
                { title: "Amount", value: `$${(p.total_amount / 100).toFixed(2)}` },
                { title: "Customer", value: p.customer.email },
                { title: "Payment ID", value: p.payment_id }
              ]
            }
          ]
        }
      }]
    };
  }
  return webhook;
}

Subscription Management

この例では、subscription が active になったときに 1 つの card を投稿し、cancelled になったときに別の card を投稿します。

subscription_card.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        type: "message",
        attachments: [{
          contentType: "application/vnd.microsoft.card.adaptive",
          content: {
            type: "AdaptiveCard",
            body: [
              {
                type: "TextBlock",
                text: "📄 Subscription Activated",
                weight: "Bolder",
                color: "Good"
              },
              {
                type: "FactSet",
                facts: [
                  { title: "Customer", value: s.customer.email },
                  { title: "Product", value: s.product_id },
                  { title: "Amount", value: `$${(s.recurring_pre_tax_amount / 100).toFixed(2)}/${s.payment_frequency_interval}` },
                  { title: "Next Billing", value: new Date(s.next_billing_date).toLocaleDateString() }
                ]
              }
            ]
          }
        }]
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        type: "message",
        attachments: [{
          contentType: "application/vnd.microsoft.card.adaptive",
          content: {
            type: "AdaptiveCard",
            body: [
              {
                type: "TextBlock",
                text: "⚠️ Subscription Cancelled",
                weight: "Bolder",
                color: "Warning"
              },
              {
                type: "FactSet",
                facts: [
                  { title: "Customer", value: s.customer.email },
                  { title: "Product", value: s.product_id },
                  { title: "Cancelled At", value: new Date(s.cancelled_at).toLocaleDateString() }
                ]
              }
            ]
          }
        }]
      };
      break;
  }
  return webhook;
}

Dispute Alerts

この例では、すべての dispute.* event に対して card を投稿します。dispute の結果が勝訴または敗訴になると、title と color が変わります。

dispute_card.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    const color = d.dispute_status === "dispute_won" ? "Good" : d.dispute_status === "dispute_lost" ? "Attention" : "Warning";
    const title = d.dispute_status === "dispute_won" ? "🏆 Dispute Won" : d.dispute_status === "dispute_lost" ? "❌ Dispute Lost" : "🚨 Dispute Update";
    
    webhook.payload = {
      type: "message",
      attachments: [{
        contentType: "application/vnd.microsoft.card.adaptive",
        content: {
          type: "AdaptiveCard",
          body: [
            {
              type: "TextBlock",
              text: title,
              weight: "Bolder",
              color: color
            },
            {
              type: "FactSet",
              facts: [
                { title: "Payment ID", value: d.payment_id },
                { title: "Amount", value: `$${(d.amount / 100).toFixed(2)}` },
                { title: "Status", value: d.dispute_status },
                { title: "Stage", value: d.dispute_stage }
              ]
            }
          ]
        }
      }]
    };
  }
  return webhook;
}

Tips

リッチでインタラクティブなフォーマットには Adaptive Cards を使用します。
意味に応じて色を選択します：Good（green）、Warning（yellow）、Attention（red）。
fact sets は短く、読みやすく保ちます。
endpoint を実際に使用する前に、その Testing タブを開き、Send example をクリックしてサンプル card をチャネルに投稿します。

Troubleshooting

No Messages in Teams

webhook URL が正しく、workflow が有効になっていることを確認します。
transformation が有効な Adaptive Card JSON を返すことを確認します。
workflow にチャネルへの投稿権限があることを確認します。

Card Formatting Issues

Test this code で transformation を実行し、結果を Adaptive Card schema と照合します。
必須フィールドがすべて存在することを確認します。
color values が有効であることを確認します。例：Default、Good、Warning、Attention。

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

はじめに

始め方

Transformation Code Examples

Basic Payment Card

Subscription Management

Dispute Alerts

Tips

Troubleshooting

​はじめに

​始め方

​Transformation Code Examples

​Basic Payment Card

​Subscription Management

​Dispute Alerts

​Tips

​Troubleshooting

はじめに

始め方

Transformation Code Examples

Basic Payment Card

Subscription Management

Dispute Alerts

Tips

Troubleshooting