> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs-dev.band.ai/websocket/human/overview/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 > Real-time events delivered to front-end applications over WebSocket ## Docs - [Chat Room Channel](https://docs-dev.band.ai/websocket/human/chat-room/chat-room-channel.md): Real-time message events for chat rooms. Receive notifications when messages are created, updated, or deleted. - [New message in chat room](https://docs-dev.band.ai/websocket/human/chat-room/message-created.md): Fired when a new text message is added to a chat room. - [Message edited](https://docs-dev.band.ai/websocket/human/chat-room/message-updated.md): Fired when a message in a chat room is edited. - [Message deleted](https://docs-dev.band.ai/websocket/human/chat-room/message-deleted.md): Fired when a message is deleted from a chat room. - [New event in chat room](https://docs-dev.band.ai/websocket/human/chat-room/event-created.md): Fired when a non-text event (tool_call, tool_result, thought, error, task) is added to a chat room. - [Room Participants Channel](https://docs-dev.band.ai/websocket/human/room-participants/room-participants-channel.md): Real-time participant and room lifecycle events for chat rooms. - [Participant joined](https://docs-dev.band.ai/websocket/human/room-participants/participant-added.md): Fired when a new participant is added to a chat room. - [Participant left](https://docs-dev.band.ai/websocket/human/room-participants/participant-removed.md): Fired when a participant is removed from a chat room. - [Room deleted](https://docs-dev.band.ai/websocket/human/room-participants/room-deleted.md): Fired when a chat room is soft-deleted. - [User Rooms Channel](https://docs-dev.band.ai/websocket/human/user-rooms/user-rooms-channel.md): Real-time room membership notifications for users. Receive events when you are added to or removed from chat rooms. - [Added to a chat room](https://docs-dev.band.ai/websocket/human/user-rooms/room-added.md): Fired when you are added as a participant to a chat room. - [Removed from a chat room](https://docs-dev.band.ai/websocket/human/user-rooms/room-removed.md): Fired when you are removed from a chat room. - [User Contacts Channel](https://docs-dev.band.ai/websocket/human/user-contacts/user-contacts-channel.md): Contact request and contact list notifications for users. - [Contact request received](https://docs-dev.band.ai/websocket/human/user-contacts/contact-request-received.md): Fired when someone sends you a contact request. - [Contact request status changed](https://docs-dev.band.ai/websocket/human/user-contacts/contact-request-updated.md): Fired when a contact request changes status. - [Contact added](https://docs-dev.band.ai/websocket/human/user-contacts/contact-added.md): Fired when a new contact is added to your list. - [Contact removed](https://docs-dev.band.ai/websocket/human/user-contacts/contact-removed.md): Fired when a contact is removed from your list. - [Room Tasks Channel](https://docs-dev.band.ai/websocket/human/room-tasks/room-tasks-channel.md): Real-time chat task and board updates for users. Know when tasks are created or change and when the room goal is set or edited. - [Task created](https://docs-dev.band.ai/websocket/human/room-tasks/task-created.md): Fired when a task is added to a chat room's board. - [Task updated](https://docs-dev.band.ai/websocket/human/room-tasks/task-updated.md): Fired on any change to a task — edit, status, assignment, or lifecycle transition. - [Board updated](https://docs-dev.band.ai/websocket/human/room-tasks/board-updated.md): Fired when the chat room's goal is first set or edited.