• UIKit
  • SDK
  • 服务端 API
Chat/
SDK/
Web/
消息/
SDK
  • 集成 SDK
  • 初始化
  • 登录登出
  • 接口列表
  • 更新日志
  • 消息
    • 介绍
    • 发送消息
    • 接收消息
    • 历史消息
    • 转发消息
    • 修改消息
    • 删除消息
    • 清空消息
    • 撤回消息
    • 在线消息
    • 已读回执
    • 查询消息
    • 群定向消息
    • 消息免打扰
    • 消息扩展
    • 消息翻译
  • 会话
    • 介绍
    • 会话列表
    • 获取会话
    • 会话未读数
    • 置顶会话
    • 删除会话
    • 会话标记
    • 会话分组
  • 群组
    • 介绍
    • 管理群组
    • 群资料
    • 管理群成员
    • 群成员资料
    • 自定义属性
    • 群计数器
  • 社群话题
    • 管理社群
  • 用户
    • 用户资料
    • 用户状态
    • 管理好友
    • 好友列表
    • 黑名单
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

群定向消息

功能描述

群定向消息是指向群内部分成员发送消息,其他群成员无法收到该消息。
说明
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);
});

接收群定向消息

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