99客服系统用户手册

Appearance

用户扩展信息对接 ​

进行用户扩展信息对接前，需要先在客服端定义访客属性。定义完成后，网站接入时才能按字段 key 传递用户的电话、姓名等资料，并在客服对话侧显示。

进入访客字段设置 ​

在客服端打开 菜单，进入系统设置区域，点击 访客字段。该入口用于管理需要从网站用户系统传入的访客扩展属性。

访客字段设置入口

设置访客属性 ​

在访客预设字段页面中，为每个属性设置字段名称、字段 key 和字段类型。例如：

  • 电话：字段 key 为 phone，字段类型选择“电话”。
  • 姓名：字段 key 为 name，字段类型选择“文本”。

字段 key 是网站接入时使用的唯一标识，保存后不能修改；网站传入的 key 必须与此处保持一致。

访客属性设置页

完成字段设置并保存后，再在网站接入代码中传递对应的用户扩展属性，客服即可在访客资料区域查看这些信息。

HTML 接入示例 ​

下面示例在初始化客服挂件时传递电话和姓名两个扩展属性。保存为 user-extended-info-test.html 后即可用于测试：

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>用户扩展信息测试</title>
</head>
<body>
  <script src="https://live.99kf.com/static/js/kf.js"></script>
  <script>
    window.kfVisitor = KFVisitor.init({
      businessId: 'afxGIDLM',
      groupId: 0,
      baseUrl: 'https://live.99kf.com',
      displayMode: 'floating',
      visitor: {
        attributes: [
          {
            key: 'phone',
            label: '电话',
            type: 'phone',
            value: '13800138000'
          },
          {
            key: 'name',
            label: '姓名',
            type: 'text',
            value: '张三'
          }
        ]
      }
    });
  </script>
</body>
</html>

visitor.attributes 中的 key、label 和 type 应与访客字段设置保持一致；实际接入时，将 value 替换为业务系统中的用户数据。

最终效果 ​

访客发起会话后，传入的扩展属性会显示在客服端右侧的访客资料区域，客服可以直接查看电话、姓名等信息。

用户扩展信息在客服端的展示效果