即时通讯
机器人
ZIM Audio
当前页

GroupReadReceipt

2026-04-29
POST

https://zim-api.zego.im/

通过该接口可以给某个用户发送的群聊消息设置已读回执。

说明
调用频率限制:20 次/秒。

Request

Query Parameters

    Action string必填

    可选值: [GroupReadReceipt]

    接口原型参数

    https://zim-api.zego.im/?Action=GroupReadReceipt

    AppId uint32必填

    💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。

    SignatureNonce string必填

    💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例

    Timestamp int64必填

    💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。

    SignatureVersion string必填

    可选值: [2.0]

    默认值: 2.0

    💡公共参数。签名版本号。

    Signature string必填

    💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。

Body

required
    FromUserId string必填

    操作者,需要是已注册状态。

    GroupId string必填

    群聊 ID。

    ConvMsgSeq number[]必填

    需要设置已读回执的消息序号。

Responses

OK
Schema
    Code number

    返回码。(0表示成功)

    以下仅列出了接口业务逻辑相关的返回码,完整返回码请参考 全局返回码

    返回码说明解决方案
    660000002参数错误请检查参数
    660300005频率限制请稍后再尝试
    660400102传入已读回执消息数量超出上限联系技术支持
    660400103设置群聊消息已读回执异常联系技术支持
    Message string

    返回状态信息。

    RequestId string

    请求唯一标识。

    ReadTime number

    对于接收者,已读回执成功时的服务端时间戳。

上一篇

设置单聊消息已读回执

下一篇

发起呼叫邀请

当前页

返回到顶部