限制条件
大约 3 分钟
限制条件
本文简要介绍环信即时通讯 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 个字符。
调用频率限制
消息大小限制
对于不同的消息类型，消息长度限制如下：
| 消息类型 | 消息长度限制 |
|---|---|
| 文本消息 | 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 在环信即时通讯云管理后台单独设置。