H5客服

接口说明

用于从游戏内跳转至H5客服页面。

sdkInstance.openCustomerService(options);

最低基础库版本要求

若用户客户端基础库版本低于 2.0.3，调用 sdkInstance.openCustomerService(options) 接口将中断用户当前操作并弹出升级提示，不会报错！

参数说明

参数说明如下表所示：

选项	类型	必填	默认值	说明
areaId	string / number	否	1	游戏大区ID，若游戏无大区概念，可不填，默认值为 1，表示初始大区编号
roleId	string / number	否	同 accountId	角色ID，若游戏无角色概念，可不填，默认值同 accountId 账号ID
roleName	string	否	--	角色昵称
roleLevel	number	否	1	角色等级，若游戏无角色及等级概念，可填关卡等级或不填，默认值为 1
success	function	否	--	接口调用成功的回调函数
fail	function	否	--	接口调用失败的回调函数
complete	function	否	--	接口调用完成的回调函数，成功或失败均会调用

特别说明

由于微信的策略限制，游戏内不支持内嵌或直接跳转至H5页面，因此跳转H5客服的行为受到一定限制；目前SDK采用了一种变通方法，先由游戏内跳转至微信原生客服会话，再由客服会话窗口跳转至H5客服页面，具体操作流程如下：

点击按钮 > 调用客服接口 > 向用户弹出“即将进入xxxx客服会话” > 确认并进入客服会话 > 发送关键词“联系客服” > 客服自动回复H5客服链接 > 点击链接进入客服页面 > 进行问题反馈或其它操作

注意事项

若在用户进入客服会话并发送关键词后，客服没有自动回复H5客服链接，请咨询SDK服务端开发：陈肖军！

示例代码

注：示例代码中的参数或选项均为演示数据，仅供参考，谢谢！

// 若用户客户端基础库版本低于 2.0.3，调用此接口将中断用户当前操作并弹出升级提示，不会报错！
sdkInstance.openCustomerService({
  areaId: 1001,
  roleId: "123456",
  roleName: "小朋友",
  roleLevel: 1,
  success: function(response) {
    console.log(response);
  },
  fail: function(error) {
    console.log(error);
  },
  complete: function(result) {
    // do something here...
  }
});