You need to enable JavaScript to run this app. Python开发Microsoft Teams Bot实现聊天发送可下载PDF的方法
优惠活动
大模型
产品
解决方案
定价
更多

Python开发Microsoft Teams Bot实现聊天发送可下载PDF的方法

Teams 机器人发送可预览可下载PDF的改造实现

基础前提

你已经在manifest.json中开启"supportsFiles": true权限,无需额外申请配置,只需要替换现有代码中的缩略卡片发送逻辑即可实现目标效果。

两种可落地的实现方式

方式1:公网可访问PDF直链(最快捷)

这是Bot Framework SDK原生支持的最简实现,不需要额外的文件上传逻辑:

  • 构造标准文件附件对象,明确标记文件类型为PDF,填入公网可直接访问的PDF地址,以及聊天中显示的文件名
  • 用构造好的附件替换原代码里的缩略卡片对象,复用原有的消息发送逻辑即可

对应的代码替换:

# 替换原有的thumbnail_card方法,构造PDF附件
def build_pdf_attachment(self, pdf_public_url: str, display_file_name: str) -> Attachment:
    return Attachment(
        name=display_file_name,
        content_type="application/pdf",
        content_url=pdf_public_url
    )

修改消息判断分支的逻辑:

async def on_message_activity(self, turn_context: TurnContext):
    self._add_conversation_reference(turn_context.activity)
    # 优化原文本判断的容错,忽略大小写和前后空格
    if "send pdf" in turn_context.activity.text.strip().lower():
        # 传入你的实际PDF公网直链和显示名称
        pdf_attach = self.build_pdf_attachment(
            pdf_public_url="你的PDF公网直链地址",
            display_file_name="产品说明文档.pdf"
        )
        msg_activity = MessageFactory.attachment(pdf_attach)
        await turn_context.send_activity(msg_activity)
    else:
        return await turn_context.send_activity(
            f"You sent : {turn_context.activity.text}"
        )

注意:这里的公网直链必须是无跳转、无鉴权、可直接通过GET请求获取PDF二进制内容的地址,不能是需要登录的网页链接,否则Teams无法加载预览内容。

方式2:本地/私有存储PDF的上传发送

如果你的PDF文件存在本地服务器、私有内网存储,没有可公开访问的直链,可以通过SDK内置的附件上传能力完成发送:

  • 先读取本地PDF的二进制流,借助TurnContext获取当前会话的上传权限上下文
  • 调用SDK提供的分块上传接口,把PDF流上传到Teams聊天的临时文件存储,接口会返回可用于消息发送的临时文件地址
  • 把这个临时地址填入前面build_pdf_attachment方法的参数中,按照相同的逻辑构造消息发送即可

效果校验

按照以上逻辑发送消息后,Teams客户端会自动识别PDF类型的附件,渲染为内置可交互的预览卡片:

  • 用户不需要离开聊天窗口,就能直接翻看PDF所有页面
  • 卡片自带下载入口,支持用户把PDF文件保存到本地

常见踩坑提醒

  • 不要把PDF地址做成自适应卡片的跳转按钮,这种形式只会在浏览器打开PDF,无法实现聊天内直接预览,必须按照标准附件格式构造消息Activity
  • 附件的content_type必须严格设置为application/pdf,如果填写错误,Teams会把链接识别为普通文本,不会触发预览渲染
  • 附件名称必须带.pdf后缀,否则低版本Teams客户端可能无法正确识别文件类型

内容的提问来源于stack exchange,提问作者Kalakutas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 21:24:04