有奖捉虫:云通信与企业服务文档专题,速来> HOT

业务特性限制

功能特性
限制项
限制说明
单聊/群聊/公众号消息
内容长度
单聊、群聊消息,单条消息最大长度限制为12K。
发送频率
单聊消息发送频率:端上发出时无限制;REST API 发出时相应接口有频率限制,可查看相应接口的文档。群聊消息发送频率:每个群限40条/秒(针对所有群类型,且不同群内发消息,限频互不影响)。
接收频率
Android/iOS/Mac/Windows/iPad:单聊和群聊均无限制。
Web:低于2.11.2的 SDK 版本,不超过1000条/秒(单聊和群聊的总和);2.11.2版本以上的无限制。
单个文件大小
发送文件消息时,SDK 最大支持发送单个文件大小为100MB。
小程序 SDK 不支持创建和发送文件消息。
WebIM SDK 不支持创建和发送语音消息。
历史消息存储时长
单聊消息及非直播群消息具备历史消息存储能力,您可以登录 即时通信 IM 控制台 修改相关配置。不同套餐包默认配置如下:
体验版: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 中同时存在的所有群组类型群数之和,已解散的群组不计数,若已达峰值,可先解散无需使用的群组再创建新群组。不同类型群不同套餐包限制如下:
好友工作群(Work)/陌生人社交群(Public)/临时会议群(Meeting)
体验版:群组总数量不超过100个,已解散的群组不计数。
专业版或旗舰版:无上限。
直播群(AVChatRoom)
体验版:最多同时存在10个,已解散的群组不计数。
专业版:最多同时存在50个,已解散的群组不计数,支持 增值 扩展直播群创建数至无上限。
旗舰版:无上限。
社群
体验版:不支持。
专业版:不支持。
旗舰版:默认可创建100000个。
体验版所有群类型下群数量总和不超过100个。日净增群组数体验版受群数量总和100的限制,专业版旗舰版最多支持1万个,免费峰值群组数为10万个/月。若峰值群组数超出免费量将产生套餐外超量费用,具体计费说明请参见 国内套餐外超量费用境外套餐外超量费用
群成员数量
直播群(AvChatRoom):无成员数量上限。
社群(Community):默认100000人/群,可扩容至100w/群。
其他群,不同套餐包默认配置如下:
体验版:20人/群 。
专业版 :200人/群,支持拓展至2000人/群。
旗舰版:2000人/群,支持拓展至6000人/群。
拓展群成员人数上限是付费增值服务,具体计费说明请参见 国内套餐外超量费用境外套餐外超量费用
用户可加入群组数
指用户同时加入的所有群组类型群数之和,不同套餐包限制如下:
体验版:50个群/人。
专业版:500个群/人,支持扩展至1000个群/人。
旗舰版:支持扩展至3000个群/人。
拓展单人可加入群组数上限是付费增值服务,具体计费说明请参见 国内套餐外超量费用境外套餐外超量费用
用户加入的社群群组单独计数,最高支持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个群管理员(包括群主)。
公众号
公众号数量
指单个 SDKAppID 中同时存在的所有公众号数量,已销毁的公众号不计数,若已达峰值,可先销毁无需使用的公众号再创建新公众号。不同类型群不同套餐包限制如下:
体验版:不支持。
专业版:不支持。
旗舰版:默认可创建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个好友。

群组管理

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

。公众号管理

接口
限制说明
添加订阅者
一次最多支持添加100个订阅者。
删除订阅者
一次请求最多可删除100个订阅者。
公众号发布广播消息
单个公众号的发送频率上限为1条/秒,每小时最多可发布2条广播消息。如果5分钟内两条消息的内容相同,后面的消息将被当做重复消息而丢弃。