一、指令概述
通过钉钉 Webhook 机器人，将本地文件上传至钉钉存储后，支持 Markdown 格式的消息形式发送到指定钉钉群聊，适用于群内资料同步、通知推送等场景，可提升文件与消息结合的传播效率。
二、调用参数配置
| 参数名称 | 配置说明 | 约束规则 |
|---|---|---|
| Webhook | 钉钉群机器人的 Webhook 连接地址，用于定位目标群聊 | 必填；需在钉钉群机器人配置页面获取 |
| 加签 | 钉钉群机器人的 Webhook 加签密钥，用于接口请求校验 | 必填 |
| 消息标题 | 推送消息的标题，用于快速识别内容主题 | 必填 |
| 消息内容 | 推送消息的正文，支持 Markdown 格式排版 | 必填；可包含文本、链接、列表等格式，用于补充说明文件信息 |
| 文件 | 待发送的本地文件，可通过 “选择文件” 按钮选取 | 必填；需确保文件存在且具备读取权限，大小不超过钉钉存储限制 |
| 开发平台凭证 | 钉钉开放平台访问凭证，用于文件上传接口认证 | 必填；可通过 “获取开发平台凭证” 指令获取，需确保凭证在有效期内 |
| 文件夹 Id | 文件上传的目标钉钉存储文件夹 ID，0 表示用户存储空间根目录 | 必填；可通过 “获取钉钉存储的文件夹列表” 指令获取 |
| 用户 Id | 发送人的用户 ID，为一串随机字母 | 必填；可通过 “获取用户详细信息” 指令获取 |
| @成员（高级） | 需 @的成员手机号码，多成员用分号分隔 | 选填；仅需提醒特定成员时使用 |
| @所有人（高级） | 勾选后消息将 @群内所有成员 | 选填；仅需全员提醒时使用 |
三、输出说明
四、典型操作示例
示例 1：发送项目报表并 @相关成员
- 配置 “Webhook”：填入目标群机器人的 Webhook 地址；
- 配置 “加签”：若机器人开启加签，填入对应密钥；
- 配置 “消息标题”：输入 “【项目周报】12 月第 1 周进度”；
- 配置 “消息内容”：用 Markdown 格式编写正文，如
> 本周完成需求开发，详见附件报表； - 配置 “文件”：点击 “选择文件” 按钮，选取本地文件
D:\项目周报.xlsx； - 配置 “开发平台凭证”：通过 “获取开发平台凭证” 指令获取并填入；
- 配置 “文件夹 Id”：填入目标文件夹 Id（如
0）； - 配置 “用户 Id”：填入发送人的用户 Id；
- 配置 “@成员”：输入需提醒的成员手机号（如
138xxxx1234;139xxxx5678）； - 执行指令后，文件将上传至钉钉存储，将消息发送到目标群并 @指定成员。
六、注意事项
- 参数配置约束：Webhook、开发平台凭证、文件夹 Id、用户 Id 均为必填项，需确保格式与来源准确；凭证过期需重新获取；
- 权限相关：若提示 “无权限”，需检查机器人配置权限、文件夹上传权限，或联系管理员配置钉钉开放平台接口权限；
- 操作权限：需具备钉钉群机器人的配置权限、钉钉开放平台接口调用权限；用户 Id 对应的账号需拥有目标文件夹的上传权限；
配置注意事项：
操作步骤（可参考的链接 创建自定义机器人 ）
- 登录钉钉客户端，选择需要添加机器人的群聊会话。
- 进入群聊会话，单击右上角群设置标识。
- 在群管理栏，单击机器人 > 添加机器人，选择自定义机器人。
- 单击添加，配置机器人信息：配置项说明机器人头像单击编辑标识，上传机器人头像。机器人名字添加机器人名称安全设置安全设置类型：自定义关键词加签IP 地址（段）安全设置详情参考自定义机器人安全设置。（可选）是否开启 Outgoing 机制通过 @ 群机器人，将消息发送到指定外部服务，还可以将外部服务的响应结果返回到群聊会话。机器人接收消息类型和数据格式，详情参考机器人接收消息。