如何让Graph API POST发送的Teams频道消息附件可在Teams内正常预览

云原生阿岚

2026-10-8

问题根因

你直接使用SharePoint列表项附件的原始绝对路径作为contentUrl时，Teams内置文件预览器无法识别该类路径格式，必须使用附件对应底层SharePoint driveItem的ID（即你提到的sourcedoc ID）作为附件ID，配合driveItem的标准webUrl构造请求，才能触发Teams内置预览。

解决步骤

步骤1：获取sourcedoc ID（driveItem ID）

SharePoint列表的每个附件本质上都对应站点 drive 中的一个独立driveItem资源，你可以通过如下Graph API接口获取该资源信息：
GET https://graph.microsoft.com/v1.0/sites/{站点ID}/lists/{列表ID}/items/{列表项ID}/attachments/{附件ID}/driveItem
接口返回结果中的id字段就是你需要的sourcedoc ID，同时还能拿到webUrl、@microsoft.graph.downloadUrl、name等后续要用到的字段。

步骤2：构造符合Teams预览要求的Graph API请求体

调用POST /teams/{team-id}/channels/{channel-id}/messages接口时，attachments字段按如下格式构造：

{
  "body": {
    "contentType": "html",
    "content": "你要发送的消息内容"
  },
  "attachments": [
    {
      "@odata.type": "#microsoft.graph.chatMessageAttachment",
      "id": "{上一步获取的driveItem ID}",
      "contentType": "reference",
      "contentUrl": "{driveItem对应的webUrl字段值}",
      "name": "{文件名，例如报表.docx}",
      "content": "{\"@microsoft.graph.downloadUrl\":\"{driveItem对应的@microsoft.graph.downloadUrl字段值}\"}"
    }
  ]
}