用户信息

现在你可以用更简单、更清晰的方式设置、更新用户信息。

API

updateUserInfo()

你可以在任意位置调用此方法来按需更新当前登录用户的信息：

let userConfig = {
  userName: "AIHelper",
  userTags: "recharge,suggestion",
  customData: {
    key: 'value'
  }
};
AIHelpSupport.updateUserInfo(userConfig);

resetUserInfo()

调用此方法会重置当前登录用户的信息：

AIHelpSupport.resetUserInfo();

URL

或者，你也可以通过拼接 URL 的方式实现同样的需求：

<script>
  let domain = "THIS IS YOUR APP DOMAIN";
  let appId = "THIS IS YOUR APP ID";
  let entranceId = "THIS IS YOUR ENTRANCE ID";
  (function () {
    let baseUrl = `https://${domain}/webchatv5/#/${appId}`;
    let params = `entranceId=${entranceId}&userName=${your_user_name}&userTags=${your_user_tags}&customData=${encodeURIComponent(JSON.stringify({key:"value"}))}`;
    let url = `${baseUrl}?${params}`;
    window.open(url);
  })();
</script>

参数释义

userConfig API

• 类型：object
• 详情：可选参数。 仅在 API 方案中生效，用于对用户信息进行自定义配置。

userId

• 类型：string
• 默认值：用户设备随机字符串
• 详情：可选参数。 用户唯一标识，不可以设置为空字符串、0 或 -1

userName

• 类型：string
• 默认值：anonymous
• 详情：可选参数。 用户名称

serverId

• 类型：string
• 默认值：-1
• 详情：可选参数。 用户所在服务器 ID

userTags

• 类型：string
• 默认值：''
• 详情：可选参数。 用户标签，多个标签之间需要以「,」分隔。另外，在具体为用户配置标签时，你应该确保已经提前在 AIHelp 后台配置好了对应的标签内容：

customData

• 类型：object API
• 类型：string URL
• 默认值：{} | ''
• 详情：可选参数。 自定义用户数据，格式为 jsonString: {"key":"value", "key":"value"}。
• 其它：使用 URL 方案配置 customData 字段时，需要先用 encodeURIComponent API 对数据进行转码，然后再做参数的拼接。

场景假设

让我们来假定一个场景，你希望在 AIHelp 后台统计到用户的某些信息，具体如下：

1、当前用户等级；

2、充值记录；

3、用户存量金币数量；

那么，针对这个场景的代码实现如下所示：

API

let userConfig = {
  userName: "AIHelper",
  userTags: "recharge,suggestion",
  customData: {
    level: 34,
    total_recharge: 300,
    remaining: 56,
  }
};
AIHelpSupport.updateUserInfo(userConfig);

URL

<script>
  let domain = "THIS IS YOUR APP DOMAIN";
  let appId = "THIS IS YOUR APP ID";
  let entranceId = "THIS IS YOUR ENTRANCE ID";
  let customData = {
    level: 34,
    total_recharge: 300,
    remaining: 56,
  };
  (function () {
    let baseUrl = `https://${domain}/webchatv5/#/${appId}`;
    let params = `entranceId=${entranceId}&userName=${your_user_name}&userTags=${your_user_tags}&customData=${encodeURIComponent(JSON.stringify(customData))}`;
    let url = `${baseUrl}?${params}`;
    window.open(url);
  })();
</script>

页面示例

配置完成后，当这个用户发起一条客诉时，你就可以在 AIHelp 后台看到如下效果：