Microsoft Teams

介绍

Microsoft Teams 集成会将 Dodo Payments 事件以 Adaptive Cards 的形式发布到 Teams 频道，让团队实时查看支付、订阅变更和争议。如果 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

在集成列表中，选择 Teams。

Create Teams Webhook

Microsoft 已在 Teams 中停用 Office 365 的 Incoming Webhook 连接器，因此请使用 Workflows 应用创建 webhook：

在 Teams 中打开要接收通知的频道。
点击频道名称旁的 ⋯，然后选择 Workflows。
选择模板 收到 webhook 请求时发布到频道。
确认团队和频道，然后点击 添加工作流。
复制 Teams 显示的 webhook URL。

Paste Webhook URL

将 Teams webhook URL 粘贴到 端点 URL 字段中。

Customize Transformation

编辑 转换代码 下的代码，将每个事件格式化为 Adaptive Card。请从以下示例开始。

Test & Create

在 测试此代码 下，使用示例 payload 运行转换，然后点击 创建端点。

Done

现在，你的 Teams 频道会以 Adaptive Cards 的形式接收 Dodo Payments 事件。

转换代码示例

每个示例都会将事件 payload 替换为一条包含一个 Adaptive Card 附件的 Teams 消息。

基本支付卡片

此示例会在支付成功时发布金额、客户电子邮件和支付 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_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.* 事件发布一张卡片。当争议获胜或失败时，标题和颜色会随之变化。

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;
}

提示

使用 Adaptive Cards 实现丰富的交互式格式。
根据含义选择颜色：Good（绿色）、Warning（黄色）和 Attention（红色）。
保持事实集简短易读。
在依赖此端点之前，打开其测试标签页，然后点击 发送示例，将示例卡片发布到你的频道。

故障排除

No Messages in Teams

检查 webhook URL 是否正确，以及工作流是否已启用。
检查转换是否返回有效的 Adaptive Card JSON。
检查工作流是否有权在该频道中发布消息。

Card Formatting Issues

在 测试此代码 下运行转换，并根据 Adaptive Card schema 检查结果。
检查所有必需字段是否存在。
检查颜色值是否有效，例如 Default、Good、Warning 或 Attention。

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

介绍

开始使用

转换代码示例

基本支付卡片

订阅管理

争议提醒

提示

故障排除

​介绍

​开始使用

​转换代码示例

​基本支付卡片

​订阅管理

​争议提醒

​提示

​故障排除

介绍

开始使用

转换代码示例

基本支付卡片

订阅管理

争议提醒

提示

故障排除