Teams机器人发送频道消息时提及标签能否通过Bot Framework实现

架构老林

2026-10-1

Bot Framework实现Teams消息标签提及方案

完全可以通过Bot Framework实现该需求，只需调整发送的Activity payload即可，逻辑和你当前使用的Graph API payload高度兼容。

具体实现步骤

首先确认你已经通过Graph API获取到目标团队内对应标签的有效ID、显示名称，这部分的获取逻辑不需要改动。
构造发送到Teams的Activity对象时，按如下规则配置：
1. 将textFormat属性设置为html，保证带标签的内容可以正常解析
2. 在text属性中填入带<at id="对应提及ID">标签显示名</at>的HTML内容，和你之前Graph payload里的content字段内容一致
3. 在entities数组中添加类型为mention的实体，结构和你之前Graph的mentions数组项完全对齐即可

参考Activity payload示例

{
  "type": "message",
  "text": "<div>New incident ##### assigned to <at id=\"0\">App operations</at></div>",
  "textFormat": "html",
  "entities": [
    {
      "type": "mention",
      "id": 0,
      "mentionText": "App operations",
      "mentioned": {
        "tag": {
          "id": "你提前获取到的标签ID",
          "displayName": "App operations"
        }
      }
    }
  ]
}