目录

消息管理–获取消息的已读回执和送达回执

更新时间:2022-02-28

本文介绍环信即时通讯 IM SDK 如何从服务器获取消息的已读回执和送达回执。

功能描述

环信即时通讯 IM 投递消息成功会返回送达回执,提供消息已读功能,接收方查看消息后,会返回已读回执。

功能 描述
消息送达回执 消息下发成功后,会返回消息送达回执。
消息已读回执 接收方查看消息后,会返回消息已读回执。
单聊消息已读回执 提供单聊消息已读回执能力。
群组消息已读回执 提供群组消息已读回执能力。

技术原理

使用环信即时通讯 IM Web SDK可以实现消息的送达回执与已读回执,主要方法如下:

前提条件

开始前,请确保满足以下条件:

实现方法

消息送达回执

若在消息送达时收到通知,可打开消息送达开关,这样消息到达对方设备时,你便会收到通知。

示例代码如下:

// customEvent 用户可以自定义。
WebIM.conn.addEventHandler('customEvent', {
    onReceivedMessage: function(message){},    // 收到消息送达服务器回执。
    onDeliveredMessage: function(message){},   // 收到消息送达客户端回执。
});

消息已读回执

消息阅读后,可以发出已读回执。该回执需要你调用 API 实现,这样消息发送方可以知道消息已被阅读。下文分别介绍会话已读回执、单聊和群聊的消息已读回执。

发送会话已读回执

会话已读回执用于获知接收方是否阅读消息的场景,目前单聊可以直接集成,群聊需要联系客户经理单独开通。

注意

群消息已读回执功能为增值服务,仅旗舰版及以上支持,具体使用参考 群消息已读回执。

示例代码如下:

// 单聊。
let option = {
    chatType: 'singleChat', // 会话类型,设置为单聊。
    type: 'channel',        // 消息类型。
    to: 'userID'            // 接收消息对象(用户 ID)。
}
let msg = WebIM.message.create(option); 
WebIM.conn.send(msg);

// 群聊。
let option = {
    chatType: 'groupChat', // 会话类型,设置为群聊。
    type: 'channel',       // 消息类型。
    to: 'groupID'          // 消息接收方(群组 ID)。
}
let msg = WebIM.message.create(option); 
WebIM.conn.send(msg);
监听会话已读回执
// customEvent 用户可以自定义。
WebIM.conn.addEventHandler('customEvent', {
    onChannelMessage: (message) => {}
})

单聊发送已读回执

let option = {
    type: 'read',           // 消息是否已读。
    chatType: 'singleChat', // 会话类型,这里为单聊。
    to: 'userID',           // 消息接收方(用户 ID)。
    id: 'id'                // 需要发送已读回执的消息 ID。
}   
let msg = WebIM.message.create(option); 
WebIM.conn.send(msg);

监听单个消息的已读回执

可以在接收消息的的回调中监听某个消息是否已读,示例代码如下:

// customEvent 用户可以自定义。
WebIM.conn.addEventHandler('customEvent', {
    onReadMessage: (message) => {}
})

群聊消息已读回执

一、对于群消息,消息发送方(目前为群主和群管理员)可设置指定消息是否需要已读回执。

sendGroupReadMsg = () => {
    let option = {
        type: 'txt',            // 消息类型。
        chatType: 'groupChat',  // 会话类型,这里为群聊。
        to: "groupId",          // 消息接收方(群组ID)。
        msg: 'message content'  // 消息内容。
        msgConfig: { allowGroupAck: true } // 设置此消息需要已读回执。
    }

    let msg = WebIM.message.create(option); 
    WebIM.conn.send(msg).then((res) => {
        console.log('send private text success');
    }).catch((e) => {
        console.log("send private text error");
    })

}

二、监听收到群组消息回执

分两种情况:

1、正常在线时可以在 onReadMessage 函数里监听到回执;

2、离线时收到群组消息回执,登录后会在 onStatisticMessage 函数里监听到回执。

// 在线时可以在 onReadMessage 里监听。
onReadMessage: (message) => {
    let { mid } = message;
    let msg = {
        id: mid
    };
    if(message.groupReadCount){
        // 消息已读数。
        msg.groupReadCount = message.groupReadCount[message.mid];
    }
}
      
// 离线时收到回执,登录后会在这里监听到。
onStatisticMessage: (message) => {
    let statisticMsg = message.location && JSON.parse(message.location);
    let groupAck = statisticMsg.group_ack || [];
}

三、收到回执消息后发送回执

sendReadMsg = () => {
    let option = {
        type: 'read',           // 消息是否已读。
        chatType: 'groupChat',  // 会话类型,这里为群聊。
        id: 'msgId',            // 需要发送已读回执的消息 ID。
        to: "groupId",          // 群组 ID。
        ackContent: JSON.stringify({}) // 回执内容。
    }  
    let msg = WebIM.message.create(option); 
    WebIM.conn.send(msg)
}

四、查看已读消息的用户

WebIM.conn.getGroupMsgReadUser({
    msgId,  // 消息 ID。
    groupId // 群组 ID。
}).then((res)=>{
    console.log(res)
})