业务特性限制
功能特性 | 限制项 | 限制说明 |
单聊/群聊/公众号消息 | 内容长度 | 单聊、群聊消息，单条消息最大长度限制为12K。 |
| 发送频率 | 单聊消息发送频率：端上发出时无限制；REST API 发出时相应接口有频率限制，可查看相应接口的文档。群聊消息发送频率：每个群限40条/秒（针对所有群类型，且不同群内发消息，限频互不影响）。 |
| 接收频率 | Android/iOS/Mac/Windows/iPad：单聊和群聊均无限制。 Web：低于2.11.2的 SDK 版本，不超过1000条/秒（单聊和群聊的总和）；2.11.2版本以上的无限制。 |
| 单个文件大小 | 发送文件消息时，SDK 最大支持发送单个文件大小为100MB。 |
| 历史消息存储时长 | 体验版：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）：无成员数量上限。 其他群，不同套餐包默认配置如下： 体验版：20人/群 。 专业版 ：200人/群。 旗舰版：2000人/群。 企业版：6000人/群。 拓展群成员人数上限是付费增值服务，具体计费说明请参见计费概述。 |
| 用户可加入群组数 | 指用户同时加入的所有群组类型群数之和，不同套餐包限制如下： 体验版：50个群/人。 专业版：500个群/人。 旗舰版：1000个群/人。 企业版：5000个群/人 用户加入的社群群组单独计数，最高支持1000个社群/人。 |
| 群资料 | 群名称最长100字节。 群简介最长400字节。 群公告最长400字节。 群头像 URL 最长500字节。 群名片最大不超过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个话题。 |
| 社群中管理员数量 | 社群中每个群最高支持20个群管理员（包括群主）。 |
| 社群中权限组成员数量 | 具备 ManageGroupMember 权限的权限组最大支持20个成员。 |
公众号 | 公众号数量 | 指单个 SDKAppID 中同时存在的所有公众号数量，已销毁的公众号不计数，若已达峰值，可先销毁无需使用的公众号再创建新公众号。不同类型群不同套餐包限制如下： 体验版：不支持。 专业版：不支持。 旗舰版：默认可创建100000个。 企业版：默认可创建100000个 |
| 订阅者数量 | 默认100000人/公众号。 |
| 用户可订阅公众号数 | 最高支持1000个公众号/人。 |
| 公众号资料 | 公众号名称最长150字节。 公众号简介最长400字节。 公众号头像 URL 最长500字节。 公众号所属的团体组织最长500字节。 公众号资料维度的自定义字段最长3000字节。 |
| 自定义公众号 ID | 自定义公众号 ID 必须以 @TOA#_ 开头，但不能是@TOA#_@TOA#，且保证在 App 中唯一，且为可打印 ASCII 字符（0x20-0x7e），最长48个字节。 |
接口相关限制
说明：
通用限制
账号管理
接口 | 限制说明 |
导入多个账号 | 单次最多导入100个用户名，且本接口不支持直接导入账号的昵称和头像信息。 |
查询账号在线状态 | 一次请求最多可以查询500个用户的状态。 |
单聊消息
接口 | 限制说明 |
批量发单聊消息 | 一次请求最多可给500个用户发送单聊消息。 |
关系链管理
接口 | 限制说明 |
导入好友 | 一次请求最多只能导入1000个好友。 |
群组管理
接口 | 限制说明 |
增加群组成员 | 一次最多支持添加100个成员。 |
删除群组成员 | 一次请求最多可删除500个成员。 |
查询用户在群组中的身份 | 一次请求最多支持查询500个账号。 |
批量禁言和取消禁言 | 一次请求最多可禁言/取消禁言500个账号。 |
在群组中发送普通消息 | 单个群的发送频率上限为40条/秒。如果5分钟内两条消息的内容和 Random 随机值都相同，后一条消息将被当做重复消息而丢弃。请合理分配消息优先级。 |
在支持话题的社群组中发送普通消息 | 每个话题的发送频率上限为40条/秒，整个群的发送频率上限为200条/秒。如果5分钟内两条消息的内容和 Random 随机值都相同，后一条消息将被当做重复消息而丢弃。请合理分配消息优先级。 |
导入群消息 | 一次请求最多可导入20条消息，要求按消息时间戳递增的顺序导入，消息时间戳必须大于建群时间且小于当前时间，否则失败。 |
导入群成员 |
公众号管理
接口 | 限制说明 |
添加订阅者 | 一次最多支持添加100个订阅者。 |
删除订阅者 | 一次请求最多可删除100个订阅者。 |
公众号发布广播消息 | 单个公众号的发送频率上限为1条/秒，每小时最多可发布2条广播消息。如果5分钟内两条消息的内容相同，后面的消息将被当做重复消息而丢弃。 |
