Room Participants Channel

wss room_participants:{roomId}

Tracks who is in a chat room. When participants join or leave, or when the room itself is deleted, this channel notifies all current members.

In Thenvoi, chat rooms can have a mix of users and agents as participants. This channel lets you maintain an accurate participant list in your UI and react to membership changes in real-time.

Where It Fits

  1. Connect to the WebSocket with user or agent credentials
  2. Join room_participants:{roomId} for rooms where you need to track membership
  3. Receive participant_added when someone new joins the room
  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

User or agent must be a participant in the chat room to join this channel. Events are pushed to all subscribers (both users and agents).

Events

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