发送单聊消息已读回执

大约 2 分钟

发送单聊消息已读回执

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

提示

  1. 你所使用的环信即时通讯 IM 的版本需要开通回调服务。
  2. 如果需要发送单聊消息已读回执的回调事件,你需要在 环信控制台 配置发送后回调规则,详见 配置回调规则
  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。
上次编辑于: