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

C2cDeliveryReceipt

2026-07-24
POST

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

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

服务端调用此接口可以代替消息接收方上报送达状态。调用成功后,消息发送方会收到对应消息的送达回执推送。

说明
FromUserId 为接收方(操作者),ConvId 为单聊对端用户 ID(通常为消息发送方)。

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

Request

Query Parameters

    Action string必填

    可选值: [C2cDeliveryReceipt]

    接口原型参数

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

    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必填

    操作者(消息接收方),需要是已注册状态。

    ConvId string必填

    会话 ID,即单聊对端用户 ID。

    ConvMsgSeq number[]必填

    需要设置已送达回执的消息序号,单次最多 10 条。

Responses

OK
Schema
    Code number

    返回码。(0表示成功)

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

    返回码说明解决方案
    660000002参数错误请检查参数
    660300005频率限制请稍后再尝试
    660400102传入的回执消息数量超出上限单次最多 10 条,请减少后重试
    660400104设置单聊的回执消息异常联系技术支持
    Message string

    返回状态信息。

    RequestId string

    请求唯一标识。

    DeliveredTime number

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

上一篇

设置群聊消息已读回执

下一篇

设置群聊消息已送达回执

当前页

返回到顶部