在线客服对接

本文档共分为场景概述及对接步骤两部分。目录如下：

1.应用场景及优势
- 1.1 在线客服应用场景
- 1.2 在线客服优势
2.在线客服对接配置说明

1.应用场景及优势

1.1 在线客服应用场景：

<1 网站在线客服

主要应用于：以网上贸易为主的B2C电子商务性质的网站和网店、以咨询为主的网站、有意识塑造电子商务品牌形象的企业站点、B2B门户网站。

<2 H5在线客服

主要应用于：您自己的官网，微信商城，APP等任何可以发起https请求打开新的h5界面地方。您也可以将此链接分享到各种社交平台，让用户随时随地都能联系到您。

1.2 在线客服优势：

降低运营成本
进行无缝沟通
保证监控管理
更灵活的多网站管理

2.在线客服对接配置说明

七陌系统提供在线客服对接。当用户点击网站上对接好的在线客服功能按钮的时候，可以直接在网页上与客服进行交流。具体对接步骤如下所示：

2.1 第一步：添加网页渠道

注意：添加网页渠道时的默认流程是可以自定义的，可以在流程管理中通过拖曳的方式自定义流程

2.2 网站接入：获取js代码

进入菜单，设置》渠道管理》网页》接入代码。

PC端使用的是js接入的方式。只需将以下代码复制到您自己网站的标签内即可，顺序不做强制规定，但建议放在最后面。

【】里的内容是后台根据账户和渠道返回的，需要替换

规则介绍：

<script type="text/javascript" src="【协议://域名:端口】/initWebimClientV7.js?accessId=【渠道id】 async></script>

使用样例：

<script type="text/javascript" src="https://www.xxxxx.com/initWebimClientV7.js?accessId=xxxxxxxxxxxxxxxxx" async></script>

PC端和H5端均提供userParams和otherParams这两个额外自定义参数，需要在用户页面的<script>标签内进行自定义，且需要在加载V7访客端的script标签之前定义好该对象，定义形式如下所示：

// 为了避免命名冲突，增加前缀，该对象将识别为 userParams 对象
var v7WebchatUserParams = {
    "uid":"333333333",
    "nickName":"4444444444",
    "avatar":"https://img2.baidu.com/it/u=2421505363,3507499484&fm=26&fmt=auto&gp=0.jpg",
    "otherField":"2333333????3333",
}
// 同上，增加前缀，识别为 otherParams 对象
var v7WebchatOtherParams = {
    // 比如，某用户A，想要传一个性别字段
    "gender": "male", // 字符串 | 数值 | 布尔值 | 对象 | 函数 | null | ...
}

2.3 h5外链方式

2.3.1 获取h5外链url

在H5当中直接打开该链接即可，可以放到a标签的herf属性中或是通过webview组件嵌套，也可以进行自定义。