七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入

官网渠道接入方案

1.1 设计目标

用于各类网页端的官网渠道接入网易云商-智能客服平台七鱼。

  • 对于服务提供方来讲,通过服务标准化,能够清晰而简洁的表达本服务提供了哪些接口、定义、以及他们所应实现的具体功能,并且任何对该服务所提供的能力有依赖的应用,都必须按照这套对接方案来实现服务供应;
  • 对于服务依赖方来讲,(即使用该服务的应用)能够清晰而简洁的快速按照网易七鱼提供的接入文档来完成官网的渠道接入,实现了自由切换服务咨询的接待渠道直达网易七鱼新平台的高速体验。

1.2 概念定义

网易七鱼官网接入有一些定义,如下几点说明:

  1. 服务即接入。我们这里定义的服务,从概念上理解,这是一个对应用能力的抽象表达;但是从实际操作层面,服务的实际体现方式,就是用户在智能客服平台获取x相应的咨询答案和需求的响应。
  2. 匿名用户。我们客服人员在进行服务接待的时候会出现不知道对方具体信息的情况,此时我们系统内会将该咨询的访客定义为匿名用户,表现为该用户的名称显示为Guest开头的形式。
  3. 网易七鱼SDK。是由网易七鱼官方提供的一套接入智能客服平台的底层能力的聚合呈现。

2. 接入方案

基于我们网易云商-智能客服系统七鱼的接入,本章提供了二种官网渠道快速接入网易七鱼的方案。一个是匿名的官网接入方案,另一个是使用网易七鱼提供的SDK方案进行接入。

2.1 匿名接入方案

  1. 需要先登录网易七鱼商务侧给我们开通的智能客服平台,登录的地址,账号和密码会在系统开通的同时由网易七鱼的商务同学给予。
  2. 登录七鱼智能客服平台后找到**服务中心-设置-会话流程-会话分配-自定义链接分配,**将这个链接的地址复制即可。链接的声明地址入口,见下图:
  3. 每条链接唯一且永久有效,将该链接放到我们官网咨询的渠道上即可。

匿名接入实现效果

当访客点击进线咨询后,访客端看到的样式如下:

当前正在接待的客服人员,在七鱼智能客服平台看到的样式如下:

2.2 SDK接入方案

  1. 需要我们内部的研发人员,在对应WEB官网的前端代码中新增一个body体,来嵌入七鱼的接入模块。
  2. 接入示例如下:
<!DOCTYPE html>
<html lang="en">

<head>
<title>在线客服</title>
<meta charset="utf-8"/>
</head>

<body>
<script>
 (function (w, d, n, a, j) {
  w[n] = w[n] || function () {
   (w[n].a = w[n].a || []).push(arguments);
  };
  j = d.createElement('script');
  j.async = true;
  j.src ='[https://qiyukf.com/script/APPKEY.js](https://qiyukf.com/script/APPKEY.js)';//APPKEY需要自行更替为具体的appkey值
  d.body.appendChild(j);
 })(window, document, 'ysf');
</script>
</body>

</html>
  1. APPKEY更替具体值的操作步骤如下:

  1. 完成上述操作流程后,在我们WEB官网的页面会出现一个在线咨询的按钮。按钮的样式如下所示,可以根据自我的喜好,选择对应的图标类型和图标的颜色。

  1. 访客接待页面的设计如下,可以自行修改整体的页面颜色和功能设置点。

WEB官网测试流程

  1. 接入后,WEB官网页面会出现对应的在线咨询的按钮,如下所示:

  1. 进入咨询的页面样式如下,可以在我们访客端的样式设置中进行整体页面的功能设置。

  1. 此时我们只能客服平台就可以看到有访客咨询进线了,正常进行问题的回复和解决即可。

这篇文档有帮助吗?

目录