查询消息已读信息

GET

/im/v1/messages/{message_id}/read_users

查询消息的已读信息。
注意事项:

只能查询机器人自己发送，且发送时间不超过7天的消息

查询消息已读信息时机器人仍需要在会话内

本接口不支持查询批量消息

错误码

HTTP状态码	错误码	描述	排查建议
400	230001	Your request contains an invalid request parameter.	参数错误，请根据接口返回的错误信息并参考文档检查输入参数。
400	230002	The bot can not be outside the group.	机器人不在对应群组中。
400	230006	Bot ability is not activated.	机器人能力未启用。在开发者后台-应用功能-机器人页面开启机器人功能并发布上线。
400	230012	Bot is NOT the sender of the message.	机器人不是消息的发送者。
400	230027	Lack of necessary permissions.	请根据本文档中的权限要求部分补充所需权限。
400	230033	Get the reading status must be done within 7 days after the message is sent.	查询消息读取情况只能在发送消息后的7天内。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/im/v1/messages//read_users?user_id_type&page_size&page_token' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "user_id_type": "open_id",
                "user_id": "ou_9b851f7b51a9d58d109982337c46f3de",
                "timestamp": "1609484183000",
                "tenant_key": "736588c9260f175e"
            }
        ],
        "has_more": true,
        "page_token": "GxmvlNRvP0NdQZpa7yIqf_Lv_QuBwTQ8tXkX7w-irAghVD_TvuYd1aoJ1LQph86O-XImC4X9j9FhUPhXQDvtrQ=="
    }
}

修改于 2025-10-20 10:05:31

撤回消息

获取会话历史消息

查询消息已读信息

错误码#

请求参数

返回响应

错误码