# 查询批量消息推送和阅读人数

注意事项:

  • 返回值为查询时刻的快照数据
  • 只能查询批量发送的消息

# 请求

基本
HTTP URL https://hi-gw.weizhipin.com/open-apis/im/v2/batch_messages/:batch_message_id/read_user
HTTP Method GET
支持的应用类型 自建应用
商店应用
权限要求开启任一权限即可 批量向用户发送消息
批量向部门发送消息

# 请求头

名称 类型 必填 描述
Authorization string tenant_access_token
值格式:"Bearer access_token"
示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560"

# 路径参数(url中冒号标识的参数,如":xxxx"请连同:整体替换成对应值)

名称 类型 描述
batch_message_id string 待查询的批量消息的ID
示例值:"bm_dc13264520392913993dd051dba21dcf"

# 响应

# 响应体

名称 类型 描述
code int 错误码,非 0 表示失败
msg string 错误描述
data - -
 ∟read_user_ids string[] 已读用户Id
字段权限要求
获取用户 user_id(仅自建应用)
 ∟un_read_user_ids string[] 未读用户Id
字段权限要求
获取用户 user_id(仅自建应用)
 ∟read_open_ids string[] 已读open_i️id
 ∟un_read_open_ids string[] 未读open_id

# 响应体示例

{
    "code": 0,
    "traceId": "_Ao59UOIBLPCeAAu",
    "data": {
        "read_user_ids": ["xxxx","xxxx"],
        "un_read_user_ids": ["xxxx","xxxx"]
    },
    "msg": "ok"
}
1
2
3
4
5
6
7
8
9
最后更新于 : 3/4/2024, 3:29:16 PM