# wx.getChatToolInfo(Object object)

基础库 3.7.8 开始支持，低版本需做兼容处理。

以 Promise 风格调用：支持

小程序插件：不支持

相关文档: 聊天工具模式

# 功能描述

获取聊天工具模式下的群聊信息。

需要注意的是，单聊群和多聊群下返回的群唯一标识是不同的。

多聊群下返回 opengid
单聊群下返回 open_single_roomid

同时将返回用户在群(含单聊)下的唯一标识 group_openid。

# 参数

# Object object

属性	类型	必填	说明
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

# object.success 回调函数

# 参数

# Object res

属性	类型	说明
errMsg	string	错误信息
encryptedData	string	包括敏感数据在内的完整转发信息的加密数据，详细见加密数据解密算法
iv	string	加密算法的初始向量，详细见加密数据解密算法
cloudID	string	敏感数据对应的云 ID，开通云开发的小程序才会返回，可通过云调用直接获取开放数据，详细见云调用直接获取开放数据

# 示例代码

wx.getChatToolInfo({
  success(res) {
    // res
    {
      errMsg: 'getChatToolInfo:ok',
      encryptedData: '',
      iv: ''
    }
  },
  fail() {

  }
})

敏感数据有两种获取方式，一是使用加密数据解密算法。获取得到的开放数据为以下 json 结构（其中 opengid 为当前群的唯一标识）：

{
 "opengid": "OPENGID",       // 多聊群下返回的群唯一标识
 "open_single_roomid": "",   // 单聊群下返回的群唯一标识
 "group_openid": "",         // 用户在当前群的唯一标识
 "chat_type": 3,             // 聊天室类型
}