接入说明
七鱼提供了飞书客服授权接入方式。
接入方式
七鱼提供飞书自建应用接入方案，只需管理员在七鱼后台按照提示绑定应用相关信息即可。
接入前准备
- 请准备飞书管理员权限账号
- 确保飞书企业状态正常
员工服务
自建应用接入飞书
步骤一：创建企业内部应用，登录 飞书开发者后台，选择【创建企业自建应用】，选择类型为【企业自建应用】其它信息请根据自身需求填写（例：应用名称为HR服务中心），填写完毕后创建应用，如图1、图2。
图1:创建应用
图2:创建应用并选择应用类型
步骤二：回填应用信息：点击创建成功的应用，获取应用信息，并上传应用头像，随后将App ID、App Secret回填进七鱼对应字段内，如图3、图4。
图3:获取应用信息
图4:将应用信息回填七鱼
步骤三：回填七鱼应用链接：将七鱼生成的应用首页地址，填入应用的桌面端首页&移动端首页，如图5、图6。
图5:复制七鱼首页链接
图6:回填应用信息
步骤四：应用授权：点击权限管理，按需勾选应用权限，建议选择以下5个权限方便进行后续身份认证和业务进行，参考图7（七鱼不会泄漏和主动存储您的员工信息）：
- 获取用户邮箱信息
- 获取用户基本信息
- 获取部门基础信息
- 获取用户手机号
- 以应用身份读取通讯录
图7:勾选应用权限信息
步骤五：配置字段映射：将飞书内员工信息字段与七鱼客户信息字段建立映射关系，可自动完成身份识别，方便后续进行会话路由分配、机器人问题回复、工单协同等业务使用。如图8:
图8:配置映射字段
步骤六：创建版本发布：版本号建议1.0.0，根据需求选择应用员工可见范围（无特殊情况建议全员），随后确认发布，如图9:
图9:发布应用
跨团队协作
自建应用接入飞书
创建企业内部应用：
登录飞书开发者后台（https://open.feishu.cn/app) ，选择【创建企业自建应用】，选择类型为【企业自建应用】其它信息请根据自身需求填写（例：应用名称为网易七鱼轻工单），填写完毕后创建应用，如图1、图2
图1：创建应用
图2：创建应用并选择应用类型
回填应用信息：
点击创建成功的应用，获取应用信息，并上传应用头像，随后将App ID、App Secret回填进七鱼对应字段内，如图3、图4
图3：获取应用信息
图4：将应用信息回填七鱼
回填七鱼应用链接：
将七鱼生成的首页链接、安全设置重定向地址、机器人-我受理工单地址、机器人-我完结工单地址，填入应用设置的对应位置中，如图5、图6
图5：复制七鱼链接
图6-1：回填应用信息-回填首页链接
图6-2：回填应用信息-回填安全设置重定向地址
图6-3：回填应用信息-启用机器人，并回填【机器人-我受理工单地址】和【机器人-我完结工单地址】
应用授权：
点击权限管理，勾选应用权限，开通以下权限方便进行后续身份认证和业务进行，参考图7（七鱼不会泄漏和主动存储您的员工信息）：
- 获取用户基本信息
- 获取部门基础信息
- 获取个人手机号信息
- 获取应用信息
- 获取与发送单聊、群组消息
- 获取通讯录基本信息
- 获取通讯录部门组织架构信息
创建版本发布：
版本号建议1.0.0，根据需求选择应用员工可见范围（无特殊情况建议全员），随后确认发布，如图8
图8：发布应用
应用审核：
飞书管理员在飞书管理后台进行应用上线审批，如图9
图9：飞书管理员在飞书管理后台进行应用上线审批
同步员工：
应用审核通过后，在七鱼系统中同步飞书员工信息到【外部员工管理】，可以使飞书员工在不登录网易七鱼账号密码的情况下即可直接在飞书中查看及处理工单。如图10:
图10：应用完成后，同步员工
授权im工单权限：
在七鱼【员工管理-外部员工管理】中为飞书员工开启im工单权限，如图11、图12
图11:为飞书员工开启im工单权限
图12:即可使用
这篇文档有帮助吗？