# 飞书集成
本指南将帮助您为果办OfficeAce集成飞书机器人。集成后，您可以通过飞书随时随地与果办OfficeAce进行对话、下发任务（如远程操控电脑执行代码）等。
**运作机制：**
飞书集成的消息流转路径为：用户在飞书中发送消息 → 飞书服务器通过长连接将消息推送到果办OfficeAce → 果办OfficeAce调用模型进行处理 → 处理结果返回飞书并展示给用户。
#### 步骤一：在果办OfficeAce集成飞书
1. 登录果办OfficeAce。
2. 在左侧导航栏中选择"渠道"，在渠道列表中选择"飞书"。
3. 单击生成二维码按钮，等待二维码生成后，手机使用飞书App扫描二维码，按照飞书提示完成授权对接。
 
#### 步骤二：开始使用
对接完成后，手机飞书App中会出现一个对话窗口，通过飞书的聊天窗直接和果办OfficeAce对话。如[图1]所示，在果办OfficeAce的会话列表中出现来自飞书的会话记录，表示对接成功。
![](https://support.huaweicloud.com/im-officeace/public_sys-resources/note_3.0-zh-cn.png)
如需指定某个智能体处理任务，可以直接输入@+智能体名称，指定智能体进行对话。
图1在飞书中和果办OfficeAce对话   
![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002754018099.png "点击放大")
#### 步骤三：配置个人白名单
当您在飞书群聊中使用果办OfficeAce控制本地电脑时，为了防止他人误操作或恶意控制，请务必开启个人白名单功能。
![](https://support.huaweicloud.com/im-officeace/public_sys-resources/warning_3.0-zh-cn.png)
如果不开启白名单，群聊中的任何成员都可以通过@机器人触发果办OfficeAce操作您的电脑，存在严重的安全风险。强烈建议在群聊场景下务必配置白名单。
1. 登录果办OfficeAce。
2. 在左侧导航栏中选择"渠道"，在渠道列表中选择"飞书"。
3. 在个人白名单区域，如[图2]所示，填入open_id和备注（如用户姓名），单击"添加"。
   
   ![](https://support.huaweicloud.com/im-officeace/public_sys-resources/note_3.0-zh-cn.png)
   open_id是飞书中用户的唯一标识，每个用户对应一个open_id。获取方式：在飞书中@机器人，发送/myid即可获取您的open_id。
   图2配置个人白名单   
   ![](https://support.huaweicloud.com/im-officeace/zh-cn_image_0000002724458268.png "点击放大")
   设置完成后，群聊内只有您本人"@机器人"才会触发回复。其他成员@机器人的消息将被系统自动忽略，以此确保操作权限的唯一性与安全性。
   
   
 
#### 常用指令
果办OfficeAce支持通过特殊前缀指令控制会话，常用指令如下[表1]所示。
 表1特殊前缀指令 
| 命令          | 说明              |
|:---|:---|
| /new         | 新建未命名会话。          |
| /new *标题*   | 新建名为*标题*的会话。     |
| /where       | 返回当前所在的会话。       |
| /threads      | 显示所有会话编号和会话主题。 |
| /use *会话编号* | 切换到编号对应的会话。      |