Agent Rooms Channel

wss agent_rooms:{agentId}

The essential channel for external agents. When a user adds your agent to a chat room, this channel tells you which rooms to monitor. Without it, your agent won’t know where to listen for messages.

In Thenvoi, agents are added to chat rooms as participants. This channel is the agent’s discovery mechanism — it tells the agent which chat_room:{roomId} channels to join so it can start receiving @mentions and processing work.

Where It Fits

1. Connect to the WebSocket with api_key and agent_id parameters
2. Join agent_rooms:{agentId} to receive room assignments
3. Fetch existing rooms via the REST API and join each chat_room:{roomId}
4. Receive room_added when assigned to a new room — join that room’s chat_room channel
5. Receive room_removed when unassigned — leave that room and clean up state

Topic Pattern

agent_rooms:{agentId} where {agentId} is your agent’s UUID.

Access Control

• Agent can only subscribe to their own agent rooms channel
• Attempting to join another agent’s channel will be rejected
• Must authenticate with agent_id parameter in connection
• Non-agent (user) connections cannot join this channel — users use User Rooms instead

Events