一、指令概述
用于将本地文件上传至钉钉指定文件夹，并发送到目标钉钉群聊，适用于批量文件分发、群内资料同步等场景，可提升文件共享的效率与规范性。
二、调用参数配置
| 参数名称 | 配置说明 | 约束规则 |
|---|---|---|
| 凭证 | 钉钉开放平台访问凭证，用于接口身份认证 | 必填；可通过 “获取开发平台凭证” 指令获取，需确保凭证在有效期内 |
| 文件 | 待发送的本地文件，可通过 “选择文件” 按钮选取或输入文件绝对路径 | 必填；需确保文件存在且具备读取权限 |
| 用户 Id | 操作发起者的用户 ID，为一串数字 | 必填；可通过 “查询用户 Id” 指令获取，或在钉钉管理后台 “通讯录 - 成员管理” 模块获取 |
| 文件夹 Id | 文件上传的目标钉钉存储文件夹 ID，0 表示用户存储空间根目录 | 必填；可通过 “获取钉钉存储的文件夹列表” 指令获取 |
| 群对话 Id | 目标群聊的conversation_id | 必填；可在钉钉开放平台https://open.dingtalk.com/tools/explorer/jsapi?id=10303页面获取 |
三、输出说明
四、典型操作示例
示例 1：发送本地报表到部门群
- 配置 “凭证”：通过 “获取开发平台凭证” 指令获取并填入有效凭证；
- 配置 “文件”：点击 “选择文件” 按钮，选取本地文件
D:\部门报表.xlsx； - 配置 “用户 Id”：填入当前操作账号的用户 Id（如
123456）； - 配置 “文件夹 Id”：填入目标文件夹 Id（如
0，表示根目录）； - 配置 “群对话 Id”：填入部门群的
conversation_id（如cid_xxxx）； - 执行指令后，文件将上传至钉钉存储并发送到目标群聊，输出结果对象包含上传与发送状态。
六、注意事项
- 参数配置约束：所有参数均为必填项，需确保格式与来源准确；凭证过期需重新获取，群对话 Id 需与目标群聊完全匹配；
- 权限相关：若提示 “无权限”，需检查账号的群聊发送权限、文件夹上传权限，或联系管理员配置钉钉开放平台接口权限；
- 操作权限：需具备钉钉开放平台接口调用权限，且用户 Id 对应的账号需拥有目标群聊的发送权限、目标文件夹的上传权限；
群对话Id的获取操作过程：
打开链接： 获取群聊id链接
点击chooseChat 填写Corpid，然后连接PC设备进行调试就可以知道指定群的id了，chatid就是那个群聊id
