Properties and Constraints
This page lists the properties and limits which are applicable to various CometChat systems.
Chat widgets: Properties and Constraints
| Item | Property or Constraint | Notes |
|---|---|---|
| Number of Widgets that can be created for an app | Maximum 25 | |
| Widget name | UTF8mb4, 100 chars, No new line characters | |
| Widget version | v2 | Cannot be set programatically |
| Docked layout icon | Docked layout icon: PNG,JPG,GIF,SVG |
Webhooks: Properties and Constraints
| Item | Property or Constraint | Notes |
|---|---|---|
| Maximum number of webhooks in an app | Maximum 25 | |
| Webhook URL | Valid URL, maximum 255 characters | |
| Webhook ID | 50 characters, UTF8mb4 set, alphanumeric (without spaces) | |
| Webhook authentication username | 50 characters, alphanumeric (without spaces) | |
| Webhook authentication password | 100 characters, alphanumeric (without spaces) |
Management APIs: Properties and Constraints
| Item | Property or Constraint | Notes |
|---|---|---|
| App length | 100 characters, UTF8mb4 set | |
| App version | v3 | This is the only option available |
| Number of Collaborators that can be created (team management) | Maximum 25 |
REST APIs: Properties and Constraints
Also see REST API documentation for further information on properties and constraints for each endpoint.
| Item | Property or Constraint | Notes |
|---|---|---|
| Number of Bot users that can be created | Maximum 25 | |
| API Keys | 100 characters (UTF8mb4 Characters) | This covers all the languages and even emojis. (One emoji uses two characters). |
| Number of APIs keys that can be created for an app | Maximum 25 |
Users and Groups: Properties and Constraints
| Item | Property or Constraint | Notes |
|---|---|---|
| Character limits for UIDs and GUIDs | 100 characters | |
| Maximum users in a group (v3) | 100000 | |
| Maximum groups a user can be a part of | No limits | |
| Maximum number of friends for a user | No limits | |
| Maximum tokens for a user | No limits | |
| Maximum number of groups | No limits | |
| Maximum number of unread messages per user | No limits | |
| Maximum number of users that can be created for an app | No limits | |
| User and Group ID | 100 characters, alpha-dash (a-z, 0-9 with -and _) without spaces . | CometChat forces the UID to all lowercase. |
| User and Group name | 100 characters, UTF8mb4 set | This covers all the languages and even emojis. |
| User and Group avatar | Must be a URL, limit of 3000 characters | CometChat doesn’t save the image on its servers.. There is no limit on the image resolution. It depends on the implementation. |
| User profile | Must be a URL, limit of 3000 characters | Same as above |
| User and Group metadata | The API limit for the POST request length is 10 KB. Hence, the user’s metadata information must fit in the same limit and must not exceed 1.6 KB. | |
| User and Group tag | A user can have up to 25 tags with 100 characters per tag. The tags can be in any language. The character set must be UTF8mb4 | |
| Group password | String up to 100 characters | |
| Group description | 255 characters, UTF8mb4 set | |
| Maximum active presence subscriptions | The presence subscription will be active until 1000 users are online for a single app. if more than 1000 users go online, the presence notification starting from the 1001st user will not be sent to other users. | Note, this is the higher limit applicable across subscription for friends, users with certain roles and all users |
| Typing indicators for groups | Typing indicator will be sent for a group of up to 1000 online users. | |
| Unread message counts for groups | For a group with more than 300 members, the conversations and unread message counts are not updated. | |
| Delivery and read receipts for groups | Delivery and read receipts will be sent for for a group of up to 300 online users. |
Roles: Properties and Constraints
| Item | Property or Constraint | Notes |
|---|---|---|
| Maximum number of Roles that can be created | Maximum 25 | |
| Role UID | 100 characters, alpha-dash (a-z, 0-9 with -and _) without spaces | CometChat forces the UID to lowercase. |
| Role name | 100 characters, UTF8mb4 | This covers all the languages and even emojis. |
| Role description | 255 characters, UTF8mb4 set, any language. | |
| Metadata | No limit |
Messages: Properties and Constraints
| Item | Property or Constraint | Notes |
|---|---|---|
| Maximum file attachment size | 100 MB per message | (Includes not just the file size but entire POST body (including chat text and custom data) |
| Message data (Applicable for API calls) | Data is an arbitrary JSON structure. It accepts utf8mb4. It can have any user defined properties. but the below properties have meaning for CometChat: text, attachments, custome_data, metadata. Note: The attachment size is separate. Here, the attachment is only the attachment properties (such as URL, size, etc.). The size must not exceed 10KB for the data object. | |
| Message tags | A message can have up to 25 tags with 100 characters per tag. The tags can be in any language. The character set must be UTF8mb4. | |
| User and Group conversation tags | A conversation can have up to 25 tags with 100 characters per tag. The tags can be in any language. The character set must be UTF8mb4. | |
| Does CometChat keep soft deleted messages in its database? | Yes | |
| Does CometChat keep permanently deleted messages (by API) in its database? | No |
Calling: Properties and Constraints
| Item | Property or Constraint | Notes |
|---|---|---|
| Maximum users in a call | 50 | |
| Default frame rate for video calls | 30 FPS | |
| Resolution for video calls | Maximum - 720p, Minimum - 180p | This depends on the layout selected and the bandwidth available at the user’s end |
| Media encryption used | SRTP | |
| Audio codec used | OPUS | |
| Video codec used | H.264 |