# getChatInfo
获取某个会话的信息
注意事项:
小程序调用前,请确保已经调用login接口成功登录;
# 支持说明
应用能力 | Android | iOS | PC | 预览效果 |
---|---|---|---|---|
小程序 | 3.5.0 | 3.5.0 | 3.7.0 | 扫码预览 用BoosHi扫码或PC端点击 |
网页应用 | 待开发 | 待开发 | 待开发 | 待补充 |
# 输入
继承标准对象输入,扩展属性描述:
名称 | 数据类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
openid | string | 否 | 用户 open_id 3.11.0支持 单聊 :开放平台openid机器人 :加密的bosshi userid(开放平台目前没有属于机器人的openid)示例: ou_aea5df288c71a47af6ccd786c05be939 | |
openChatId | string | 否 | open_chat_id 3.10.0-: 单聊 :明文bosshi userid机器人 :明文bosshi userid群聊 :明文bosshi群聊id示例 :2010273.10.0: 单聊 :加密的bosshi userid机器人 :加密的bosshi userid群聊 :加密的bosshi群聊id示例 :89EDAB2A519AB20BDAFC43864D2957D913.11.0: 仅支持开放平台 openChatId (群聊) 示例 :ou_aea5df288c71a47af6ccd786c05be939 | |
chatType | number | 是 | 会话的类型 3.11.0开始废弃 示例值:0 可选值: * 0 :单聊* 1 :群聊 | |
userType | number | 否 | 单聊用户类型 3.11.0开始废弃 示例值:0 可选值: * 0 :用户* 1 :bot |
# 输出
继承标准对象输出
success
返回对象的扩展属性:
名称 | 数据类型 | 描述 |
---|---|---|
i18nNames | object | 国际化会话名(可能为空) |
∟ zh_cn | string | 中文名,可能为空 |
∟ en_us | string | 英文名,可能为空 |
∟ ja_jp | string | 日文名,可能为空 |
name | string | 会话名称 |
avatarUrls | string[] | 会话的头像url数组,包含多种图片分辨率 |
atCount | number | 被at数量暂不支持 |
badge | number | 未读消息数 |
# 示例代码
bz.getChatInfo(
{
openChatId: '',
openId: '',
success (res) {
console.log(JSON.stringify(res));
},
fail (res) {
console.log(`getChatInfo fail:${JSON.stringify(res)}`);
}
}
)
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
success
返回对象示例:
{
"atCount": 0,
"avatarUrls": [],
"badge": 29,
"i18nNames": {
"en_us": "",
"zh_cn": ""
},
"name": "ios群聊",
"errMsg": "getChatInfo:ok"
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11