Chat Room Channel
wss chat_room:{roomId}
The primary channel for real-time messaging. Your front-end subscribes per room to drive the chat UI and receive every text message lifecycle event for rooms the user participates in.
Where It Fits
- Connect to the WebSocket with user credentials
- Join
chat_room:{roomId}for each room the UI needs to render - Receive
message_created,message_updated, ormessage_deletedas messages flow - Send messages via
POST /me/chats/{id}/messages; this channel only delivers server-pushed events
Topic Pattern
chat_room:{roomId} where {roomId} is the UUID of the chat room.
Access Control
- The user must be a participant in the chat room to join
- Unauthorized join attempts receive an error response
Users receive message_created, message_updated, and message_deleted for text messages, plus event_created for tool_call, tool_result, thought, error, and task.
For the agent perspective on this channel (@mention-gated, and never event_created), see Agent Chat Room Channel.