网易七鱼接入指南

常见问题 3个月前 (10-12)  

%e6%8e%a5%e5%85%a5%e6%8c%87%e5%8d%97

七鱼的接入方式有三种:网站、app和微信公众号。下面为大家介绍下三种渠道的接入步骤和适用场景。

 

 

一、WEB、H5、WAP接入

1、 WEB SDK接入

通过SDK接入,操作快捷成本低,可以带上访客信息,体验好。咨询入口位置固定位于页面的右下角。操作入口:七鱼管理员后台---设置---网站接入。请参考网易七鱼Web开发指南。https://qiyukf.com/newdoc/html/Web_SDK_Guide.html

1

 

2、链接接入

链接接入方便快速,而且可以自定义咨询入口的位置和样式。操作方式及效果和PC端的链接接入类似。但这种方式不能将访客身份信息带上来,会话结束之后无法再发起会话,找回访客。操作入口:管理员后台---设置---访客分配---Web端自定义链接分配

1

 

3、消息接口

消息接口方式适用于位置公众号、APP 内部分流,对接微博、游戏等其他通道。通过消息接口,企业可以对消息设置规则。在“消息与事件接收 url”后面的空格中,填入企业给七 鱼自行设置的 url。消息接口对比其他方式开发量较大,需要企业有一定的开发能力。开发前请仔细阅读消息接口接入文档: https://qiyukf.com/newdoc/html/message_interface.html 操作入口:七鱼管理员后台---设置---信息对接---消息接口接入

1

 

 

二、APP接入

1、APP SDK接入

APP SDK接入的优点是在对话框可以查看到历史消息记录,客服也可以主动发起会话,并且访客端也能收到消息推送。SDK包的会增加企业App的文件大小,接入后Android 增加500KB左右,iOS增加3MB左右。接入前,请详细阅读接入说明:

iOS SDK接入说明:http://qiyukf.com/newdoc/html/iOS_SDK_Guide.html

Android SDK接入说明:http://qiyukf.com/newdoc/html/Android_SDK_Guide.html

操作入口:七鱼管理员后台---设置---APP接入

1

 

2、链接接入

链接接入方便快速,而且可以自定义咨询入口的位置和样式。操作方式及效果和PC端的链接接入类似。但这种方式不能将访客身份信息带上来,会话结束之后无法再发起会话,找回访客。操作入口:管理员后台---设置---访客分配---Web端自定义链接分配

1

 

 

三、微信接入

1、授权接入

授权接入原生支持体验好,没有兼容性问题,无开发成本,仅需管理员授权即可。若企业对消息接口已经做过二次开发,可能出现一个消息被多次回复的情况。操作入口:管理员后台---设置---微信接入。

适用举例:七鱼官方公众号,已认证,未二次开发,未配置关键词自动回复,直接授权后即可使用。

1

注意事项:

1)接入后,原公众号设置的自动回复仍生效,但是回复可能与机器人消息重复,建议在七鱼机器人中重新配置问题和答案;

2)授权不再获取自定义菜单权限,管理员可以在微信后台对公众号自定义菜单进行设置,授权给七鱼不会影响其自定义菜单的配置;

3)该种方式只能适用于公众号已经认证过的企业选择(未认证公众号,可以完成授权,并在公众号发起会话,但由于权限限制,客服无法成功回复消息)!

 

2、H5链接接入

H5链接接入不影响微信公众号原有配置,例如消息自定义回复,和企业自定义消息接口。支持非认证服务号消息收发。退出页面后,若30s未重新进入,会判断为客户离开,再次进入需重新连接客服。需要设置跳转页面,有一定的开发成本。

接入方式举例1:管理员后台---设置---访客分配---Web端自定义链接分配

1

点击该链接会直接进入与客服的聊天界面,该种方式接入的访客只能是匿名用户,不能将用户信息传给七鱼,客服工作台显示的用户名称为guestXXX;

 

接入方式举例2:管理员后台---设置---网站接入

1

该种方法适用于点击某个按钮进入一个页面A,在该页面上接入七鱼,一般多用于接入微商城。该方式与第一种的区别在于,访客进入与客服的聊天界面的过程中增加一个跳转页面A,页面A是由用户自行开发的,可以支持在页面A上嵌入七鱼的JS,并且需要在客服工作台上显示用户信息的时候,调用ysf.config(),将用户信息传递给七鱼;

 

3、消息接口

消息接口不影响微信公众号原有配置及第三方开发,满足复杂的公众号接入需求,可以按照企业自己的客服分配原则进行公众号内部的指定客服/客服组分配。需要企业有一定开发能力。

接口调用流程如下:

1

详情请参考七鱼官网开发指南:https://qiyukf.com/newdoc/html/message_interface.html

 

 

四、常见问题

1、版本升级以后,代码会变吗?需要重新对接吗?

不会。版本切换会对功能做限制,但不会影响到企业账号信息,也无需重新对接。

 

2、CRM对接

一种是轻量对接, 用JS代码方式将访客信息传输上来(微信授权接入方式暂不支持)。http://qiyukf.com/newdoc/html/qiyu_crm_interface.html#轻量 CRM  对接。在这种方式下,客户的信息是储存在七鱼服务器上的;另一种是高级API对接, 企业提供标准接口将企业数据库(例如ERP和CRM)内的信息投影到七鱼客服工作台,做到数据隔离,数据库内的信息不会存储在七鱼服务器上。

 

3、SDK包是否增加APP大小?

SDK包的大小会增加您企业App的文件大小,Android 接入后大概会增加不到500KB,iOS大概会增加增加2~3MB的大小。

 

 

4、怎么体验客服跟访客聊天?

请在七鱼官网下载演示demo(http://qiyukf.com/download#id=1),在手机端安装demo以后,打开demo—设置—已绑定AppKey—扫一扫绑定,请使用demo扫描企业专属Appkey。企业专属Appkey位置,管理员后台—设置—App接入—Appkey。

 

5、微信授权给了其他平台,还可以授权给七鱼吗?

七鱼会获取消息管理和用户管理等与客户服务相关的权限,这些权限可以同时授权给多家,并且互不影响,您可以放心使用。网易七鱼不获取菜单权限,不影响开发者设置,也不影响您授权给其他第三方平台。

 

6、如果绑定了多个公众号,客服页面是否显示来自哪个公众号?

可以的哦,在会话右侧的用户信息—来源终端会直接展示。

1

 

7、微信怎么解除绑定?

在七鱼管理员后台—微信接入,找到对应的微信公众号,解除绑定以后,七鱼将不再获取权限。

1

您也可以在微信公众号运营后台—开发—基本配置--已授权的第三方平台--平台详情,点击取消授权。

1

1

 

8、进入咨询的客户姓名出现“临时用户名”,是什么原因?

客户姓名出现临时用户名的时候,说明该微信公众号没有认证。

 

9、七鱼接入微信后,聊天记录会在微信运营公众号保存吗?

① 如果是授权原生态接入,访客发的消息会在微信公众号运营后台和七鱼后台同时会收到,但是客服发出的消息不会经过微信公众号运营后台;也就是说在这个情况下,能在微信运营公众号后台看到访客所有的咨询消息,但是无法看到客服发出的消息。

② 如果是链接接入接入,访客和客服的消息都是不经过微信公众号运营后台。

③ 如果是自定义消息接口方式,访客和客服发的消息都会经过微信公众号运营后台。

 

10、微信接入机器人头像和客服头像相同?

微信头像的权限是微信后台设置的,没有开发给第三方,所以设置了机器人头像,人工客服头像也是跟机器人头像一样的。七鱼的后台是无法修改微信头像的。

 

11、当客服不在线的时候会提示“当前没有人工客服在线,回复1后,可以留言给人工客服,回复其他,继续与机器人对话” 如以下截图所示

1_meitu_1

 

12、当访客进入排队时,微信端跟web,app不同,不会显示排队人数,会提示“客服忙,正在排队中,请稍后…”如下图所示

1_meitu_2

 

13、在微信授权接入的前提下,会影响客户微信原有的自动回复,也就是建议客户关闭微信内置关键词自动回复,如截图所示的两类自动回复

1

 

14、微信公众号绑定个数的上限是多少?

50个

 

 

 

发表


表情

  1. ddd
    ddd 【农民】 回复

    你好你好