使用限制

业务特性限制
功能特性
限制项
限制说明
单聊/群聊消息
内容长度
单聊、群聊消息，单条消息最大长度限制为12K
﻿
发送频率
单聊消息发送频率：端上发出时无限制；REST API 发出时相应接口有频率限制，可查看相应接口的文档。群聊消息发送频率：每个群限40条/秒（针对所有群类型，且不同群内发消息，限频互不影响）
﻿
接收频率
Android/iOS/Mac/Windows/iPad：单聊和群聊均无限制Web：低于2.11.2的 SDK 版本，不超过1000条/秒（单聊和群聊的总和）；2.11.2版本以上的无限制
﻿
单个文件大小
发送文件消息时，SDK 最大支持发送单个文件大小为100MB
 SDK 不支持创建和发送文件消息
WebIM SDK 不支持创建和发送语音消息
﻿
历史消息存储时长
单聊消息及非直播群消息具备历史消息存储能力，不同默认配置如下：
开发版：7天，不支持延长
标准版：7天，支持延长
进阶版：30天，支持延长
UserID
命名规则
用户帐号长度不超过32字节，不支持使用特殊字符，建议使用英文字母或数字
用户资料
自定义字段
自定义字段的关键字必须是英文字母且长度不得超过8字节，自定义字段的值最长不能超过500字节
UserSig
有效期
用户密码，即时通信 IM 后台 SDK 默认接口生成的签名有效期为180天
会话管理
最近联系人数量
每个用户默认保存100个最近联系人，进阶版最多支持500个最近联系人，可在控制台自助配置
用户关系链
好友及分组
单个用户支持3000个好友
添加好友时未读消息最多支持100条
好友分组最多支持32个
每个分组的名称最长30字节
好友备注最长支持96字节
WebIM SDK 从2.13.0起支持好友关系链
﻿
黑名单
单个用户最多允许的黑名单人数为1000人
群组
群组数量
指单个 SDKAppID 中同时存在的所有群组类型群数之和，已解散的群组不计数，若已达峰值，可先解散无需使用的群组再创建新群组。不同限制如下：
开发版： 100个
标准版或进阶版：无上限
﻿
群成员数量
直播群（AvChatRoom）：无成员数量上限
非直播群，不同默认配置如下：
开发版：20人/群 
标准版 ：200人/群，支持拓展至2000人/群
进阶版：2000人/群，支持拓展至6000人/群
﻿
用户可加入群组数
指用户同时加入的所有群组类型群数之和，不同限制如下：
开发版：50个群/人
标准版：500个群/人，支持扩展至1000个群/人
进阶版：支持扩展至3000个群/人
﻿
群资料
群名称最长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个成员，但群成员数上限同时受不同群组类型的特性约束，详情请参见 群组功能
﻿

业务特性限制
接口相关限制

功能特性	限制项	限制说明
单聊/群聊消息	内容长度	单聊、群聊消息，单条消息最大长度限制为12K
		发送频率	单聊消息发送频率：端上发出时无限制；REST API 发出时相应接口有频率限制，可查看相应接口的文档。群聊消息发送频率：每个群限40条/秒（针对所有群类型，且不同群内发消息，限频互不影响）
		接收频率	Android/iOS/Mac/Windows/iPad：单聊和群聊均无限制Web：低于2.11.2的 SDK 版本，不超过1000条/秒（单聊和群聊的总和）；2.11.2版本以上的无限制
		单个文件大小	发送文件消息时，SDK 最大支持发送单个文件大小为100MB SDK 不支持创建和发送文件消息 WebIM SDK 不支持创建和发送语音消息
		历史消息存储时长	单聊消息及非直播群消息具备历史消息存储能力，不同默认配置如下：开发版：7天，不支持延长标准版：7天，支持延长进阶版：30天，支持延长
UserID	命名规则	用户帐号长度不超过32字节，不支持使用特殊字符，建议使用英文字母或数字
用户资料	自定义字段	自定义字段的关键字必须是英文字母且长度不得超过8字节，自定义字段的值最长不能超过500字节
UserSig	有效期	用户密码，即时通信 IM 后台 SDK 默认接口生成的签名有效期为180天
会话管理	最近联系人数量	每个用户默认保存100个最近联系人，进阶版最多支持500个最近联系人，可在控制台自助配置
用户关系链	好友及分组	单个用户支持3000个好友添加好友时未读消息最多支持100条好友分组最多支持32个每个分组的名称最长30字节好友备注最长支持96字节 WebIM SDK 从2.13.0起支持好友关系链
用户关系链		黑名单	单个用户最多允许的黑名单人数为1000人
群组	群组数量	指单个 SDKAppID 中同时存在的所有群组类型群数之和，已解散的群组不计数，若已达峰值，可先解散无需使用的群组再创建新群组。不同限制如下：开发版： 100个标准版或进阶版：无上限
		群成员数量	直播群（AvChatRoom）：无成员数量上限非直播群，不同默认配置如下：开发版：20人/群标准版：200人/群，支持拓展至2000人/群进阶版：2000人/群，支持拓展至6000人/群
		用户可加入群组数	指用户同时加入的所有群组类型群数之和，不同限制如下：开发版：50个群/人标准版：500个群/人，支持扩展至1000个群/人进阶版：支持扩展至3000个群/人
		群资料	群名称最长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个话题

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

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

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

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

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