> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 概述

> 介绍钉钉提供的多种机器人类型及其适用场景,并给出开放能力概览与使用教程入口。

钉钉提供了多种机器人，分别在不同的场景下使用。本文介绍不同类型机器人的使用场景。

## 什么是机器人

机器人作为一种独立的应用能力，在钉钉中扮演着重要角色。只需进行简单的设置，机器人就能够在单聊场景或群聊场景中发送消息通知，或者提供与用户的交互式服务。利用机器人，可以有效地将业务信息和任务融入钉钉的聊天环境中，从而加速工作流程和团队协作。

![机器人能力 ](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6217523761/p548652.gif)

### 机器人类型

| **类型**      | **是否支持群聊**  | **是否支持单聊** | **创建方式**                                                            |
| ----------- | ----------- | ---------- | ------------------------------------------------------------------- |
| 企业机器人       | ✅（内部群）      | ✅          | [配置企业机器人](/zh/open/dingstart/configure-the-robot-application)       |
| 第三方企业应用-机器人 | ✅（内部群）      | ✅          | 第三方企业机器人                                                            |
| 自定义机器人      | ✅（外部群&&内部群） | ❌          | [创建自定义机器人](/zh/open/dingstart/custom-bot-creation-and-installation) |
| 群模板机器人      | ✅（内部群）      | ❌          | 创建群模板机器人                                                            |

更多信息可参看[开发机器人应用-概述](/zh/open/dingstart/robot-application-overview)。

### 机器人 ID

| **机器人类型**     | **唯一标识字段** | **查看路径**  |
| ------------- | ---------- | --------- |
| 企业内部/第三方应用机器人 | robotCode  | image.png |
| 群模板机器人        | ID         | image.png |
| 自定义机器人        | 暂无         | 暂无        |

## 开放概览

机器人提供了丰富的接口开放能力，开发者通过API接口可以实现机器人发送和接收消息的操作。

### 开放接口列表

#### DING消息

| **API**       | **API说明**                                  | **适用类型**  | **API版本** |
| ------------- | ------------------------------------------ | --------- | --------- |
| 发送DING消息      | 使用企业内机器人发送DING消息，可发送应用内DING、短信DING、电话DING。 | 企业内部应用机器人 | 新版        |
| 撤回已经发送的DING消息 |                                            | 企业内部应用机器人 | 新版        |

#### 普通消息

| **API**                                                                                                      | API说明                       | **适用类型**   | **API版本** |
| ------------------------------------------------------------------------------------------------------------ | --------------------------- | ---------- | --------- |
| [批量发送人与机器人会话中机器人消息](/zh/open/development/chatbots-send-one-on-one-chat-messages-in-batches)                  | 批量发送人与机器人会话（人与机器人单聊）中机器人消息。 | 第三方企业应用机器人 | 新版        |
| [人与人会话中机器人发送普通消息](/zh/open/development/the-robot-sends-ordinary-messages-in-a-person-to-person-conversation) | 人与人会话中机器人发送普通消息。            | 第三方企业应用机器人 | 新版        |
| [机器人发送群聊消息](/zh/open/development/the-robot-sends-a-group-message)                                            | 应用机器人发送群聊消息。                | 企业内部应用机器人  | 新版        |
| [自定义机器人发送群消息](/zh/open/development/custom-robots-send-group-messages)                                        | 使用自定义机器人发送群消息。              | 自定义机器人     | 新版        |

#### 消息接收

| **API**                                                                                         | API说明           | **适用类型**   | **API版本** |
| ----------------------------------------------------------------------------------------------- | --------------- | ---------- | --------- |
| [下载机器人接收消息的文件内容](/zh/open/development/download-the-file-content-of-the-robot-receiving-message) | 下载机器人接收消息的文件内容。 | 第三方企业应用机器人 | 新版        |

#### 消息查询

