tencent cloud

文档反馈

使用限制

最后更新时间:2025-01-14 11:14:15

    业务特性限制

    功能特性
    限制项
    限制说明
    单聊/群聊消息
    内容长度
    单聊、群聊消息,单条消息最大长度限制为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天,支持延长
    专业版Plus:90天,支持延长
    企业版:90天,支持延长
    UserID
    命名规则
    用户账号长度不超过32字节,不支持使用特殊字符,建议使用英文字母或数字
    用户资料
    自定义字段
    自定义字段的关键字必须是英文字母且长度不得超过8字节,自定义字段的值最长不能超过500字节
    UserSig
    有效期
    用户密码,即时通信 IM 后台 SDK 默认接口生成的签名有效期为180天
    会话管理
    最近联系人数量
    每个用户默认保存100个最近联系人,专业版、专业版Plus和企业版最多支持500个最近联系人,可在控制台自助配置
    用户关系链
    好友及分组
    单个用户支持3000个好友
    添加好友时未读消息最多支持100条
    好友分组最多支持32个
    每个分组的名称最长30字节
    好友备注最长支持96字节
    WebIM 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个成员,但群成员数上限同时受不同群组类型的特性约束,详情请参见 群组功能
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持