开发指南

# CRM对接

在小程序会话接入时，通过session-from属性将包含用户信息的JSON数据放在ysf.config字段中传递给网易七鱼系统。示例如下：

<button
  type="primary"
  size="40"
  session-from="nickName={{userInfo.nickName}}|avatarUrl={{userInfo.avatarUrl}}|foreignid={{userInfo.foreignid}}|referrerTitle={{ysf.title}}|ysf.config= {{ysf.config}}"
  open-type="contact"
>点我给客服发送消息</button>

表一: session-from 字段说明

参数
 类型 必须 说明
nickName String 否 用户昵称
avatarUrl String 否 用户头像
foreignid String 否 用户唯一性标识
ysf.config -- 否 用户信息（详见表二）

表二: ysf.config 字段说明

参数
 类型 必须 说明
level String 否 vip等级
data Array / String 是 用一个数组（或表示 JSON 数组的字符串），表示要显示在客服端的扩展信息（详见表三）

ysf.config 数据格式如下：

ysf:{
      title: '详情页',
      config: JSON.stringify({
        "level":1,  // vip等级
        "data": JSON.stringify([
            { "key": "email", "value": "13800000000@163.com" },
            { "index": 0, "key": "account", "label": "账号", "value": "zhangsan", "href": "http://example.domain/user/zhangsan" },
            { "index": 1, "key": "sex", "label": "性别", "value": "先生" },
            { "index": 5, "key": "reg_date", "label": "注册日期", "value": "2015-11-16" },
            { "index": 6, "key": "last_login", "label": "上次登录时间", "value": "2015-12-22 15:38:54" }
          ])
      })
    }

其中data字段用一个数组描述用户的详细信息，数组中每个元素代表一个数据项。数据项以<key, value>对的形式为基础，增加了额外的字段以控制显示样式。数据项定义如下：

表三: data 字段说明

字段
 类型
必须
 说明
key String 是 数据项的名称，用于区别不同的数据。其中real_name、mobile_phone、email为保留字段，分别对应客服工作台用户信息中的“姓名”、“手机”、“邮箱”这三项数据。保留关键字对应的数据项中，index、label属性将无效，其显示顺序及名称由网易七鱼系统指定
value Mixed 是 该数据显示的值，类型不做限定，根据实际需要进行设定
label String 是 该项数据显示的名称
index Int 否 用于排序，显示数据时数据项按index值升序排列；不设定index的数据项将排在后面；index相同或未设定的数据项将按照其在 JSON 中出现的顺序排列
href String 否 超链接地址。若指定该值，则该项数据将显示为超链接样式，点击后跳转到其值所指定的 URL 地址
hidden Boolean 否 仅对mobile_phone、email两个保留字段有效，表示是否隐藏对应的数据项，true为隐藏，false为不隐藏。若不指定，默认为false不隐藏

注意： real_name、mobile_phone、email三个保留字段的特别说明：

  • 若使用保留字段，数据将对应显示在“姓名”、“手机”、“邮箱”的位置上，顺序、名称不能指定；
  • 若使用保留字段，“姓名”、“手机”、“邮箱”对应的数据将不可编辑，以传递的数据为准；在不使用保留字段的情况下，这三项内容以客服填写的为准，并且可以修改；
  • 其中mobile_phone、email两项可以通过hidden字段隐藏，real_name不可隐藏；
  • 如果既想通过轻量对接提供“姓名”、“手机”、“邮箱”这三项数据，又希望客服可以修改、维护这些信息，可以避开保留关键字，用不同的key来提供数据；这在访客改变了联系方式，但没有及时更新用户信息的情况下非常有用。

注意： 提交的数据将根据预设的样式直接显示在网易七鱼页面相应的位置上。如果数据敏感、保密性要求高，应当在提交时就做脱敏处理。网易七鱼系统不会对数据做额外的处理。

← 访客分配 →