| Feature | Limit Item | Limit Description |
|---|---|---|
| One-to-one/group chat message | Content length | The maximum length allowed for a single one-to-one chat or group chat message is 8,000 bytes. If this limit is exceeded, the message will be discarded by the system. |
| Sending frequency | The length of a single message cannot exceed 8,000 bytes. We recommend that the frequency of sending messages to the same account not exceed 10 messages per second. When the target account is online, messages can be received normally even if the limit of 10 messages per second is exceeded. When the target account is offline, only 10 messages per second will be saved, and those beyond this limit will be discarded. |
|
| File size | A file sent through the SDK can be up to 100 MB. | |
| Retention period of historical messages | Historical message retention is available for one-to-one chat messages and non-AVChatRoom group messages. You can log in to the IM Console to modify configurations. The default retention periods for different billing plans are as follows:
|
|
| System message | Quantity and retention duration | Up to 100 system messages can be stored for up to 7 days. |
| UserID | Naming rules | The user ID can be up to 32 bytes in length and can contain letters and digits. Special characters are not allowed. |
| User profile | Custom field | The keywords of custom fields can be up to 8 bytes in length and can contain only letters. The values of custom fields can be up to 500 bytes in length. |
| UserSig | Validity period | User passwords are signatures generated by the default API of the IM backend SDK. Their validity period is 180 days. |
| Conversation management | Number of recent contacts | Up to 100 recent contacts can be saved for a common user. |
| User relationship chain | Friends and friend lists | |
| Blocklist | A single user can block up to 1,000 users. | |
| Group | Number of groups | Maximum number of concurrent groups, excluding disbanded groups, supported by an SDKAppID. If the upper limit is reached, you can disband unnecessary groups and then create new ones. The limits for different billing plans are as follows: Up to 10,000 groups can be added per day, and up to 100,000 groups can be added for free per month. If this free quota is exceeded, fees for usage exceeding the free quota will be charged. |
| Number of group members | For AVChatRoom groups, group members are unlimited. For non-AVChatRoom groups, the default limits for different billing plans are as follows:
|
|
| Number of groups a user can join | Total number of groups, regardless of group types, that a single user can join at the same time. The limits for different billing plans are as follows: |
|
| Group profile | Length limits of different fields in a group profile are as follows: |
|
| Custom group ID | A custom group ID can contain only printable ASCII characters (0x20-0x7e) of up to 48 bytes in length. To avoid confusion with the default group IDs assigned by the IM service, a custom group ID cannot be prefixed with @TGS#. | |
| Group custom field | A group supports up to 20 custom fields: |
|
| Group member custom field | A group member supports up to 5 custom fields: |
This document lists only the RESTful APIs that have use limits. For a complete list of APIs, see RESTful API List.
| Limit Item | Limit Description |
|---|---|
| Call frequency |
|
| API | Limit Description |
|---|---|
| Importing multiple accounts | Up to 100 usernames can be imported at a time. However, the API does not support the direct import of account nicknames and profile photos. |
| Querying online status of accounts | A single request can query the status of up to 500 users. |
| API | Limit Description |
|---|---|
| Sending one-to-one chat messages in batches | A single request can send one-to-one chat messages to up to 500 users. |
| API | Limit Description |
|---|---|
| Importing friends | A single request can import up to 1,000 friends. |
| API | Limit Description |
|---|---|
| Adding group members | A maximum of 100 members can be added at a time. |
| Deleting group members | A single request can delete up to 500 members. |
| Querying a user's identity in a group | A single request can query up to 500 accounts. |
| Batch muting and unmuting | A single request can mute/unmute up to 500 accounts. |
| Sending common messages in a group | The default sending frequency of a single group is limited to 40 messages/second. If 2 messages sent within 5 minutes from the same sender are same in the value of the `Random` parameter, the later message will be discarded as a duplicate message. |
| Importing group messages | A single request can import up to 20 messages. Messages must be imported in ascending order by timestamp. The timestamps of imported messages must be earlier than the current time and later than the group creation time. Otherwise, the import will fail. |
| Importing group members | AVChatRoom does not support group member importing. A single request can import up to 500 group members. However, this limit is also restrained by the feature limits of different group types. For more information, see Group Features. |
Was this page helpful?