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

GET

/im/v1/batch_messages/{batch_message_id}/read_user

查询批量消息推送和阅读人数
注意事项：

只能查询通过批量发送消息接口产生的消息

该接口返回的数据为查询时刻的快照数据。

错误码

HTTP状态码	错误码	描述	排查建议
400	230001	Your request contains an invalid request parameter.	参数错误，请根据接口返回的错误信息并参考文档检查输入参数。
400	230012	Bot is NOT the sender of the message.	机器人不是消息的发送者。
400	230027	Lack of necessary permissions.	请根据本文档中的权限要求部分补充所需权限。
400	230030	The message id is invalid, record not found.	检查传入的batch_message_id是否正确。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数text/plain

示例

返回响应

🟢200200 Success

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/im/v1/batch_messages/bm_dc13264520392913993dd051dba21dcf/read_user' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: text/plain' \
--data-raw 'curl --location --request GET '\''https://open.feishu.cn/open-apis/im/v1/batch_messages/bm_dc13264520392913993dd051dba21dcf/read_user'\'' \
--header '\''Authorization: Bearer t-e811da948d9a2803433be10458f650c842799970'\'''

响应示例

{
    "code": 0,
    "data": {
        "read_user": {
            "read_count": "10",
            "total_count": "100"
        }
    },
    "msg": "ok"
}

修改于 2025-10-20 10:12:27

批量撤回消息

查询批量消息整体进度

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

错误码#

请求参数

返回响应

错误码