发送群组消息已读回执

大约 2 分钟

发送群组消息已读回执

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

提示

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

回调时机

客户端发送群组消息已读回执。

回调请求

请求示例

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

{
    "callId": "XXXX#XXXX_1406088760298309588",
    "channel_channel": "XXXX#XXXX_277721224642561@conference.easemob.com",
    "eventType": "chat",
    "channel_user": "XXXX#XXXX_tst@easemob.com",
    "chat_type": "read_ack",
    "security": "bc392b82e70e24cc1ea29e08aa41765d",
    "content_type": "chat:ack:read",
    "payload": {
        "ext": {},
        "ack_message_id": "1406088702140090324",
        "msg_config": {
            "allow_group_ack": true
        },
        "type": "read_ack"
    },
    "writed_channel": false,
    "host": "easemob@hsb-im-msync0",
    "appkey": "eXXXX#XXXX",
    "from": "tst",
    "to": "277721224642561",
    "msg_id": "1406088760298309588",
    "timestamp": 1744945351097
}

请求字段说明

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