这篇列出腾讯云即时通信IM的业务特性限制与接口相关限制,涵盖单聊/群聊消息、群组、公众号等功能的配额与频率约束。 单聊消息最大12K,群聊发送频率40条/秒,历史消息存储时长依套餐不同为7至90天。 群组数量:体验版上限100个,专业版及以上无上限;群成员数量依群类型与套餐不同,直播群无上限。 REST API调用频率最高200次/秒,批量发单聊消息一次最多500用户,群组发送消息频率40条/秒。
相关产品
即时通信 IM 产品页,含版本规格、价格与购买入口。
一、业务特性限制
| 功能特性 |
限制项 |
限制说明 |
| 单聊/群聊/公众号消息 |
内容长度 |
单聊、群聊消息,单条消息最大长度限制为12K。 |
| |
发送频率 |
单聊消息发送频率:端上发出时无限制;REST API 发出时相应接口有频率限制,可查看相应接口的文档。群聊消息发送频率:每个群限40条/秒(针对所有群类型,且不同群内发消息,限频互不影响)。 |
| |
接收频率 |
Android/iOS/Mac/Windows/iPad:单聊和群聊均无限制。Web:低于2.11.2的 SDK 版本,不超过1000条/秒(单聊和群聊的总和);2.11.2版本以上的无限制。 |
| |
单个文件大小 |
发送文件消息或短视频消息时,SDK 最大支持发送单个文件大小为100MB。发送图片消息或语音消息时,SDK 最大支持发送单个图片大小为28MB。 |
| |
历史消息存储时长 |
单聊消息及非直播群消息具备历史消息存储能力,你可以登录 即时通信 IM 控制台 修改相关配置。不同套餐包默认配置如下:体验版:7天,不支持延长。专业版:7天,支持延长。旗舰版:30天,支持延长。企业版:90天,支持延长。延长历史消息存储时长是付费增值服务,具体计费说明请参见 计费概述。 |
| UserID |
命名规则 |
用户账号长度不超过32字节,不支持使用特殊字符,建议使用英文字母或数字。 |
| 用户资料 |
自定义字段 |
自定义字段的关键字必须是英文字母且长度不得超过8字节,自定义字段的值最长不能超过500字节。 |
| UserSig |
有效期 |
用户密码,即时通信 IM 后台 SDK 默认接口生成的签名有效期为180天。 |
| 会话管理 |
最近联系人数量 |
每个用户默认保存100个最近联系人,旗舰版最多支持500个最近联系人、企业版最多支持3000个最近联系人可在控制台自助配置。 |
| 用户关系链 |
好友及分组 |
单个用户支持3000个好友。添加好友时未读消息最多支持100条。好友分组最多支持32个。每个分组的名称最长30字节。好友备注最长支持96字节。WebIM SDK 从2.13.0起支持好友关系链。 |
| |
黑名单 |
单个用户最多允许的黑名单人数为1000人。 |
| 群组 |
群组数量 |
指单个 SDKAppID 中同时存在的所有群组类型群数之和,已解散的群组不计数,若已达峰值,可先解散无需使用的群组再创建新群组。不同类型群不同套餐包限制如下:好友工作群(Work)/陌生人社交群(Public)/临时会议群(Meeting)体验版:群组总数量不超过100个,已解散的群组不计数。专业版、旗舰版或企业版:无上限。直播群(AVChatRoom)体验版:最多同时存在10个,已解散的群组不计数。专业版:最多同时存在50个,已解散的群组不计数。旗舰版:无上限。企业版:无上限。社群体验版:不支持。专业版:不支持。旗舰版:默认可创建100000个。企业版:默认可创建100000个体验版所有群类型下群数量总和不超过100个。日净增群组数体验版受群数量总和100的限制,专业版、旗舰版最多支持1万个,企业版最多支持50000个,免费峰值群组数为10万个/月。若峰值群组数超出免费量将产生套餐外超量费用,具体计费说明请参见计费概述。 |
| |
群成员数量 |
直播群(AvChatRoom):无成员数量上限。社群(Community):默认10万人/群,可扩容至100万/群(企业版客户可 提交工单 进行申请)。其他群,不同套餐包默认配置如下:体验版:20人/群 。专业版 :200人/群。旗舰版:2000人/群。企业版:6000人/群。 |
| |
用户可加入群组数 |
指用户同时加入的所有群组类型群数之和,不同套餐包限制如下:体验版:50个群/人。专业版:500个群/人。旗舰版:1000个群/人。企业版:5000个群/人。用户加入的社群群组单独计数,最高支持1000个社群/人。 |
| |
群资料 |
群名称最长100字节。群简介最长400字节。群公告最长400字节。群头像 URL 最长500字节。群名片最大不超过50个字节。 |
| |
自定义群组 ID |
自定义群组 ID 必须为可打印 ASCII 字符(0x20-0x7e),最长48个字节,且前缀不能为 @TGS#(避免与默认分配的群组 ID 混淆)。 |
| |
群自定义属性 |
单个群的 Key 数量:max_key_num:16,Key 的最大长度:max_key_size:32字节(数据类型:String 类型(命名支持英文大小写字母、数字、下划线))。单个 Key 对应的 value 的最大长度:max_val_size:4000字节,所有 Key 对应的 value 总长度:max_total_val_size:16000(数据类型:用户自定义 Buffer(可以为二进制数据))。 |
| |
群组维度自定义字段 |
更推荐使用群自定义属性。群组维度最多支持10个自定义字段:字段 Key 为 String 类型,长度不超过16字节,其命名仅支持英文大小写字母、数字、下划线。字段 Value 为用户自定义 Buffer,可以为二进制数据,群维度的 Value 长度不超过512字节。 |
| |
群成员维度自定义字段 |
群成员维度最多支持5个自定义字段:字段 Key 为 String 类型,长度不超过16字节,其命名仅支持英文大小写字母、数字、下划线。字段 Value 为用户自定义 Buffer,可以为二进制数据,群成员维度的 Value 长度不超过64字节。 |
| |
社群中话题数量 |
最大支持200个话题。 |
| |
社群中管理员数量 |
每个群最高支持20个群管理员(包括群主)。 |
| |
社群中权限组数量 |
最大支持20个权限组。 |
| |
社群中权限组成员数量 |
具备 ManageGroupMember 权限的权限组最大支持20个成员。 |
| |
被禁言群成员数量 |
社群最多支持禁言20000个成员。 |
| 公众号 |
公众号数量 |
指单个 SDKAppID 中同时存在的所有公众号数量,已销毁的公众号不计数,若已达峰值,可先销毁无需使用的公众号再创建新公众号。不同类型群不同套餐包限制如下:体验版:不支持。专业版:不支持。旗舰版:默认可创建100000个。企业版:默认可创建100000个 |
| |
订阅者数量 |
默认100000人/公众号。 |
| |
用户可订阅公众号数 |
最高支持1000个公众号/人。 |
| |
公众号资料 |
公众号名称最长150字节。公众号简介最长400字节。公众号头像 URL 最长500字节。公众号所属的团体组织最长500字节。公众号资料维度的自定义字段最长3000字节。 |
| |
自定义公众号 ID |
自定义公众号 ID 必须以 @TOA#_ 开头,但不能是 @TOA#_@TOA#,且保证在 App 中唯一,且为可打印 ASCII 字符(0x20-0x7e),最长48个字节。 |
二、接口相关限制
注意:说明:
注意:这篇仅列出涉及使用限制的 REST API,更全面的 API 列表请参见 REST API 接口列表。
三、通用限制
| 限制项 |
限制说明 |
| 调用频率 |
最高100次/秒:导入多个账号、删除账号 和 查询账号。最高200次/秒:其余 REST API。 |
四、账号管理
| 接口 |
限制说明 |
| 导入多个账号 |
单次最多导入100个用户名,且本接口不支持直接导入账号的昵称和头像信息。 |
| 查询账号在线状态 |
一次请求最多可以查询500个用户的状态。 |
五、单聊消息
| 接口 |
限制说明 |
| 批量发单聊消息 |
一次请求最多可给500个用户发送单聊消息。 |
六、关系链管理
| 接口 |
限制说明 |
| 导入好友 |
一次请求最多只能导入1000个好友。 |
七、群组管理
| 接口 |
限制说明 |
| 增加群组成员 |
一次最多支持添加20个成员。 |
| 删除群组成员 |
一次请求最多可删除500个成员。 |
| 查询用户在群组中的身份 |
一次请求最多支持查询500个账号。 |
| 批量禁言和取消禁言 |
一次请求最多可禁言/取消禁言500个账号。 |
| 在群组中发送普通消息 |
单个群的发送频率上限为40条/秒。如果5分钟内两条消息的内容和 Random 随机值都相同,后一条消息将被当作重复消息而丢弃。请合理分配消息优先级。 |
| 在支持话题的社群组中发送普通消息 |
每个话题的发送频率上限为40条/秒,整个群的发送频率上限为200条/秒。如果5分钟内两条消息的内容和 Random 随机值都相同,后一条消息将被当作重复消息而丢弃。请合理分配消息优先级。 |
| 导入群消息 |
一次请求最多可导入20条消息,要求按消息时间戳递增的顺序导入,消息时间戳必须大于建群时间且小于当前时间,否则失败。 |
| 导入群成员 |
直播群(AvChatRoom)不支持导入群成员一次请求最多可导入300个成员,但群成员数上限同时受不同群组类型的特性约束,详情请参见 群组功能。 |
八、公众号管理
| 接口 |
限制说明 |
| 添加订阅者 |
一次最多支持添加100个订阅者。 |
| 删除订阅者 |
一次请求最多可删除100个订阅者。 |
| 公众号发布广播消息 |
单个公众号的发送频率上限为1条/秒,每小时最多可发布2条广播消息。如果5分钟内两条消息的内容相同,后面的消息将被当作重复消息而丢弃。 |