什么是机器人
机器人作为一种独立的应用能力，在钉钉中扮演着重要角色。只需进行简单的设置，机器人就能够在单聊场景或群聊场景中发送消息通知，或者提供与用户的交互式服务。利用机器人，可以有效地将业务信息和任务融入钉钉的聊天环境中，从而加速工作流程和团队协作。
机器人类型
更多信息可参看开发机器人应用-概述。
机器人 ID
| 机器人类型 | 唯一标识字段 | 查看路径 |
|---|---|---|
| 企业内部/第三方应用机器人 | robotCode | image.png |
| 群模板机器人 | ID | image.png |
| 自定义机器人 | 暂无 | 暂无 |
开放概览
机器人提供了丰富的接口开放能力，开发者通过API接口可以实现机器人发送和接收消息的操作。开放接口列表
DING消息
| API | API说明 | 适用类型 | API版本 |
|---|---|---|---|
| 发送DING消息 | 使用企业内机器人发送DING消息，可发送应用内DING、短信DING、电话DING。 | 企业内部应用机器人 | 新版 |
| 撤回已经发送的DING消息 | 企业内部应用机器人 | 新版 |
普通消息
| API | API说明 | 适用类型 | API版本 |
|---|---|---|---|
| 批量发送人与机器人会话中机器人消息 | 批量发送人与机器人会话（人与机器人单聊）中机器人消息。 | 第三方企业应用机器人 | 新版 |
| 人与人会话中机器人发送普通消息 | 人与人会话中机器人发送普通消息。 | 第三方企业应用机器人 | 新版 |
| 机器人发送群聊消息 | 应用机器人发送群聊消息。 | 企业内部应用机器人 | 新版 |
| 自定义机器人发送群消息 | 使用自定义机器人发送群消息。 | 自定义机器人 | 新版 |
消息接收
| API | API说明 | 适用类型 | API版本 |
|---|---|---|---|
| 下载机器人接收消息的文件内容 | 下载机器人接收消息的文件内容。 | 第三方企业应用机器人 | 新版 |
消息查询
| API | API说明 | 适用类型 | API版本 |
|---|---|---|---|
| 批量查询人与机器人会话机器人消息是否已读 | 批量查询人与机器人会话时，机器人消息是否已读。 | 第三方企业应用机器人 | 新版 |
| 查询人与人会话中机器人消息已读列表 | 查询人与人会话中机器人消息已读列表。 | 第三方企业应用机器人 | 新版 |
| 查询企业机器人群聊消息用户已读状态 | 查询企业机器人群聊消息用户已读状态。 | 第三方企业应用机器人 | 新版 |
消息撤回
| API | API说明 | 适用类型 | API版本 |
|---|---|---|---|
| 批量撤回人与机器人会话中机器人消息 | 批量撤回人与机器人会话中机器人消息。 | 第三方企业应用机器人 | 新版 |
| 批量撤回人与人会话中机器人消息 | 批量撤回人与人会话中机器人消息。 | 第三方企业应用机器人 | 新版 |
| 企业机器人撤回内部群消息 | 企业机器人撤回内部群消息。 | 企业内部应用机器人 | 新版 |
机器人管理
| API | API说明 | 适用类型 | API版本 |
|---|---|---|---|
| 获取群内机器人列表 | 获取群内机器人列表。 | 企业内部应用机器人 | 新版 |
快捷入口管理
| API | API说明 | 适用类型 | API版本 |
|---|---|---|---|
| 设置单聊机器人快捷入口 | 设置单聊机器人的快捷入口。 | 企业内部应用机器人 | 新版 |
| 查询单聊机器人的快捷入口 | 查询单聊机器人的快捷入口。 | 企业内部应用机器人 | 新版 |
| 清空单聊机器人快捷入口 | 清空单聊机器人快捷入口。 | 企业内部应用机器人 | 新版 |
回调事件列表
机器人支持消息撤回和消息已读的回调事件：- 机器人消息撤回事件
- 机器人消息已读事件
使用教程
企业机器人
- 如果你需要创建一个企业机器人，可参考配置企业机器人介绍。
-
钉钉提供了该机器人发送单聊和群聊消息的相关教程及示例代码，可点击下方链接查看相关介绍。
- 发送群聊消息：企业机器人发送群聊消息
- 发送单聊消息：企业机器人发送单聊消息
第三方企业机器人
如果你需要创建一个第三方企业机器人，可参考第三方企业机器人介绍。自定义机器人
- 如果你需要创建一个自定义机器人，可参考创建自定义机器人介绍。
- 钉钉提供了该机器人发送群聊消息的相关教程及示例代码，可查看自定义机器人发送群聊消息文档中介绍。