即时通信 IM文档中心入门中心API 中心SDK 中心文档活动我的反馈文档反馈官招募中，报名立赚积分兑换代金券！> HOT文档中心>即时通信 IM>产品简介>消息管理>群组消息群组消息最近更新时间：2026-01-07 17:28:52
微信扫一扫QQ新浪微博复制链接链接复制成功我的收藏本页目录：应用场景群内收发消息App 管理员发送消息App 管理员模拟系统消息群消息的 SEQ 机制群聊消息类型群聊消息能力群消息发送控制消息优先级与频率控制群消息优先级群消息频控群组离线消息处理流程应用场景群内收发消息群成员在群内收发消息，类似 QQ 群、微信群的聊天方式。App 管理员发送消息群聊消息可以由 App 管理员在后台发送消息，也可以模拟其他用户身份发送消息（即使 App 管理员或发送者不是群成员，消息依然会下发）。App 管理员模拟系统消息通过 App 管理员在后台发送消息，可以模拟系统消息，以系统消息的形式给指定的群内在线成员，App 端收到 App 管理员的自定义消息可做特殊处理。群消息的 SEQ 机制即时通信 IM 会为每个群维护一个消息 SEQ。SEQ 的初始值为 1。群内每产生一条普通消息，即时通信 IM 后台会将当前 SEQ 的值作为该消息的 SEQ，并且将该 SEQ 自增 1。
群组 ID + SEQ，相当于是一条消息的唯一标识。注意：即时通信 IM 只会为存漫游的消息产生递增 SEQ。群聊消息类型消息类型描述文本消息消息内容是普通文本图片消息消息内容为图片 URL 地址、尺寸、图片大小等信息表情消息表情消息是由开发者自定义语音消息语音数据需要提供时长信息，以秒为单位地理位置消息消息内容为地理位置标题、经度、纬度信息文件消息消息内容为文件的 URL 地址、大小、格式等信息，格式不限，最大支持100M短视频消息消息内容为短视频文件的 URL 地址、时长、大小、格式等信息，最大支持100M自定义消息开发者自定义的消息类型，例如红包消息、石头剪刀布等形式的消息合并消息将多条不同类型的消息（如文本、图片、语音等）合并为一条消息进行发送或转发。群聊消息能力类型功能描述应用场景发送群普通消息群成员可以通过 IM SDK 接口发送消息。App 管理员无需加入群组，即可调用 REST API 在任意群组中发送消息。群成员在群内发送消息，App 管理员向任意群组发送消息。发送群系统消息App 管理员无需加入群组，即可调用 REST API 在群组中发送系统通知。该系统通知，只有群内在线成员才会收到该消息，不具备漫游能力。App 管理员向群内部分或者全部在线成员推送一条时效性较高的提醒。群消息离线推送支持 Apple、华为、小米、OPPO、vivo、魅族等品牌手机离线推送。群聊消息离线推送。接收群在线消息群成员可以通过 IM SDK 接收群聊在线消息。在线群成员实时接收群消息。群成员获取离线/历史消息群成员通过 IM SDK 接口查询历史消息。群成员上线接收离线消息，群成员查看群聊天记录。App 后台获取群消息App 管理员可通过 REST API 下载 App 在某一段时间内产生所有的消息。App 管理员亦可通过 REST API，获取任意群的聊天记录App 后台可以通过群内发言之后回调，实时获取群消息。App 定期备份消息记录的场景。App 需要快速获取指定群组历史消息的场景。App 需要实时获取群消息的场景。消息删除可通过 REST API 将历史消息删除，确保该消息不被传播。群内恶意信息删除。群聊消息中携带发送者资料在群消息中携带发送者的昵称、头像、群名片、用户维度的自定义字段、群成员维度的自定义字段。展示消息发送人昵称、头像等信息。群消息发送控制禁言和群消息发送前回调，是控制群消息发送的两种方式。禁止群内某个成员发送消息，禁止群内所有成员发消息，App 后台过滤或修改消息。群消息接收控制用户针对单个群组设置不同的消息接收选项：接收并提示，接收不提示，屏蔽消息。设置“接收不提示”后，iOS 终端会去掉 APNs 推送功能。用户屏蔽某个群组的消息。群消息频率控制控制群普通消息的发送频率，默认值为 40条/秒。详细请参见 消息优先级与频率控制。避免消息刷屏。注意：如需携带发送者昵称和头像，则必须把这两个字段的信息导入到即时通信 IM 的用户资料中。如果需要携带自定义资料，则需要先在控制台配置自定义字段，然后再 提交工单 申请在消息携带相应的字段。群消息发送控制可以通过以下方式控制群消息的发送：控制方式详细描述群组内禁言禁止某一用户一段时间内在群内发言，只针对单个群组有效。如果用户退群再重新入群，只要禁言时间没有过期，禁言依旧有效。群消息发送前回调在把群消息下发给群成员之前，即时通信 IM 后台先去 App 后台询问是否允许下发消息，如果不允许，则拒绝下发消息。App 后台在收到回调后，也可对消息内容进行修改并返回给即时通信 IM，即时通信 IM 将使用修改之后的信息进行下发，详情请参考 群内发言之前回调。但是即时通信 IM 在发起该回调后，最多只会等待2秒。如2秒内未收到应答，直接将消息下发给群成员，不会进行重试。消息优先级与频率控制群消息优先级群消息分为 3 个优先级，如果某个群的消息超过了频率限制，后台会优先下发高优先级的消息。因此用户应根据消息的重要程度，来选择合适的优先级。
3个优先级从高到低，分别如下：优先级建议选择该优先级的消息类型High红包消息和礼物消息。Normal普通文本消息。Low点赞消息。群消息频控总消息数频控说明：总消息数频控是指单个群所有端接口累计每秒最多能发送的消息数限制，默认值为 40条/秒，采用每秒平均限频。消息数量超过限制后，后台优先下发优先级相对较高的消息，同等优先级的消息随机排序。被频控限制的消息，不会下发，不会存入历史消息，但会给发送人返回成功；会触发 群内发言之前回调，但不会触发 群内发言之后回调。优先级频控优先级频控是指单个群每秒最多能发送多少条某优先级的消息，发消息请求只有在通过总消息数频控之后，才会进入优先级频控。所有的消息都会受到40条/秒的频率限制，可以设置三级优先级，设置了 High 优先级的消息将有最高优先级，避免被限制，如果同一秒内高优先级消息总数超过40条/秒，高优先级消息也会被抛弃。群组离线消息处理流程群组离线消息处理流程：1. 用户 A 调用sendMessage给群组 C 发送消息，用户 B 处于下线状态。1.1 把群组 C 添加进用户 B 的最近联系人，缓存大小为 100 条。1.2 用户更新群组的消息信息，包括群组最新消息 seq。1.3 把消息存入漫游服务器中，时间限制 7 天。2. 用户B调用login接口登录即时通信 IM。3. SDK 自动拉取所有群组的消息 seq 信息，包括最新消息 seq 和未读计数。4. SDK 自动拉取最近联系人，通过OnNewMessage接口抛出。5. 同步消息过程完成，通过OnRefresh接口通知用户已完成群组数据同步。6. 用户调用getMessage，SDK 自动拉取漫游服务器。上一篇: 消息存储下一篇: 消息格式描述Copyright © 2013-2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有深圳市腾讯计算机系统有限公司ICP备案/许可证号：粤B2-20090059粤公网安备44030502008569号腾讯云计算（北京）有限责任公司京ICP证150476号 | 京ICP备11018762号中国站中文International文档“捉虫”活动检视指定产品文档，发现和反馈有效问题，奖！API专项"捉虫"反馈API文档问题，代金券、周边好礼奖不停！文档建议，你提了吗快来使用腾讯云产品文档，提出有效建议，奖！在线咨询目录返回顶部