Group chats
Group chats allow you to have a conversation with three or more users. Depending on your plan, you can have thousands of people chatting at the same time.
Group chats are great for use cases such as:
- Team chats inside a company-wide collaboration tool
- Live video streaming events with real-time discussion
- A general lobby or reception room for an online event
For more information on how to create a group chat, see: Create a group chat.
A user can have one of two types of access to a group chat, namely either as a participant or as a guest:
- Participant: A user who is a member of a conversation. Participants can read messages, send messages, and perform message actions. Among other things, participants can also be
@mentionedand appear in the conversation’s participant list. - Guest: A user who is not a member of a conversation, but instead has lightweight guest access to that conversation. Guests can read all messages, send messages, and perform message actions in a conversation. Among other things, guests cannot be
@mentionedand will not appear in conversation's participant list.
The following table gives a full overview of how participants differ from guests:
| Feature | Participant | Guest |
|---|---|---|
| Limit per conversation | 50 | Depends on plan |
| Send and receive messages | ✓ | ✓ |
| Send files, voice messages, location | ✓ | ✓ |
| React with emojis | ✓ | ✓ |
| See when people are typing | ✓ | ✓ |
| Others see when they type | ✓ | |
| Can be @mentioned | ✓ | After sending a message |
| Unread messages tracked | ✓ | |
| Desktop notifications | ✓ | ✓ |
| Email/SMS notifications | ✓ | |
| Appears in participant list | ✓ | |
| Inbox UI | ✓ | |
| Chatbox UI | ✓ | ✓ |
| Popup UI | ✓ | ✓ |
| Conversation appears in inbox | ✓ | |
| Webhooks | ✓ | Except notifications, message read |
| Fine-grained permissions | ✓ | |
| Persistent identity | ✓ |
Some features in this table need to be enabled for a user's role for them to work. This table assumes that all features are enabled.
Whether a user is a participant or a guest is specific to a group chat. A user can have participant access to one conversation, and guest access to another conversation.
Participant or guest access are each great for different types of situations. In general we can recommend the following:
| User access type | Great for |
|---|---|
| Participants | Smaller, private group chats |
| Guests | Larger, open chat rooms |
| Combination of participants and guests | Larger chats where some but not all users need to be a listed, notifiable participant |
The maximum number of users of the participant and the guest type that you can have in a single group chat depends on your plan.
We calculate the total number of users in a group chat based on how many users have that group chat open at the same time.
The following table gives an overview of the user limits per single group chat on each plan:
| Basic | Growth | Enterprise | |
|---|---|---|---|
| User limit | 300 | 1250 | Custom |
| Participants limit | 50 | 50 | Custom |
| Guests limit | Up to the user limit | Up to the user limit | Custom |
User limits on group chats apply per each single group chat. You can have as many separate group chats as the number of active users on your plan allows.
Example: On the Growth plan, you can have a total of 1250 users per each individual group chat, including a maximum of 50 participants. Hence you could have, for instance, 50 participants and 1200 guests, or 1250 guests and no participants, among many other combinations.
Users who attempt to join a conversation after it has reached the user limit will receive a message that informs them that the chat is full and asks them to try again later.
In the theme editor, under Themes in your TalkJS dashboard, you can detect group chats with a large number of participants
with the variable conversation.isGroupChat. conversation.isGroupChat is true when there are three or more participants in the chat, and false if a chat has fewer than three participants.
However, you cannot use conversation.isGroupChat to detect chats with a large number of guests. Consider creating a theme specifically for group chats with a large number of guests.