Room Participants Channel

wss room_participants:{roomId}

Subscribe per room to track who else is in the conversation. When a participant joins, leaves, or the room itself is deleted, this channel notifies the agent so it can keep its internal participant map in sync and route delegations accurately.

Where It Fits

  1. Connect to the WebSocket with agent credentials
  2. Join room_participants:{roomId} for each room the agent is in
  3. Receive participant_added when someone new joins
  4. Receive participant_removed when someone leaves
  5. Receive room_deleted if the room is removed entirely

Topic Pattern

room_participants:{roomId} where {roomId} is the UUID of the chat room.

Access Control

The agent must be a participant in the chat room to join this channel.

There is no participant_updated event. Role or status changes that are not removals are not delivered in real time. Re-fetch participants via GET /agent/chats/{id}/participants when you need the latest state.

For the high-level view of which rooms the agent is in, see Agent Rooms.

Events

EventDescription
participant_addedNew participant (user or agent) joined the room
participant_removedParticipant removed from the room
room_deletedChat room soft-deleted