钉钉机器人对接

约束限制

操作流程

步骤一：准备工作

1. 创建钉钉应用。

   登录钉钉开发者后台，参考创建应用中操作，创建一个钉钉企业内部应用。

2. 添加机器人能力，并完成配置和发布。
   1. 参考添加应用能力中操作，为已创建的应用添加机器人能力。
   2. 参考配置企业机器人中操作，完成机器人的配置并发布。
      

      配置机器人时，请务必将“消息接收模式”设置为“Stream模式”。

3. 发布已创建的钉钉应用。

   参考发布应用中操作，完成应用的发布。

4. 获取应用凭据。

   参考Client ID/Client Secret中操作，获取钉钉企业内部应用的身份凭证对（Client ID、Client Secret）。后续在码道CodeArts中，连接钉钉机器人时需要使用该凭证。

步骤二：码道CodeArts配置

1. 参考码道桌面端操作，进入码道CodeArts。
2. 单击输入框下方的“选择工作空间”，您可以选择“新建工作空间”或“打开本地文件夹”。
   图1 打开一个文件夹
   

3. 左侧导航栏选择“IM助理”，单击“钉钉”卡片，进入“连接钉钉”页面。
4. 输入4中获取的钉钉机器人凭证：“Client ID”填写到“应用ID”字段，“Client Secret”填写到“应用密钥”字段，单击“连接”。
   图2 钉钉机器人凭证完成注册
   

5. 连接成功后，可在码道CodeArts界面右上角查看到连接状态。

步骤三：钉钉远程控制

1. 登录钉钉客户端，找到已加入的组织。
2. 在钉钉客户端最上方的搜索框中，搜索2中创建的机器人，单击搜索到的结果，即可进入对应的机器人。
3. 在钉钉机器人中输入想要执行的任务内容，单击“发送”提交任务。

   机器人将自动接收到来自码道CodeArts的反馈信息。

4. 根据反馈消息确认任务需求及关键信息，完成任务的创建。
5. 查看任务执行结果。
   • 在钉钉机器人端：钉钉机器人接收到来自码道CodeArts的完成反馈，提示任务执行结束并附带产物位置。
   • 在码道CodeArts侧：在码道CodeArts界面的中，您可以实时查看任务执行过程及结果。