# onChatBadgeChange(Object object)

监听某个群未读消息数变化
**注意事项**：注意事项：
- 小程序调用该接口前，需要确保已经调用 [requestAccess](https://open.feishu.cn/document/uYjL24iN/uUzMuUzMuUzM/requestaccess) ( 如需兼容 飞书V6.9.0 以下版本，可使用 [login](https://open.feishu.cn/document/uYjL24iN/uYzMuYzMuYzM) )。
- 需要读取群信息权限，接口才能调用 读取群信息(im:chat.group_info:readonly)

## 支持说明

应用能力 | Android | iOS | PC | 预览效果
---|---|---|---|---
小程序 | V3.10.0+ | V3.10.0+ | V3.10.0+ | 预览
网页应用 | V7.10.0+ | V7.10.0+ | V7.10.0+ | /

## 输入

名称 | 数据类型 | 必填 | 默认值 | 描述
---|---|---|---|---
[openChatId](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description) | string | 是 | &nbsp; | 获取会话信息的会话Id<br>**示例值**: oc_7dab8a3d3cdcc9da365777c7ad535d64
onChange | function | 是 | &nbsp; | 回调函数

## 输出
`onChange`回调函数返回对象的属性：

名称 | 数据类型 | 描述
---|---|---
badge | number | 未读消息数

## 示例代码

```js
tt.onChatBadgeChange(
  {
    openChatId: 'oc_7dab8a3d3cdcc9da365777c7ad535d64',
    onChange: (res) => {
      console.log(res.badge)
    }
  }
)
```

回调函数返回对象示例：

```json
{
  badge: 10
}
```