tencent cloud

文档反馈

最后更新时间:2024-07-10 16:31:08

    功能描述

    群定向消息是指向群内部分成员发送消息,其他群成员无法收到该消息。
    说明
    1. 该功能仅对进阶版客户开放,请购买进阶版后使用。
    2. 创建群 @ 消息不支持指定消息接收成员列表 receiverList
    3. 社群(Community)和直播群(AVChatRoom)不支持发送群定向消息。
    4. 群定向消息默认不计入群会话的未读计数。

    效果展示

    使用群定向消息功能,您可以实现如下图所示的效果:
    

    发送群定向消息

    定向消息是指,向群内部分指定的成员发送消息,而未被指定的群成员不会通过 TencentCloudChat.EVENT.MESSAGE_RECEIVED 事件收到该消息。
    如果您希望向群组内特定的群成员发消息,可以按照下面的方式实现:
    调用 createXxxMessage (其中 Xxx 表示具体的消息类型) 接口创建一条消息,并指定消息接收成员列表 receiverList
    调用 sendMessage 接口发送消息。
    示例
    // 发送群定向消息
    // 注意:群定向消息不计入会话未读,receiverList 最大支持50个接收者。
    let message = chat.createTextMessage({
    to: 'test',
    conversationType: TencentCloudChat.TYPES.CONV_GROUP,
    payload: {
    text: 'Hello world!'
    },
    // 如果您需要发群定向消息,需购买旗舰版套餐,并且创建消息时通过 receiverList 指定消息接收者
    receiverList: ['user0', 'user1']
    });
    // 发送消息
    let promise = chat.sendMessage(message);
    promise.then(function(imResponse) {
    // 发送成功
    console.log(imResponse);
    }).catch(function(imError) {
    // 发送失败
    console.warn('sendMessage error:', imError);
    });

    接收群定向消息

    群定向消息默认不计入群会话的未读计数。 接收群定向消息跟接收普通消息是一样的操作步骤,参见 接收消息
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持