更新日期：2021-05-28
网易七鱼提供围绕客户服务与智能营销的 SaaS 产品，融合智能机器人、在线客服、呼叫中心、外呼机器人、营销机器人、智能质检、工单与精准营销等功能，驱动企业服务效率与智能营销能力升级。
本文档旨在为七鱼客户的开发者们提供便捷的接入渠道指导，帮助您快速完成对应产品模块的集成上线。
整体接入流程如下：
本文档仅包含快速接入所需完成的工作，如您有机器人一触即达、工单对接、CRM接口对接、iFrame接入、外呼机器人接口对接等高级应用需求，可前往七鱼开发者帮助中心：http://docs.qiyukf.com/获取更全面的指南。
一、接入准备
1.1. 软件终端准备
七鱼客户端：七鱼Windows版下载地址，客户端内直接登录。
1.2. 确保企业已完成认证
必须完成企业认证方可进行在线坐席或呼叫坐席的接入，请您与业务部门确认已完成认证，附企业认证流程说明
二、在线坐席接入
2.1. 获取AppKey和AppSecret
AppKey是企业开发接入唯一标识，AppSecret用来做数据完整性校验，是客户服务器向网易七鱼服务发送数据时的必要参数。
获取地址：登录七鱼—系统管理—扩展与集成—开发者ID
2.2. 根据接入渠道选择接入方式
工作量为历史客户平均耗时，实际接入时因业务特性会存在些许偏差请见谅。 综合考虑对接难度及可扩展性，我们给出了推荐的接入方式：
对接渠道 | 接入方式 | 工作量(人天) | 难度 | 对接文档 | demo链接 |
Web网站 | Web-JS接入（推荐） | 2 | 简单 | ||
Web网站 | web纯链接接入 | 0.5 | 简单 | ||
移动App | App-SDK接入（推荐） 单终端-iOS/Android | 5 | 中等 | ||
移动App | App-H5对接 | 3 | 中等 | ||
微信公众号 | 扫码授权（推荐） | 无 | 简单 | ||
微信公众号 | 微信H5接入 | 2 | 中等 | ||
企业微信 | 扫码授权（推荐） | 0.5 | 简单 | ||
企业微信 | 企微H5接入 | 2 | 简单 | ||
微信小程序 | 扫码授权（推荐） | 0.5 | 简单 | ||
微信小程序 | 微信小程序SDK接入 | 3 | 中等 | ||
微信小程序 | 微信小程序H5接入 | 2 | 中等 | ||
新浪微博 | 原生授权（推荐） | 0.5 | 简单 | ||
百度营销 | 原生授权（推荐） | 0.5 | 简单 | ||
抖音企业号 | 原生授权（推荐） | 0.5 | 简单 |
2.3. 完成接入
根据对应接入方式的详细开发指南，完成在线坐席的接入。
如遇到困难或bug，可通过七鱼在线客服进行咨询，网易的技术支持工程师会进行响应支持，指导您完成在线坐席的接入。
2.4. 测试上线
- 登录七鱼，切换到客服工作台；
- 将在线客服状态更改为“在线”；
- 从接入渠道的访客入口发送消息；
- 在客服工作台与访客完成消息互动
- 查看在线会话记录，回看文本聊天内容等。
若以上四步消息畅通，恭喜您，完成了在线坐席的接入！
三、呼叫坐席部署
呼叫坐席部署分为线路部署和管理配置两大步骤，无需开发者进行代码集成。线路部署需提交材料给到网易七鱼商务人员，由网易实施团队进行线路部署。
3.1 线路资料提交
请根据线路类型，提交对应申请表给到服务您的网易七鱼商务，由商务提交内部流程至网易七鱼实施团队，实施专家会在收到申请后的2个工作日内联系您。
3.2 线路部署
纯云线路均由网易实施专家进行配置，并在配置完成后通知到您。
混合云线路部署需要您进行网络配置、电话线路连接、接受远程协助等基础配合工作，请您届时保持电话畅通。
在您提交线路部署申请后的3个工作日内，实施工程师会完成线路部署。
3.3 SIP话机配置 （可选）
七鱼呼叫中心支持软电话和SIP话机接听，软电话无需配置可直接使用，SIP话机接听需要在话机进行SIP账号配置，具体配置文档请参考：SIP话机配置手册。
该配置工作建议请业务部门协调IT或网络中心同事协助配置。
3.4 测试上线
- 登录七鱼，切换到客服工作台；
- 将呼叫客服状态更改为“在线”；
- 通过个人手机或其他座机拨打企业中继号码；
- 在客服工作台接听访客来电；
- 查看通话记录，回访录音等。
若以上五步流程畅通，恭喜您，完成了呼叫坐席的部署！
四、高级配置
在线会话中的欢迎语、客服头像等配置，以及呼叫系统中的ivr配置，请开发者联系内部对应业务部门登陆七鱼后台进行配置。
五、线上运维
- 新增渠道：可根据第二章在线坐席接入指南，自行新增其他渠道；
- 新增呼叫线路：可再次提交线路申请表，申请开通新线路；
如在对接过程中遇到问题可通过以下方式获得帮助：
- 在线服务：管理端-后台点击右上角联系客服；客服端-后台点击右上角帮助-联系客服；服务时间：工作日9:00-18:00，节假日9:00-12:00，13:30-18:00
- 电话服务：拨打4009000163进行电话咨询，工作日9:00-18:00；