钉钉群机器人发送文件消息提示“不支持该类型”，通常是因为使用了 Webhook 方式发送文件，Webhook 接口本身不支持文件、图片、语音和视频类型，必须切换至服务端 API 接口发送。
先说结论：该报错源于发送渠道能力限制，Webhook 仅支持文本和链接类消息，发送文件需改用服务端 API 并预先上传文件获取 mediaId。
- 先确认：检查当前代码使用的是 Webhook 地址还是服务端 API 接口。
- 先处理：调用文件上传接口获取 mediaId，再通过群消息发送接口推送。
- 再验证：查看 API 返回码是否为成功，并在钉钉客户端确认文件可下载。
快速处理思路
若业务场景必须发送文件，需放弃 Webhook 方式，转为使用钉钉开放平台的服务端 API。核心流程分为两步：先调用媒体文件上传接口获得临时文件 ID，再调用机器人发送群消息接口将该 ID 嵌入消息体。此方案适合企业内部应用或第三方企业应用，自定义机器人需确认权限配置。
为什么会这样
钉钉机器人消息发送分为 Webhook 和 API 两种方式，两者支持的消息类型不同。Webhook 设计初衷为轻量级通知，仅支持 Text、Markdown、ActionCard、FeedCard 和 Link 类型，明确不支持 File、Image、Audio 和 Video 类型。服务端 API 拥有更完整的权限体系，支持全类型消息，但需要配置访问凭证和权限。
分步处理
第一步：确认应用类型与权限。登录钉钉开发者后台，确认应用为“企业内部应用”或“第三方企业应用”，并勾选“企业内机器人发送消息权限”。自定义机器人通常仅支持 Webhook，若需发文件建议升级为企业内部应用机器人。
第二步：上传文件获取 mediaId。调用上传媒体文件接口，将本地文件二进制流上传，接口返回 mediaId。注意文件类型需在支持列表内，包括 xlsx、pdf、zip、rar、doc、docx 格式。
第三步：调用发送群消息接口。使用 POST 请求访问https://api.dingtalk.com/v1.0/robot/groupMessages/send，请求头携带x-acs-dingtalk-access-token。请求体中 msgKey 设为对应文件模板 Key，msgParam 中填入第二步获取的 mediaId 及文件名。
第四步：处理异常返回。若返回错误码，检查 access_token 是否过期、mediaId 是否有效、接收群聊 ID 是否正确。确保机器人已在目标群聊中启用。
怎么验证是否生效
查看服务端 API 调用响应，HTTP 状态码应为 200 且业务代码表示成功。进入目标钉钉群聊，检查消息流中是否出现文件卡片，点击卡片能否正常下载或预览。若文件无法预览，检查文件格式是否为钉钉支持的办公文档类型。
常见坑
Webhook 误用：很多开源 SDK 默认配置 Webhook 地址，发送文件前需检查 SDK 配置项是否切换为 API 模式。文件类型限制：不支持 exe、apk 等可执行文件，仅支持办公文档和压缩包。mediaId 时效性：上传获取的 mediaId 有有效期，需尽快使用，过期需重新上传。频率限制：机器人发送消息有频率上限，每分钟最多 20 条，批量发送文件需做队列控制。
常见问题
Webhook 能发送图片吗？
不能，Webhook 方式不支持图片、文件、语音和视频类型，仅支持文本和链接类消息。
发送文件有大小限制吗？
公开资料中没有看到可靠的量化数据，但建议控制文件体积以保证上传速度和 mediaId 有效性，大文件建议使用钉盘链接。
自定义机器人支持发送文件吗？
不支持，自定义机器人仅支持 Webhook 方式，需创建企业内部应用机器人才能使用 API 发送文件。
参考来源
- 钉钉开放平台 - 消息发送与接收类型
- 钉钉开放平台 - 机器人发送群聊消息
- 钉钉开放平台 - 下载机器人接收消息的文件内容
- DingtalkChatbot 避坑指南：解决 90% 开发者会遇到的 5 个常见问题