Use Limits

Last updated: 2020-09-15 11:02:53

    Service Feature Limits

    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 sending 10 or less messages to the same account per second.
    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:
    • Trial edition: free retention for 7 days, no extension supported.
    • Pro edition: free retention for 7 days, extension supported.
    • Flagship edition: free retention for 30 days, extension supported.
    Extending the retention period of historical messages is a paid value-added service. For specific billing information, see Value-added Service Pricing.
    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
  • A single user can have up to 3,000 friends.
  • Up to 100 pending friend requests are supported.
  • Up to 32 friend lists are supported.
  • A friend list name can be up to 30 bytes in length.
  • A friend remark can be up to 96 bytes in length.
  • 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:
  • Trial edition: 100
  • Pro or Flagship edition: unlimited

  • 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:
    • Trial edition: 20
    • Pro edition: 200, which can be extended to 2,000
    • Flagship edition: 2,000, which can be extended to 6,000
    • Increasing the maximum number of members in a single group is a paid value-added service. For specific billing information, see Value-added Service Pricing.
    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:
  • Trial edition: 50
  • Pro edition: 500 by default, which can be extended to 1,000
  • Flagship edition: 1,000 by default, which can be extended to 3,000
  • Increasing the maximum number of groups a single user can join is a paid value-added service. For specific billing information, see Value-added Service Pricing.
    Group profile Length limits of different fields in a group profile are as follows:
  • Group name: 30 bytes
  • Group introduction: 240 bytes
  • Group announcement: 300 bytes
  • Group profile photo URL: 100 bytes
  • Group name card: 50 bytes
  • 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:
  • The `Key` field is a string of no more than 16 bytes, consisting of uppercase and lowercase letters, digits, and underscores (_).
  • The `Value` field is a user-defined buffer and can be binary data. Its maximum length is 512 bytes.
  • Group member custom field A group member supports up to 5 custom fields:
  • The `Key` field is a string of no more than 16 bytes, consisting of uppercase and lowercase letters, digits, and underscores (_).
  • The `Value` field is a user-defined buffer and can be binary data. Its maximum length can be 64 bytes.
  • API Limits

    This document lists only the RESTful APIs that have use limits. For a complete list of APIs, see RESTful API List.

    General limits

    Limit Item Limit Description
    Call frequency

    Account management

    API Limit Description
    Importing multiple accounts Up to 100 usernames can be imported at a time. Direct import of account nickname and profile picture is not supported.
    Querying online status of accounts A single request can query the status of up to 500 users.

    One-to-one chat message

    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.

    Relationship chain management

    API Limit Description
    Importing friends A single request can import up to 1,000 friends.

    Group management

    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?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help