发送单聊消息已读回执回调事件

大约 2 分钟

发送单聊消息已读回执回调事件

功能说明

成功发送单聊消息已读回执后,IM 服务器会按照 发送后回调规则 向你的 App Server 发送回调请求,App Server 可通过该回调已读回执信息,进行数据同步。

前提条件

已在 声网控制台open in new window 设置发送后回调规则。详见 配置回调规则

回调时机

客户端发送了单聊消息已读回执

回调请求

请求示例

下面的请求示例为发送单聊消息已读回执。

{
    "chat_type": "read_ack",
    "callId": "XXXX#XXXX_968665325555943556",
    "channel_channel": "XXXX#XXXX_2222@conference.easemob.com",
    "security": "bd63d5fa8f72823e6d33e09a43aa4239",
    "payload": {
        "ext": {},
        "ack_message_id": "968665323572037776",
        "bodies": []
    },
    "host": "msync@ebs-ali-beijing-msync45",
    "from": "1111",
    "to": "2222",
    "eventType": "chat",
    "msg_id": "968665325555943556",
    "timestamp": 1643099771248
}

请求字段说明

字段数据类型含义
chat_typeStringread_ack 已读回执。
callIdString回调请求的唯一标识。
channel_channelString单聊消息的已读回执,格式为 App Key_接收已读回执用户 ID@conference.easemob.com,例如,示例中的 easemob-demo#wang_277721224642561@conference.easemob.com
securityString签名,格式如下: MD5(callId+secret+timestamp)配置回调规则 后,IM 服务器会自动为该规则生成 secret,向你的 App Server 发送数据时会基于该 secret 生成该签名,作为你的服务器识别 IM 服务器的依据。若要使用自定义密钥,可联系声网商务。
payloadobject包括:
- ext:消息扩展字段
- ack_message_id:消息 ID
- bodies:消息体内容。
hostString服务器名称。
fromString发送已读回执用户 ID。
toString接收已读回执用户 ID。
eventTypeStringchat:表示上行消息。
timestamplong即时通讯 IM 服务器收到消息已读回执的 Unix 时间戳,单位为 ms。
msg_idString该回执消息的消息 ID。
上次编辑于: