PAYATHON 2026

C# 通过 Webhook 向 Teams 频道发送简单消息失败

数据小陈

第二段在 Teams 中不显示,最可能是 JSON 结构不合法,或者把 MessageCard 和 AdaptiveCard 混用了。202 Accepted 只说明请求被接收,不代表 Teams 已经渲染卡片。Microsoft.VisualStudio.Copilot.Core ... Requested model not available for session 是 Visual Studio Copilot 的日志,不是 Teams webhook 的响应,不能用它判断 webhook 是否成功。如果只想发一条简单消息,可以先试最小 MessageCard,或者用只包含一个 TextBlock 的最小 AdaptiveCard。

原因

  • MessageCard 的常见 schema 使用 @type、@context 和小写 sections。第二段写成了 type、context、Sections,还在 section 里混入了 AdaptiveCard 的 body 字段,解析时容易失败。
  • 第二段 JSON 片段还存在尾逗号和括号不完整的风险。卡片无效时,Teams 可能直接丢弃,不会报错。
  • 202 不能保证渲染成功,需要读取 response.Content.ReadAsStringAsync() 的响应体来确认。
  • Incoming Webhook/Connector 和 Power Automate Workflow 的 URL、payload 不一样,不能混用。

解决步骤

  1. 先打印状态码和响应体,确认 webhook 返回了什么。
  2. 用合法的最小 MessageCard 做测试,确保没有尾逗号,属性名大小写正确。
  3. 只选一种卡片格式:MessageCard 使用 @type/@context/sections;AdaptiveCard 使用 type/version/body,并放在 attachments 里。
  4. 确认 webhook 来源和租户策略。如果 Connectors 已停用,或频道有限制,就改用 Teams Workflows。
  5. 用 Workflow 时,按 Workflow 模板的 JSON 结构发送,不要直接套用 Incoming Webhook 的 MessageCard。

代码示例:最小 MessageCard

{
  "@type": "MessageCard",
  "@context": "http://schema.org/extensions",
  "summary": "Test Result",
  "themeColor": "007607",
  "title": "This is a test title",
  "text": "This is a test"
}

C# 发送并读取响应:

using System.Net.Http;
using System.Text;

var messageJson = /* 替换为上面的完整 JSON 字符串 */;
using var client = new HttpClient();
using var content = new StringContent(messageJson, Encoding.UTF8, "application/json");
using var response = await client.PostAsync(webhookUrl, content);
var responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine($"HTTP {(int)response.StatusCode}: {responseBody}");

如果继续用 AdaptiveCard 发简单消息,最小结构可参考:

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "type": "AdaptiveCard",
        "version": "1.0",
        "body": [
          { "type": "TextBlock", "text": "This is a test", "wrap": true }
        ]
      }
    }
  ]
}

注意事项

属性名区分大小写;不要保留尾逗号;不要混用 MessageCard 和 AdaptiveCard 字段;202 不代表渲染成功;Copilot 的 400 日志和 Teams webhook 无关;如果 webhook 来自 Workflow,或 Connectors 已停用,按对应平台调整 payload。

备注:内容仅供参考。