# 钉钉机器人对接
码道CodeArts支持对接钉钉，将码道CodeArts能力接入钉钉聊天。对接完成后，你可在钉钉中直接给码道CodeArts进行消息收发，实现在移动端随时随地与码道CodeArts交互，无需切换到码道CodeArts平台主界面。
本章节将为你介绍如何将码道CodeArts接入钉钉，帮助你快速实现功能集成与流程协同。
#### 约束限制
表1约束与限制 
| 限制类别 | 具体限制                                                                       |
|:---|:---|
| 功能限制  | 一个钉钉机器人仅支持对接一个码道CodeArts。                                                  |
| 操作系统 | Windows：推荐使用Windows 11 (x64)；如果使用Windows 10 (x64)，系统版本需为2019年及以上，建议升级至最新稳定版本。 |
   
#### 操作流程
表2码道CodeArts接入钉钉操作流程 
| 序号  | 操作平台                                           | 步骤                                                     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| 1   | 钉钉开发者后台                                    | [步骤一：准备工作]       | 在码道CodeArts对接钉钉机器人时，请提前完成如下操作： 1. 创建钉钉应用。  2. 添加机器人能力，并完成配置和发布。  3. 发布已创建的钉钉应用。    4. 获取应用凭据。   |
| 2 | 码道CodeArts                                  | [步骤二：码道CodeArts配置] | 在码道CodeArts中，注册钉钉机器人用以接收和回复消息。                                                                                                                                                                                                                                                                                                                                                                                                    |
| 3  | 钉钉客户端 码道CodeArts | [步骤三：钉钉远程控制]      | 通过钉钉机器人对码道CodeArts下发任务。                                                                                                                                                                                                                                                                                                                                                                                                            |
   
 #### 步骤一：准备工作
1. 创建钉钉应用。 
   登录[钉钉开发者后台](https://open-dev.dingtalk.com/)，参考[创建应用](https://open.dingtalk.com/document/dingstart/create-application#76ba742756c61)中操作，创建一个钉钉企业内部应用。
   
   
2. 添加机器人能力，并完成配置和发布。
   
   1. 参考[添加应用能力](https://open.dingtalk.com/document/dingstart/create-application#2009fdc27dt04)中操作，为已创建的应用添加机器人能力。
   
   2. 参考[配置企业机器人](https://open.dingtalk.com/document/dingstart/configure-the-robot-application)中操作，完成机器人的配置并发布。
      ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/public_sys-resources/caution_3.0-zh-cn.png)
      配置机器人时，请务必将"消息接收模式"设置为"Stream模式"。
      
   
   
   
   
3. 发布已创建的钉钉应用。 
   参考[发布应用](https://open.dingtalk.com/document/dingstart/publish-dingtalk-application)中操作，完成应用的发布。
   
   
4. 获取应用凭据。
   
   参考[Client ID/Client Secret](https://open.dingtalk.com/document/dingstart/basic-concepts-beta#0c921e272057g)中操作，获取钉钉企业内部应用的身份凭证对（Client ID、Client Secret）。后续在码道CodeArts中，连接钉钉机器人时需要使用该凭证。
   
   
 
 #### 步骤二：码道CodeArts配置
1. 参考[码道桌面端](https://support.huaweicloud.com/usermanual-codeartsdesktop/desktop_0005.html)操作，进入码道CodeArts。
2. 单击输入框下方的"选择工作空间"，您可以选择"新建工作空间"或"打开本地文件夹"。 
   图1打开一个文件夹   
   ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/zh-cn_image_0000002723900262.png "点击放大")
   
   
3. 左侧导航栏选择"IM助理"，单击"钉钉"卡片，进入"连接钉钉"页面。
4. 输入[4]中获取的钉钉机器人凭证："Client ID"填写到"应用ID"字段，"Client Secret"填写到"应用密钥"字段，单击"连接"。
   
   图2钉钉机器人凭证完成注册   
   ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/zh-cn_image_0000002718580186.png)
   
   
5. 连接成功后，可在码道CodeArts界面右上角查看到连接状态。
 
 #### 步骤三：钉钉远程控制
1. 登录钉钉客户端，找到已加入的组织。
2. 在钉钉客户端最上方的搜索框中，搜索[2]中创建的机器人，单击搜索到的结果，即可进入对应的机器人。
3. 在钉钉机器人中输入想要执行的任务内容，单击"发送"提交任务。 
   机器人将自动接收到来自码道CodeArts的反馈信息。
   
   
4. 根据反馈消息确认任务需求及关键信息，完成任务的创建。
5. 查看任务执行结果。 
   - **在钉钉机器人端**：钉钉机器人接收到来自码道CodeArts的完成反馈，提示任务执行结束并附带产物位置。
   
   - **在码道CodeArts侧**：在码道CodeArts界面的中，您可以实时查看任务执行过程及结果。