Rooms

Rooms are used to organize and logically separate your users and chat messages into ‘rooms’. They are the entry object into using chat and provide access to all other chat features, such as messages, online status and typing indicators.

A room can represent a 1:1 chat between an agent and a customer, a private message between two users in a chat application, a large group conversation, or the chat section of a livestream with thousands of users.

Use a Room

Users send messages to a room and subscribe to the room in order to receive messages.

Tab Title

Tab Title

Tab Title

Tab Title

Attach to a Room

To start receiving messages and events from a room, you need to attach to it:

Tab Title

Tab Title

Tab Title

Tab Title

Room Status

A room can have any of the following statuses:

Status	Description
initializing	The library is initializing the room.
initialized	The room has been initialized, but no attach has been attempted yet.
attaching	An attach has been initiated.
attached	An attach has succeeded. In the attached status a client can publish and subscribe to messages.
detaching	A detach has been initiated.
detached	The room has been detached by the client.
suspended	The room, having previously been attached, has lost continuity.
failed	An indefinite failure condition.

Use the status property to check which status a room is currently in:

Tab Title

Tab Title

Tab Title

Tab Title

Next Steps

• Learn about messages
• Explore presence
• Understand typing indicators
• Discover room reactions