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
相关产品推荐
相关产品推荐

