电商平台对接

一.商户对接

对接步骤

操作步骤:管理员坐席登陆云客服,点击商户管理

商户管理 —> 一键开户

在开户页面配置商户的一些基本信息

在商户接入设置 —> 查看 获取商户的接入号ID

卡片接口对接

设置地址:系统设置 —> 对接设置 —> 商品信息填写已运行的url地址

示例:

http://140.143.60.140:8223/

接口鉴权:鉴权信息所使用的token和nonce,请在电商版平台端-系统设置-对接设置中获取。

鉴权处理流程:

1)获取请求参数token、timestamp
2)根据token查询nonce值
3)按照token、timestamp、nonce的顺序拼接成字符串,使用sha1算法计算signature值
4)和上送的signature值进行匹配,一致则鉴权成功
5)返回商品信息

请求参数:




字段名 备注
token 系统获取的token
timestamp 时间戳(毫秒)
nonce 系统获取的nonce
commodityId 访客端传的商品id

示例:

http://140.143.60.140:8223/?token=ezYuHCVU6f1KnqWjpN1TGYDztzBXwzNqiXagyvQtszI&timestamp=1586331608718&signature=0a0f24c590e83b330ba6a9b0830baa6f1f6dfb3c&commodityId=12345

请求头:无

请求体:无

接口返回示例:

{
    "data":{
        "price":"¥79.00",
        "imageUrl":"https://img10.360buyimg.com/n6/jfs/t1/88425/40/12091/294889/5e414e07Ecbd6b1b0/712bf44595d18f01.jpg",
        "name":"一次性手套橡胶手套女塑胶男家用纹绣pvc手套透明检查胶皮薄款乳胶胶皮手套丁晴手套 PVC盒装【100只】 均码",
        "desc":""
    }
}

二.访客端对接

访客端对接需要客户这边自定义一个按钮调用点击方法打开访客端咨询页面

1.对接点击方法:

注:如果登录平台域名是ecom.7moor.com,则需要把下面的跳转域名改成echat.7moor.com

  function accessDemoFun (data) {
      let popup = window.open('https://yechat.7moor.com/index/' + data.accessId)
      let timer=setTimeout(function () {
          try {
              popup.parent.postMessage({qmInitData: encodeURIComponent(JSON.stringify(data))}, '*')
              clearTimeout(timer);
          } catch(e){
              console.log(e)
          }
      }, 600);
  }

2.接入参数说明:

data: {
    accessId: '', // 接入号ID (参数类型:字符串,必传)
    userId: '',  // 访客id 自定义用户的唯一id,不能传空字符串、null、中文,id由字母大小写、数字及'-'和 '_'组成(必传)
    sidHeadImg: '', // 访客头像(参数类型:字符串,图片地址)
    nickName: '', // 访客名称(参数类型:字符串)
    venderId: '', // 商铺id (参数类型:字符串,用于展示右侧商铺信息)
    venderName: '', // 商铺名称(参数类型:字符串,用于展示右侧商铺信息)
    venderHeadImg: '', // 商铺头像 (参数类型:字符串,图片地址,用于展示右侧商铺信息)
    commodityId: '', // 正在咨询的商品(参数类型:字符串)
  }

3.接入示例:

自定义咨询点击按钮,点击执行定义好的accessDemoFun方法
<button onclick="accessDemoFun(data)"></button>