| **API**                                                                                                           | API说明                   | **适用类型**   | **API版本** |
| ----------------------------------------------------------------------------------------------------------------- | ----------------------- | ---------- | --------- |
| [批量查询人与机器人会话机器人消息是否已读](/zh/open/development/chatbot-batch-query-the-read-status-of-messages)                      | 批量查询人与机器人会话时，机器人消息是否已读。 | 第三方企业应用机器人 | 新版        |
| [查询人与人会话中机器人消息已读列表](/zh/open/development/query-the-read-list-of-robot-messages-in-person-to-person-conversations) | 查询人与人会话中机器人消息已读列表。      | 第三方企业应用机器人 | 新版        |
| [查询企业机器人群聊消息用户已读状态](/zh/open/development/chatbot-queries-the-read-status-of-a-message)                            | 查询企业机器人群聊消息用户已读状态。      | 第三方企业应用机器人 | 新版        |

#### 消息撤回

| **API**                                                                                                                  | API说明              | **适用类型**   | **API版本** |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------ | ---------- | --------- |
| [批量撤回人与机器人会话中机器人消息](/zh/open/development/batch-message-recall-chat)                                                      | 批量撤回人与机器人会话中机器人消息。 | 第三方企业应用机器人 | 新版        |
| [批量撤回人与人会话中机器人消息](/zh/open/development/batch-withdrawal-of-single-chat-robot-messages-in-person-to-person-conversations) | 批量撤回人与人会话中机器人消息。   | 第三方企业应用机器人 | 新版        |
| [企业机器人撤回内部群消息](/zh/open/development/enterprise-chatbot-withdraws-internal-group-messages)                                | 企业机器人撤回内部群消息。      | 企业内部应用机器人  | 新版        |

#### 机器人管理

| **API**                                                                  | API说明      | **适用类型**  | **API版本** |
| ------------------------------------------------------------------------ | ---------- | --------- | --------- |
| [获取群内机器人列表](/zh/open/development/obtain-the-list-of-robots-in-the-group) | 获取群内机器人列表。 | 企业内部应用机器人 | 新版        |

#### 快捷入口管理

| **API**                                                                          | API说明         | **适用类型**  | **API版本** |
| -------------------------------------------------------------------------------- | ------------- | --------- | --------- |
| [设置单聊机器人快捷入口](/zh/open/development/set-robot-quick-entrance)                     | 设置单聊机器人的快捷入口。 | 企业内部应用机器人 | 新版        |
| [查询单聊机器人的快捷入口](/zh/open/development/quick-entrance-of-inquiry-single-chat-robot) | 查询单聊机器人的快捷入口。 | 企业内部应用机器人 | 新版        |
| [清空单聊机器人快捷入口](/zh/open/development/clear-single-chat-robot-quick-entry)          | 清空单聊机器人快捷入口。  | 企业内部应用机器人 | 新版        |

### 回调事件列表

机器人支持消息撤回和消息已读的回调事件：

* 机器人消息撤回事件
* 机器人消息已读事件

## 使用教程

### 企业机器人

* 如果你需要创建一个企业机器人，可参考[配置企业机器人](/zh/open/dingstart/configure-the-robot-application)介绍。
* 钉钉提供了该机器人发送单聊和群聊消息的相关教程及示例代码，可点击下方链接查看相关介绍。

  * 发送群聊消息：[企业机器人发送群聊消息](/zh/open/development/the-application-robot-in-the-enterprise-sends-group-chat-messages)
  * 发送单聊消息：[企业机器人发送单聊消息](/zh/open/development/the-application-robot-in-the-enterprise-sends-a-single-chat)

### 第三方企业机器人

如果你需要创建一个第三方企业机器人，可参考第三方企业机器人介绍。

### 自定义机器人

* 如果你需要创建一个自定义机器人，可参考[创建自定义机器人](/zh/open/dingstart/custom-bot-creation-and-installation)介绍。
* 钉钉提供了该机器人发送群聊消息的相关教程及示例代码，可查看[自定义机器人发送群聊消息](/zh/open/development/custom-bot-to-send-group-chat-messages)文档中介绍。

### 群模板机器人

如果你需要创建群聊会话时，同时将机器人添加至群内，可参考创建群模板机器人介绍。

<Warning>
  钉钉提供了该机器人发送群聊消息的相关教程及示例代码，可查看[群模板机器人发送群聊消息](/zh/open/development/group-template-robot-sends-group-chat-message)文档中介绍。
</Warning>

### 三方工具机器人

如果你仅需要发送消息的能力，并仅限于从 GitLab、GitHub、JIRA、阿里云 Codeup 和 Travis 推送消息到钉钉群内，可参考Webhook 机器人介绍。
