1.概述

本产品提供了飞书集成的能力,通过在助手里绑定飞书机器人即可实现在飞书中问答使用。

注意:飞书机器人通过 WebSocket 与知数进行通信,官方个人版与企业版均可无缝接入。私有化部署的飞书需进行特殊配置后方可通信,请联系我方技术支持完成相应配置。

2.对接流程

1、准备

准备一个飞书应用,注册个人账号或企业账号均可。SaaS 版本飞书均通过手机号注册,也可配置一个工作邮箱(需具备企业域管理员权限,个人版),后续操作中可能用到。

2、打开知数绑定页

进入知数管理后台 → 业务助手管理 → 编辑助手 → 高级设置 → IM 设置,绑定自定义机器人(飞书):
飞书对接 - 图1 飞书对接 - 图2

注意:二维码存在有效期,请在 5 分钟内完成扫码。

3、手机端扫码

使用飞书扫描二维码后,手机端显示如下界面,可选择已有助手或新建助手。

3.1 新建飞书机器人

若当前账号非飞书企业域管理员,点击创建后将出现以下场景。
飞书对接 - 图3
飞书对接 - 图4

出现该提示的原因为:当前账号不具备飞书企业域管理员权限,飞书应用配置的更改需经管理员审核通过后方可生效,机器人实际已创建完成。

此时企业域管理员将收到通知,点击通知后可在企业域管理后台中的【工作台-应用审核】中进行审批。
飞书对接 - 图5

待机器人应用申请审批通过后,重新扫码,选择已有应用(即此前创建的机器人)即可。扫码通过后,页面将显示配置成功。
飞书对接 - 图6

3.2 选择已有的飞书机器人

若该机器人所需权限均已申请完成,扫码并加载完成后将直接进入绑定成功页面。
飞书对接 - 图7

4、配置账号匹配关系

该功能用于打通飞书用户与知数用户之间的对应关系。

飞书用户属性包括:手机号与邮箱。

知数用户属性包括:账号、手机号、邮箱及用户自定义属性。

飞书对接 - 图8
飞书对接 - 图9

示例:飞书侧选择邮箱、知数侧选择账号:后续问答流程中,将依据飞书用户的邮箱值 V1,查找知数用户账号属性的值是否为 V1。若存在,则匹配至账号为 V1 的知数用户,并使用该用户的资源与助手权限进行知数问答;若不存在,则表示匹配失败,需更新属性值或匹配关系。其他属性的匹配原理相同。

5、开始问答

配置成功后,飞书的应用会收到下面的通知消息。这样就可以开始问答啦。
飞书对接 - 图10
飞书对接 - 图11
飞书对接 - 图12

注意事项

同一助手不支持被多人同时绑定,需等待前一位管理员的操作结束后方可查看结果。
飞书对接 - 图13

若该助手已被他人完成绑定,可能显示如下:
飞书对接 - 图14