SERVICE & TOOLS
DingTalk
DingTalk — contacts, messaging, calendar, todos, approvals, attendance, smart tables, reports (device auth)
130 available tools
chat_ _ get_ group_ members
查群成员列表
chat_ _ search_ groups_ by_ keyword
根据群名称关键词,搜索符合条件的群,返回群的openconversion_id、群名称等信息
bot_ _ batch_ send_ robot_ msg_ to_ users
机器人批量发送单聊消息,在该机器人可使用范围内的员工,可接收到单聊消息。
bot_ _ search_ groups_ by_ keyword
根据关键词搜索我的群会话信息,包含群openconversationId、群名称等信息
calendar_ _ list_ calendar_ events
仅允许查询当前用户指定时间范围内的日程列表,最多返回100条
chat_ _ list_ conversation_ message_ v2
拉取指定群聊的会话消息内容
ding_ _ send_ ding_ message
使用企业内机器人发送DING消息,可发送应用内DING、短信DING、电话DING。
report_ _ get_ received_ report_ list
查询当前人收到的日志列表
report_ _ get_ send_ report_ list
查询当前人创建的日志详情列表,包含日志的内容、日志名称、创建时间等信息
workbench_ _ get_ user_ workspace_ apps
【不可用】现网 dws 已移除 workbench 产品,调用将返回 tool_unavailable,不会再打成 unknown flag。原语义:获取用户所有工作台应用
aitable_ _ get_ base
获取指定 Base 的资源目录级信息,返回 baseName、tables、dashboards 的 summary 信息(不含字段与记录详情)。 这是当前 Base 级目录入口:后续如需 tableId 或 dashboardId,优先从这里读取;table 详情再调用 get_tables,dashboard 详情再调用 get_dashboard
aitable_ _ query_ records
查询指定表格中的记录,支持两种模式: - 按 ID 取:传入 recordIds(单次最多 100 个),直接获取指定记录。 - 条件查:通过 filters 过滤、sort 排序、cursor 分页遍历全表。 两种模式均可通过 fieldIds(单次最多 100 个)限制返回字段以节省 token。
chat_ _ list_ conversation_ message
已废弃!!!!拉取指定单聊或群聊的会话消息内容
chat_ _ search_ groups_ by_ keywords_ test
根据群名称关键词,搜索符合条件的群,返回群的openconversion_id、群名称等信息
contact_ _ get_ current_ user_ profile
获取当前登录用户的基本信息(如姓名、工号、手机号)、当前组织信息(corpId、组织名称)、直属主管信息、所属部门列表(含部门 ID 与名称)以及角色信息(如管理员类型、自定义角色标签等)。返回内容受组织隐私与权限策略控制:若某些字段(如主管、手机号)被设为不可见,则可能被过滤或省略。
contact_ _ search_ dept_ by_ keyword
根据关键词模糊搜索部门,返回匹配的部门列表,包含每个部门的 ID、名称。搜索范围限于调用者有权限查看的组织架构;若关键词无匹配结果或部门因可见性设置被隐藏,则相应部门不会出现在结果中。
oa_ _ list_ pending_ approvals
查询当前用户待处理的审批单列表,返回每条审批单的名称、唯一编码(如审批实例 ID)、处理跳转链接(用于一键进入审批页面)等关键信息。结果仅包含用户作为审批人且尚未处理的审批事项,适用于工作台待办集成、审批提醒等场景。
oa_ _ list_ user_ visible_ process
获取当前用户可见的审批表单列表,可获取审批表单的processCode。
report_ _ get_ available_ report_ templates
获取当前员工可使用的日志模版信息,包含日志模板的名称、模板Id等
aitable_ _ export_ data
导出 AI 表格数据的统一入口。 不传 taskId 时,会根据 scope / format 创建一个新的导出任务,并在 timeoutMs 时间内同步等待结果;若在等待窗口内完成,则直接返回 downloadUrl 和 fileName。 传入 taskId 时,不会重新创建任务,而是继续等待该任务;若仍未完成,则继续返回同一个 taskId,供下一次调用继续等待。 当前稳定支持的 sc…
aitable_ _ get_ dashboard_ config_ example
返回 dashboard config 的完整结构示例(JSONC 格式,含注释说明每个字段的含义和约束,请直接阅读理解)。可作为 create_dashboard / update_dashboard 的 config 参数结构参考。
aitable_ _ get_ dashboard_ widgets_ example
返回所有图表类型的 widget config 示例(JSONC 格式,含注释说明每个字段的含义和约束,请直接阅读理解)。可作为 create_chart / update_chart 的 config 参数结构参考,根据目标图表类型选取对应示例。
aitable_ _ get_ fields
批量获取指定字段的详细信息,包括 fieldId、名称、类型、description 以及类型相关完整配置(如格式化、选项、AI 配置等)。 传 fieldIds 时单次最多获取 10 个字段;若需更多字段,请拆分多次调用。 适用于在 get_tables 拿到字段目录后,按需展开少量字段的完整配置,避免大 options 字段放大 get_tables 返回值。 AI 字段的返回结果中,c…
aitable_ _ get_ tables
批量获取指定 Tables(数据表)的表级信息、字段目录与视图目录。 会返回 tables 列表;每个 table 直接包含 tableId、tableName、description、fields、views;字段列表仅包含 fieldId、fieldName、type、description;views 仅包含 viewId、viewName、type。 若需读取字段的完整配置,请再调用 …
aitable_ _ get_ views
获取指定数据表(Table)中的视图(View)完整信息,包括列顺序、筛选、排序、分组、条件格式、自定义配置等。 支持两种模式: - 显式选择:传入 viewIds,按入参顺序返回这些视图;单次最多 10 个。 - 默认全量:省略 viewIds,返回当前表下全部视图,顺序与当前表视图目录一致。
aitable_ _ list_ bases
AI 表格访问地址可按 baseId 拼接为:https://docs.dingtalk.com/i/nodes/{baseId}
aitable_ _ search_ bases
AI 表格访问地址可按 baseId 拼接为:https://docs.dingtalk.com/i/nodes/{baseId}
aitable_ _ search_ templates
按名称关键词搜索 AI 表格模板,支持分页。 返回每个模板的 templateId、name、description,以及分页信息 hasMore / nextCursor。 返回的 templateId 可直接用于 create_base。 模板预览链接可通过 https://docs.dingtalk.com/table/template/{templateId} 拼接得到
attendance_ _ batch_ get_ employee_ shifts
批量查询多个员工在指定日期的考勤班次信息,返回每条记录包含:用户 ID(userId)、工作日期(workDate,毫秒时间戳)、打卡类型(checkType,如 OnDuty 表示上班)、计划打卡时间(planCheckTime,毫秒时间戳)以及是否为休息日(isRest,"Y"/"N")。结果基于组织考勤配置生成,仅返回调用者有权限查看的员工数据,适用于排班核对、考勤预览等场景。
attendance_ _ get_ attendance_ summary
获取考勤统计摘要
attendance_ _ get_ user_ attendance_ record
查询指定用户在某一天的考勤详情,包括实际打卡记录(如上班/下班时间、是否正常打卡)、当日所排班次、所属考勤组信息、是否为休息日、出勤工时(如 "0Hours")、加班时长等。返回数据受组织权限和隐私策略限制,仅当调用者有权限查看该用户考勤信息时才返回有效内容。适用于员工自助查询、HR 核对出勤或审批关联场景。
attendance_ _ query_ attendance_ group_ or_ rules
查询考勤组/考勤规则:"我属于哪个考勤组""我们的打卡范围是什么""弹性工时是怎么算的"
bot_ _ search_ my_ robots
搜索我创建的机器人,可获取机器人robotCode等信息。
calendar_ _ add_ calendar_ participant
向已存在的指定日程添加参与者,支持批量添加多人,可设置参与者类型和通知方式
calendar_ _ create_ calendar_ event
创建新的日程,支持设置时间、参与者、提醒等完整功能
calendar_ _ list_ meeting_ room_ groups
分页查询当前企业下的会议室分组列表,返回每个分组的名称(groupName)、唯一 ID(groupId)及其父分组 ID(parentId,0 表示根分组)。结果按组织架构权限过滤,仅包含调用者有权限查看的分组。
calendar_ _ list_ suggested_ event_ times
可根据参会人员的信息,推荐日程时间。用于日程时间未确定,解决会议时间协调问题。
calendar_ _ query_ available_ meeting_ room
根据时间筛选出符合闲忙条件的会议室列表。
calendar_ _ query_ busy_ status
查询指定用户在给定时间范围内的闲忙状态,返回其日历中已占用时间段的详细日程信息(如标题、开始/结束时间),不包含具体日程内容细节(如参与人、地点),以保护隐私。结果受组织可见性策略控制:仅当调用者有权限查看该用户日历时方可获取有效数据。适用于安排会议前快速确认他人可用时间。
chat_ _ list_ individual_ chat_ message
拉取指定用户的单聊会话消息内容
chat_ _ list_ special_ focus_ messages
拉特别关注人的消息
chat_ _ search_ at_ me_ message
搜索at自己的消息
chat_ _ search_ common_ groups
通过人员名称搜索共同群聊
chat_ _ search_ messages_ by_ keyword
按关键词搜索消息
chat_ _ search_ messages_ by_ sender
根据发送者拉消息
chat_ _ search_ messages_ by_ time_ range
根据指定时间范围,分页搜索历史消息
chat_ _ unread_ message_ conversation_ list
unread_message_conversation_list
contact_ _ get_ dept_ members_ by_ deptId
获取指定部门下的所有成员,返回每位成员的用户 ID(userId)和显示名称(如真实姓名或昵称)。结果受组织可见性控制:若调用者无权查看某成员(例如该成员所在子部门被隐藏,或其个人信息设为私密),则该成员不会出现在返回列表中。适用于需要展示部门人员列表、选择协作成员等场景,仅支持调用者有权限访问的部门。
contact_ _ get_ sub_ depts_ by_ dept_ id
根据指定的部门 ID,获取其直接子部门列表,返回每个子部门的部门 ID、名称。结果受组织架构可见性控制:仅返回调用者有权限查看的子部门;若父部门不可见或无子部门,则返回空列表。
contact_ _ get_ user_ info_ by_ user_ ids
获取指定用户 ID 列表对应的员工详细信息,包括人员基本信息(ID、名称、主管名称、主管userId等)、所属角色信息、所在部门信息。返回结果受组织可见性规则限制:若调用者无权查看某员工(如部门隐藏、手机号设为私密等),则相应字段可能被过滤或不返回该员工。适用于需要批量获取同事信息的场景,如组织架构展示、审批人选择等。仅返回调用者权限范围内的有效数据。