限制条件

本文简要介绍环信即时通讯 IM 的使用限制条件，包括调用频率、字符串大小和编码格式等。

用户注册

• 用户 ID：长度不能超过 64 字节，支持以下字符集：
  • 26 个小写英文字母 a-z；
  • 26 个大写英文字母 A-Z；
  • 10 个数字 0-9；
  • “_”, “-”, “.”。

提示

• 该参数不区分大小写，因此 Aa 和 aa 为相同用户名；
• 请确保同一个 app 下，用户 ID 唯一；
• 用户 ID 是会公开的信息，请勿使用 UUID、邮箱地址、手机号等敏感信息。

• 批量注册每次最多 60 个用户 ID。

好友数限制

根据不同的套餐版本，用户好友数有如下限制：

套餐版本	好友人数上限
免费版	100
专业版	3,000
旗舰版	无上限
尊享版	无上限

消息存储时长限制

根据不同的套餐版本，消息存储时长有如下限制：

套餐版本	消息存储时长
免费版	3 天
专业版	7 天
旗舰版	90 天
尊享版	180 天

群组限制

根据不同的套餐版本，群组有如下限制：

套餐版本	群组总数	群成员数	用户可加入群组数
免费版	100	100	100
专业版	100,000	300	600
旗舰版	无上限	3,000	无上限
尊享版	无上限	8,000	无上限

群组属性和群成员属性的限制如下：

• 群组名称，字符串类型，最大长度为 128 字符。
• 群组描述，字符串类型，最大长度为 512 字符。
• 群组扩展信息，例如可以给群组添加业务相关的标记，最大长度为 1,024 字符。
• 单个群成员的自定义属性（key-value）总长度不能超过 4 KB。对于单个自定义属性，属性 key 不能超过 16 字节，value 不能超过 512 个字节。

聊天室限制

根据不同的套餐版本，聊天室有如下限制：

套餐版本	聊天室总数
免费版	10
专业版	100
旗舰版	无上限
尊享版	无上限

聊天室名称，用户自定义，字符串类型，最大长度为 128 字符。 聊天室描述，用户自定义，字符串类型，最大长度为 512 字符。

聊天室自定义属性（key-value）

每个聊天室最多可有 100 个自定义属性，每个应用的聊天室自定义属性总大小不超过 10 GB。

聊天室自定义属性为键值对（key-value）结构，单个 key 不能超过 128 个字符，支持以下字符集：

• 26 个小写英文字母 a-z；
• 26 个大写英文字母 A-Z；
• 10 个数字 0-9；
• “_”, “-”, “.”。

每个聊天室属性 value 不能超过 4096 个字符。

调用频率限制

Rest API 调用频率限制。

消息大小限制

对于不同的消息类型，消息长度限制如下：

消息类型	消息长度限制
文本消息	3 KB
图片消息	图片不能超过 10 MB，图片消息大小限制为 3 KB。
语音消息	音频文件不能超过 10 MB，语音消息大小限制为 3 KB。
视频消息	视频文件不能超过 10 MB，视频消息大小限制为 3 KB。
文件消息	附件大小不能超过 10 MB，文件消息大小限制为 3 KB。
透传消息	3 KB
自定义消息	3 KB

用户属性大小限制

默认单一用户的属性总长不得超过 2 KB。默认一个 app 下所有用户的属性总长度不得超过 10 GB。

消息撤回

默认撤回时限为 2 分钟，可根据 App Key 在环信即时通讯云管理后台单独设置。