# 钉钉集成
本指南将帮助您为果办OfficeAce集成钉钉。集成后，您可以通过钉钉给果办OfficeAce下达指令并进行对话，实现移动端随时随地的智能体交互。
- **使用场景**：当您不在电脑旁但仍需使用果办OfficeAce处理任务时，通过钉钉集成可以随时随地通过手机与果办OfficeAce对话，如在外出时安排日程、分析数据、生成报告等。
- **运作机制**：钉钉集成的消息流转路径为：用户在钉钉中发送消息 → 钉钉服务器将消息推送至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回钉钉并展示给用户。
 #### 步骤一：创建钉钉机器人
本步骤内容仅供参考，实际请以[钉钉文档](https://open.dingtalk.com/document/development/create-dingtalk-intelligent-agent-application)为准。
1. 创建应用。 
   1. 登录[钉钉开发者后台](https://open-dev.dingtalk.com/fe/app?#/corp/app)。
      创建钉钉应用需要钉钉账号有开发者权限。请提前联系组织管理员获取钉钉开放平台的开发权限，具体操作请参见[获取开发者权限](https://open.dingtalk.com/document/orgapp/obtain-developer-permissions)。
      
   
   2. 在左侧导航栏中，选择"钉钉应用"，在钉钉应用页面单击"创建应用"。 ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002753897999.png "点击放大")
      
   
   3. 在弹出的窗口中填写"应用名称"、"应用描述"后，单击"保存"。
      图1创建应用   
      ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002754018097.png "点击放大") 
   
   
   
   
2. 添加机器人能力。应用创建成功后，会自动跳转至"添加应用能力"页面，选择添加机器人。 
   图2添加机器人   
   ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002724298320.png "点击放大")
   
   
3. 配置机器人信息。打开机器人配置，填写以下信息。 
   表1参数说明 
   | 参数    | 说明                 |
   |:---|:---|
   | 机器人名称 | 机器人在钉钉中显示的名称        |
   | 机器人简介 | 简要描述机器人的功能，便于用户了解用途 |
   | 机器人描述   | 详细描述机器人的能力和使用方式   |
   | 消息预览图 | 上传一张机器人消息预览图        |
      
   图3配置机器人信息   
   ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002754018101.png "点击放大")
   
   
4. 发布机器人。配置完成后，在页面下方单击"发布"。 
   图4发布机器人   
   ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002754018107.png "点击放大")
   
   
5. 配置应用权限。 
   为保证机器人能正常收发消息，需要在"权限管理"中配置相关权限。
   依次搜索并开通以下权限：Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。权限说明如[表2]所示。
    表2权限说明 
   | 权限名称                  | 用途                      |
   |:---|:---|
   | Card.Streaming.Write | 允许机器人发送流式卡片消息，用于实时展示回复内容  |
   | Card.Instance.Write   | 允许机器人创建和更新交互式卡片，用于消息展示和交互 |
   | qyapi_robot_sendmsg  | 允许机器人通过API发送消息，用于向用户推送回复  |
      
   图5开通机器人权限   
   ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002753897995.png "点击放大")
   
   
6. 创建并发布应用版本。 
   1. 在左侧导航栏中选择"版本管理与发布"，并"创建新版本"。
      图6创建新版本   
      ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002754018109.png "点击放大") 
   
   2. 填写版本号、版本描述，并选择应用可用范围后单击"保存"并按提示进行发布。
      
      图7发布版本   
      ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002753897997.png "点击放大") 
   
   
   
   
7. 获取应用凭证。 
   在"凭证与基础信息"页面获取Client ID、Client Secret，用于[步骤二：在果办OfficeAce集成钉钉]配置果办OfficeAce的对接信息。
   ![](https://support.huaweicloud.com/im-officeace/public_sys-resources/note_3.0-zh-cn.png)
   Client ID和Client Secret是钉钉应用的鉴权凭证。在[步骤二：在果办OfficeAce集成钉钉]中，Client ID对应填写至"App Key"字段，Client Secret对应填写至"App Secret"字段。
   ![](https://support.huaweicloud.com/im-officeace/public_sys-resources/caution_3.0-zh-cn.png)
   Client Secret属于敏感凭证，请妥善保管，切勿泄露或提交至公开代码仓库。
   图8获取凭证信息   
   ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002753898001.png "点击放大")
   
   
 
 #### 步骤二：在果办OfficeAce集成钉钉
1. 登录果办OfficeAce。
2. 在左侧导航栏中选择"渠道"，在渠道列表中选择"钉钉"。
3. 填写[步骤一：创建钉钉机器人]中获取的Client ID填写至"App Key"、将Client Secret填写至"App Secret"。
4. 填写完成后单击"测试连接"，连接成功后单击"保存配置"。 
   ![](https://support.huaweicloud.com/im-officeace/public_sys-resources/note_3.0-zh-cn.png)
   如果测试连接失败，请检查：①Client ID和Client Secret是否填写正确且未多余空格；②钉钉应用是否已成功发布；③三项权限是否已全部开通。
   
   
 
#### 步骤三：开始使用
1. 在钉钉顶部搜索框，搜索[步骤一]中创建的机器人，如[图9]所示，找到新创建的机器人。
   
   图9查找机器人   
   ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002724458276.png "点击放大")
   
   
2. 单击机器人，通过聊天窗直接和果办OfficeAce对话，例如"用python写个快速排序"，如[图10]所示，果办OfficeAce中显示和钉钉的会话信息表示对接成功。
   
   ![](https://support.huaweicloud.com/im-officeace/public_sys-resources/note_3.0-zh-cn.png)
   如需指定某个智能体处理任务，可以直接输入@+智能体名称，指定智能体进行对话。
   图10单聊使用   
   ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002724298328.png "点击放大")
   
   
 
#### 常用指令
果办OfficeAce支持通过特殊前缀指令控制会话，常用指令如下[表3]所示。
 表3特殊前缀指令 
| 命令          | 说明              |
|:---|:---|
| /new         | 新建未命名会话。          |
| /new *标题*   | 新建名为*标题*的会话。     |
| /where       | 返回当前所在的会话。       |
| /threads      | 显示所有会话编号和会话主题。 |
| /use *会话编号* | 切换到编号对应的会话。      |