By name: dingtalk platforms: - dingtalk description: >- 钉钉平台管理能力。当用户在钉钉中请求群管理（踢人、改群名、查群信息）、 组织架构查询（部门/用户查询）、发送工作通知、创建或管理群聊时使用。 即使用户没有提到钉钉，只要上下文是钉钉/DingTalk 场景且涉及群管理、 组织架构或工作通知，就应触发。仅有昵称时先查部门用户列表获取 user_id。 keywords: - dingtalk - 钉钉 - adapter:dingtalk - 群管理 - 部门 - 工作通知 - 组织架构 - 企业 - list_members tags: - group - management - im - enterprise tools: - dingtalk_get_user - dingtalk_get_dept_users - dingtalk_list_departments - dingtalk_send_work_notice - dingtalk_create_chat - dingtalk_add_chat_members - dingtalk_dept_info - dingtalk_update_chat - dingtalk_kick_member - dingtalk_set_group_name - dingtalk_get_group_info
钉钉群聊与组织管理技能
钉钉是企业 IM 平台，特有组织架构（部门树）和工作通知能力，区别于个人社交类 IM。
核心原则
组织架构是核心
钉钉的用户隶属于部门树，很多操作需要从组织架构出发：
dingtalk_list_departments → 获取部门列表（根部门 ID=1）
dingtalk_get_dept_users(dept_id) → 获取部门下的用户列表
dingtalk_get_user(user_id) → 获取用户详情
工作通知 ≠ 群消息
dingtalk_send_work_notice 是直接发给个人的企业通知，出现在钉钉的「工作通知」入口，不需要群聊。用户说「通知一下张三」，如果是正式的企业通知，用 send_work_notice；如果只是聊天消息，用普通消息发送。
工具分类
群聊管理
| 工具 | 用途 | 说明 |
|---|---|---|
dingtalk_kick_member |
踢出成员 | — |
dingtalk_set_group_name |
改群名 | — |
dingtalk_get_group_info |
群信息 | — |
dingtalk_create_chat |
创建群聊 | 需群主 userId + 至少一个成员 |
dingtalk_add_chat_members |
添加成员 | — |
dingtalk_update_chat |
更新群设置 | 改名、换群主、增减成员 |
组织架构
| 工具 | 用途 | 说明 |
|---|---|---|
dingtalk_list_departments |
部门列表 | 默认从根部门 ID=1 开始 |
dingtalk_dept_info |
部门详情 | — |
dingtalk_get_dept_users |
部门用户列表 | — |
dingtalk_get_user |
用户详情 | — |
通知
| 工具 | 用途 | 说明 |
|---|---|---|
dingtalk_send_work_notice |
工作通知 | 发给指定用户列表，不需要群 |
易错点
- 部门查询从根部门 ID=1 开始。不知道部门 ID 时先
list_departments获取整棵部门树。 - 群聊创建需要群主 userId 和至少一个成员，不能创建空群。
- 工作通知是独立于群聊的，它发到个人的钉钉「工作通知」入口，不要与群消息混淆。
- 操作成员需要钉钉 userId，仅有昵称时先通过
get_dept_users或get_group_info查找。