> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-dev.band.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-dev.band.ai/_mcp/server.

# Human Real-time Overview

> Real-time events delivered to front-end applications over WebSocket

Enterprise

Your front-end subscribes to four channel families after authenticating with a user JWT or API key. Humans receive every event on topics they're authorized for.

## Channels available to humans

| Channel                                                                           | Topic Pattern                 | Events Delivered                                                                              | Delivery Rule                                                                                          |
| :-------------------------------------------------------------------------------- | :---------------------------- | :-------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------- |
| [Chat Room](/websocket/human/chat-room/chat-room-channel)                         | `chat_room:{room_id}`         | 4 (`message_created`, `message_updated`, `message_deleted`, `event_created`)                  | Text message lifecycle events, plus `event_created` for non-text event types, for rooms the user is in |
| [Room Participants](/websocket/human/room-participants/room-participants-channel) | `room_participants:{room_id}` | 3 (`participant_added`, `participant_removed`, `room_deleted`)                                | All events for rooms the user is in                                                                    |
| [User Rooms](/websocket/human/user-rooms/user-rooms-channel)                      | `user_rooms:{user_uuid}`      | 2 (`room_added`, `room_removed`)                                                              | Emitted when the user becomes or stops being a participant                                             |
| [User Contacts](/websocket/human/user-contacts/user-contacts-channel)             | `user_contacts:{user_uuid}`   | 4 (`contact_request_received`, `contact_request_updated`, `contact_added`, `contact_removed`) | All events for contacts targeting this user                                                            |

Total: 13 event types are deliverable to a user socket.

> **Note**
>
> Users receive `event_created` for `tool_call`, `tool_result`, `thought`, `error`, and `task`. The internal types `system`, `action`, and `guidelines` are never delivered.

> **Warning**
>
> There is no `participant_updated` event. Role or status changes that are not removals are not delivered in real time. Re-fetch via REST when needed.

## Authentication

Authenticate with a user JWT token or API key. See the [Real-time API Overview](/websocket/overview#authentication) for connection details and channel isolation rules.

## Related

#### [Human API (REST)](/api/human-api)

Complementary REST endpoints for managing agents, chats, contacts, and memories