Limitations
This page introduces the usage limits of Chat, including limits to the user, the message, the group, the chatroom and the call limit of the server APIs.
User attributes
The user attributes UserInfo Includes the user avatar, nickname, email address, and so on. The total length of the user information for one user must be 2 KB or less, and the total length for all users under an app must be within 10 GB or less.
Message length
The length limits of the different types of messages are as follows:
Message type | Length limit | Related API |
---|---|---|
Text message | 5 KB | createTxtSendMessage |
Image message | 10 MB | |
Voice message | 10 MB | |
Video message | 10 MB | |
File message | 10 MB | |
Transparent transmission message | 5 KB | createSendMessage |
Customized extended message | The size of the extended message must not exceed that of the original message. | createSendMessage |
Customized message | 5 KB | createSendMessage |
Group-related limits
Group attributes
When a group createGroup is created, the length limits of the group information are as follows:
-
Group name: 128 characters or less
-
Group description: 512 characters or less
-
Group extension information: 1024 characters or less
Chatroom-related limits
Chatroom attributes
When a chatroom createChatRoom is created, the length limits of the chatroom information are as follows:
-
Chatroom name: 128 characters or less
-
Chatroom description: 512 characters or less
RESTful API Call limit of server-side
The RESTful API call frequency limit of each method varies. For details about each method, see Chat RESTful API Reference.
If the provided call frequency limit cannot meet your business requirements, contact support@agora.io.
Enable and configure Chat
Before using Chat, you need to enable and configure the Chat service at Agora Console.
Prerequisites
Before enabling the Chat service, make sure that you have the following:
-
A valid Agora account.
-
An Agora project that uses APP ID + Token as its authentication.
-
A Chat pricing plan. For how to subscribe to a plan, see Subscribe to the pricing plan.
Subscribe & enable the Chat service
-
Log in to the Agora Console.
-
In the left navigation bar, click Project Management and click Config for the project that you want to use.
-
In the Features section of the Edit Project page, click Enable next to Chat to enable the service.
If this is the first Project under this CID that enables Chat, you need to select and subscribe a proper Chat package.
When enabling Chat service, you need to select a data center closest to where most of your end users are located.
Once the Chat service is enabled, you are redirected to the Chat config page. You can then enable the below advanced features of Chat based on your business requirements.
For details about these advanced features, see the following:
- Message Callback
- Message Thread
- Reaction
- Offline Message Push (Advanced)
- Presence
- Translation
- Moderation
Get the information of the Chat project
Agora Console assigns the following information to each project that enables the Chat service:
- Data Center : Agora provides several data centers for the service in different regions, including Beijing1 (China), Beijing VIP (China), Singapore, Frankfurt (Germany), and Virginia (USA). After the plan is changed, the data center remains unchanged.
- AppKey : The unique identifier that the Chat service assigns to each app. The rule is
${OrgName}#{AppName}
. - OrgName : The unique identifier that the Chat service assigns to each enterprise (organization).
- AppName : The name that the Chat service assigns to each app. Each app under the same enterprise (organization) must have a unique App Name.
- API request url : The domain of the WebSocket and RESTful API request that Agora assigns to each project.
Follow these steps to get the project information:
- Find the project that has enabled the Chat service on the Project management page at Agora Console, and click Config.
- On the project edit page, find Chat and click Config.
- On the project config page, get the values of Data Center , AppKey , OrgName , AppName , WebSocketAddress , and REST API.
Disable Chat
Enter the Chat config page, click Application Information in the left navigation bar.
In the application information page, click Chat service switch to disable Chat.
NOTE: All Chat data will keep store in Chat data center when the service is disabled, so we will still charge the plan activation fee.
Switch Plan
-
Log in to the Agora Console.
-
In the left navigation bar, click Package and enter Chat Subscribe page.
-
In this page, you can click Subscribe button to change the Chat Plan.
NOTE:
-
Plan switch will be effective immediately.
-
Agora doesn't recommend downgrading, which could impact the capacity of your applications and availability of certain features.
Unsubscribe Chat
In the Chat Subscribe page, you can click Unsubscribe button to unsubscribe Chat.
NOTE:
-
Please disable all projects enabled Chat first.
-
After unsubscribe Chat, all chat related data will be purged.
-
Please note that you will still be billed with a pro-rated monthly fee and the usage occurred during the month.
Next steps
After enabling and configuring Chat Service, the Chat-related features in Agora Analytics are enabled by default to help you keep track the usage trends and quality details. For more information, see Data Insights and Data Metrics.