发送单聊消息已读回执

大约 2 分钟

发送单聊消息已读回执

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

提示

  1. 你所使用的环信即时通讯 IM 的版本可能需要单独开通回调服务,详见 增值服务说明
  2. 如果需要发送单聊消息已读回执的回调事件,你需要在 环信控制台open in new window 配置发送后回调规则,详见 配置回调规则
  3. 发送后回调的相关介绍,详见 回调说明

回调时机

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

回调请求

请求示例

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

{
    "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",
    "appkey": "XXXX#XXXX",
    "from": "1111",
    "to": "2222",
    "eventType": "chat",
    "msg_id": "968665325555943556",
    "timestamp": 1643099771248
}

请求字段说明

字段数据类型含义
chat_typeStringread_ack 已读回执。
callIdStringcallId 为每个回调请求的唯一标识,格式为 “App Key_回执消息的消息 ID”。
channel_channelString单聊消息的已读回执,格式为 App Key_接收已读回执用户 ID@conference.easemob.com,例如,示例中的 easemob-demo#wang_277721224642561@conference.easemob.com
securityString签名,格式如下: MD5(callId+secret+timestamp)。 Secret 见 Console 后台回调规则
payloadobject包括:
- ext:消息扩展字段
- ack_message_id:消息 ID
- bodies:消息体内容。
hostString服务器名称。
appkeyString你在环信管理后台注册的应用唯一标识。
fromString发送已读回执用户 ID。
toString接收已读回执用户 ID。
eventTypeStringchat:表示上行消息。
timestamplong环信 IM 服务器收到消息已读回执的 Unix 时间戳,单位为 ms。
msg_idString该回执消息的消息 ID。