飞书对接说明
# 飞书对接使用说明
——通过这篇文章了解飞书对接的场景及具体操作步骤
# 准备工作
● 一个有智齿系统管理员权限的账号。
● 一个有飞书管理后台管理员权限的账号。
# 创建飞书应用
# ● 登录飞书管理后台
登录飞书管理后台 (opens new window) 进入工作台——应用管理，点击“创建应用”，进入飞书开发者后台。
# ● 创建企业自建应用
点击“创建企业自建应用”，为该应用填写名称、描述，选择图标。
# ● 添加应用
添加机器人应用。
添加网页应用。
桌面端主页地址配置如下： 如果您系统的域名是sobot.com，您需要配置的地址为： https://www.soboten.com/auth/sign_in
如果您系统的域名是sg.sobot.com，您需要配置的地址为： https://sg.sobot.com/auth/sign_in
如果您系统的域名是us.sobot.com，您需要配置的地址为： https://us.sobot.com/auth/sign_in
# ● 配置安全设置
在应用的开发配置-安全设置中：
如果您系统的域名是sobot.com，您需要配置的地址为： 重定向URL：https://www.soboten.com/ws-h5-client/
如果您系统的域名是sg.sobot.com，您需要配置的地址为： 重定向URL：https://sg.sobot.io/ws-h5-client/
如果您系统的域名是us.sobot.com，您需要配置的地址为： 重定向URL：https://us.sobot.io/ws-h5-client/
# ● 配置权限
请务必将以下API权限开放，否则会导致应用无法使用。
在应用的开发配置-权限管理中，搜索并开通：
获取应用信息
获取企业信息
管理应用可见范围
获取用户受雇信息
获取用户组织架构信息
获取通讯录基本信息
获取通讯录部门组织架构信息
获取部门基础信息
获取用户基本信息
获取用户组信息
获取用户 user ID
获取用户邮箱信息
获取个人手机号信息
获取用户手机号
获取与发送单聊、群组消息
开通时点击“确认”（下一步再发布版本）
# ● 发布版本
在应用的应用发布-版本管理与发布
填写版本号，如1.0.1
移动端的默认能力：机器人
桌面端的默认能力：网页应用
更新说明：按实际情况填写
填写可用范围：建议选择全部成员，后续有调整的时候，可以减少发版次数。
# ● 审核
应用发布后，必须由管理员审核后才可使用。
前往飞书管理后台审核应用：
建议将应用设置成免审核，这样以后应用发布版本，均无需审核，自动上线。
# 绑定飞书渠道
# ● 填写应用凭证
将应用的App ID、App Secret填入智齿系统。 在飞书应用中的基础信息-凭证与基础信息中找到App ID、App Secret。
将其填入到智齿系统中，工单中心-对接中心-对接应用-对接飞书应用
# ● 绑定客服
点击“＋添加成员”按钮
选择将哪些飞书员工绑定到智齿坐席上
选择绑定方式
手动绑定已有坐席：日常单个场景账号绑定（如员工入职时）建议使用该方式；
新增坐席并绑定：当智齿尚未创建该飞书员工的坐席时（如第一次使用智齿系统，飞书上已经有员工相关的信息了），可以使用该方式；
自动绑定已有坐席：通过手机号或者邮箱的方式自动匹配飞书员工和智齿坐席（该方式试用于在智齿系统上已经有大量坐席且还没有绑定飞书的场景）；
绑定成功后，会在此显示已经和飞书绑定的坐席。
# ● 飞书在工单中的应用
在工单中心-设置-工单处理设置-通知提醒 处勾选飞书提醒，当满足通知条件后会给对应的飞书员工发应用消息。
