tencent cloud

即时通信 IM

动态与公告
产品动态
公告
产品简介
产品概述
基本概念
应用场景
功能介绍
账号系统
用户资料与关系链
消息管理
群组相关
公众号系统
音视频通话 Call
使用限制
购买指南
计费概述
价格说明
购买指引
续费指引
停服说明
退费说明
开发指引
Demo 专区
开通服务
体验 Demo
快速跑通
下载中心
SDK & Demo 源码
更新日志
聊天互动（含 UI）
TUIKit 组件介绍
快速开始
全功能接入
单功能接入
AI 集成
构建基础界面
更多特性
定义外观
国际化界面语言
推送服务（Push）
服务概述
名词解释
开通服务
快速跑通
厂商通道
数据统计
排查工具
客户端 API
服务端 API
推送回调
高级功能
更新日志
错误码
常见问题
智能客服
功能概述
快速入门
集成指引
管理员操作手册
客服操作手册
更多实践
直播间搭建
AI 聊天机器人方案
超大娱乐协作社群
Discord 实现指南
游戏内集成 Chat 指南
类 WhatsApp Channel 搭建方案
发送红包
Chat 应对防火墙限制相关
无 UI 集成
快速开始
集成 SDK
初始化
登录登出
消息相关
会话相关
群组相关
社群话题
用户管理
离线推送
云端搜索
本地搜索
公众号
客户端 API
JavaScript
Android
iOS & macOS
Swift
Flutter
Electron
Unity
React Native
C 接口
C++
服务端 API
生成 UserSig
REST API
第三方回调
控制台指南
新版控制台介绍
创建并升级应用
基本配置
功能配置
账号管理
群组管理
公众号管理
回调配置
用量统计
资源包查看指南
实时监控
开发辅助工具
访问管理
高级功能
常见问题
uni-app 常见问题
购买相关问题
SDK 相关问题
账号鉴权相关问题
用户资料与关系链相关问题
消息相关问题
群组相关问题
直播群相关问题
昵称头像相关问题
协议与认证
服务等级协议
安全合规认证
IM 政策
隐私政策
数据隐私和安全协议
平滑迁移方案
平滑迁移完整版
平滑迁移简化版
错误码
联系我们
文档即时通信 IM产品简介使用限制

使用限制

PDF
聚焦模式
字号
最后更新时间： 2025-09-26 10:05:20

业务特性限制

功能特性
限制项
限制说明
单聊/群聊消息
内容长度
单聊、群聊消息，单条消息最大长度限制为12K
发送频率
单聊消息发送频率：端上发出时无限制；REST API 发出时相应接口有频率限制，可查看相应接口的文档。群聊消息发送频率：每个群限40条/秒（针对所有群类型，且不同群内发消息，限频互不影响）
接收频率
Android/iOS/Mac/Windows/iPad：单聊和群聊均无限制Web：低于2.11.2的 SDK 版本，不超过1000条/秒（单聊和群聊的总和）；2.11.2版本以上的无限制
单个文件大小
发送文件消息或短视频消息时，SDK 最大支持发送单个文件大小为100MB
发送图片消息或语音消息时，SDK 最大支持发送单个图片大小为28MB
SDK 不支持创建和发送文件消息
WebChat SDK 不支持创建和发送语音消息
历史消息存储时长
单聊消息及非直播群消息具备历史消息存储能力，不同默认配置如下：
体验版：7天，不支持延长
标准版：7天，支持延长
专业版：30天，支持延长
专业版Plus：90天，支持延长
企业版：90天，支持延长
UserID
命名规则
用户账号长度不超过32字节，不支持使用特殊字符，建议使用英文字母或数字
用户资料
自定义字段
自定义字段的关键字必须是英文字母且长度不得超过8字节，自定义字段的值最长不能超过500字节
UserSig
有效期
用户密码，即时通信 Chat 后台 SDK 默认接口生成的签名有效期为180天
会话管理
最近联系人数量
每个用户默认保存100个最近联系人，专业版、专业版Plus和企业版最多支持500个最近联系人，可在控制台自助配置
用户关系链
好友及分组
单个用户支持3000个好友
添加好友时未读消息最多支持100条
好友分组最多支持32个
每个分组的名称最长30字节
好友备注最长支持96字节
WebChat SDK 从2.13.0起支持好友关系链
黑名单
单个用户最多允许的黑名单人数为1000人
群组
群组数量
指单个 SDKAppID 中同时存在的所有群组类型群数之和，已解散的群组不计数，若已达峰值，可先解散无需使用的群组再创建新群组。不同限制如下：
体验版： 100个
标准版、专业版、专业版Plus和企业版：无上限
群成员数量
直播群（AvChatRoom）：无成员数量上限
非直播群，不同默认配置如下：
体验版：20人/群
标准版 ：500人/群
专业版：2000人/群
专业版Plus：5000人/群
企业版：6000人/群（可定制）
用户可加入群组数
指用户同时加入的所有群组类型群数之和，不同限制如下：
体验版：50个群/人
标准版：1000个群/人
专业版：1000个群/人
专业版Plus：3000个群/人
企业版：5000个群/人
群资料
群名称最长30字节
群简介最长240字节
群公告最长300字节
群头像 URL 最长100字节
群名片最大不超过50个字节
自定义群组 ID
自定义群组 ID 必须为可打印 ASCII 字符（0x20-0x7e），最长48个字节，且前缀不能为 @TGS#（避免与默认分配的群组 ID 混淆）
群组维度自定义字段
群组维度最多支持10个自定义字段：
字段 Key 为 String 类型，长度不超过16字节，其命名仅支持英文大小写字母、数字、下划线
字段 Value 为用户自定义 Buffer，可以为二进制数据，群维度的 Value 长度不超过512字节
群成员维度自定义字段
群成员维度最多支持5个自定义字段：
字段 Key 为 String 类型，长度不超过16字节，其命名仅支持英文大小写字母、数字、下划线
字段 Value 为用户自定义 Buffer，可以为二进制数据，群成员维度的 Value 长度不超过64字节
社群中话题数量
一个社群目前最大支持200个话题


接口相关限制

说明
本文仅列出涉及使用限制的 REST API，更全面的 API 列表请参见 REST API 接口列表。

通用限制

限制项
限制说明
调用频率
最高100次/秒：导入多个账号、删除账号 和 查询账号
最高200次/秒：其余 REST API


账号管理

接口
限制说明
导入多个账号
单次最多导入100个用户名，且本接口不支持直接导入账号的昵称和头像信息
查询账号在线状态
一次请求最多可以查询500个用户的状态


单聊消息

接口
限制说明
批量发单聊消息
一次请求最多可给500个用户发送单聊消息


关系链管理

接口
限制说明
导入好友
一次请求最多只能导入1000个好友


群组管理

接口
限制说明
增加群组成员
一次最多支持添加100个成员
删除群组成员
一次请求最多可删除500个成员
查询用户在群组中的身份
一次请求最多支持查询500个账号
批量禁言和取消禁言
一次请求最多可禁言/取消禁言500个账号
在群组中发送普通消息
单个群的默认发送频率限制为40条/秒如果5分钟内同一发送者的两条消息的随机值（Random 参数）相同，后面的消息将被当做重复消息而丢弃
导入群消息
一次请求最多可导入20条消息，要求按消息时间戳递增的顺序导入，消息时间戳必须大于建群时间且小于当前时间，否则失败
导入群成员
直播群（AvChatRoom）不支持导入群成员一次请求最多可导入300个成员，但群成员数上限同时受不同群组类型的特性约束，详情请参见 群组功能

上一篇: 音视频通话 Call下一篇: 计费概述

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