Microsoft Teams传入Webhook接收卡片为空问题求助

问题核心是Teams传入Webhook不接受纯Adaptive Cards JSON，必须把卡片嵌套在Teams指定的消息容器结构里，直接发送设计器生成的纯卡片会被系统忽略，导致显示为空。

错误与正确做法对比 #

• 错误：直接发送Adaptive Cards设计器生成的纯卡片JSON
• 正确：将卡片放入attachments数组，并指定对应内容类型

正确JSON结构示例 #

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        // 此处粘贴Adaptive Cards设计器生成的卡片JSON
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
          {
            "type": "TextBlock",
            "text": "测试卡片内容",
            "size": "large"
          }
        ]
      }
    }
  ]
}

关键注意事项 #

• 必须保留外层type: "message"字段，这是Teams识别消息的必要标识
• attachments内的卡片必须指定contentType为application/vnd.microsoft.card.adaptive，否则Teams无法解析
• 确保Adaptive卡片的version在Teams支持范围内（1.0-1.6版本均兼容）
• 请求需用POST方法，且设置请求头Content-Type: application/json

你之前使用微软文档示例能正常工作，就是因为示例已经套好了Teams要求的外层消息结构，而Adaptive Cards设计器仅输出卡片本身，缺少必要的容器包装。

内容的提问来源于stack exchange，提问作者user22715125