> ## Documentation Index
> Fetch the complete documentation index at: https://docs.semicola.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shared rooms

> Bring teammates into a Semi conversation with a room link, and talk to them without asking Semi.

A **shared room** is a Semi conversation more than one person can open at once. Turn sharing on, send
the link to a teammate, and they land in the same conversation: the full history, who else is there,
and the ability to post their own messages next to Semi's.

Rooms stay inside your account. Only people who belong to your account can open a room link. Someone
from another account gets the same "not found" as a chat that doesn't exist, so a room never reveals
that it exists.

## Turn sharing on

Every chat starts private ("Only you can see this room"). In the chat, open **Share this room** and
switch it on ("Anyone with the link can view this room"), then **Copy room link** and send it to a
teammate.

* Only the person who started the chat can turn sharing on, or delete the chat ("Only the person
  who started this chat can share it."). Once a room is shared, any teammate who can open it can turn
  sharing off, which makes it private to its owner again.
* Turning sharing off deletes nothing. Teammates lose access until it's turned back on.

Over REST: `PATCH /api/v2/assistant/conversations/{uid}/sharing`. Conversations report `sharingEnabled`.

## Talk to Semi or to the room

Once a chat is shared, the composer shows **To: Semi / Room**:

* **Semi**: your message is a normal turn. Semi may answer, and teammates see who asked.
* **Room**: your message goes to the people in the room and never asks Semi anything.

A leading mention overrides the **To:** choice for one message:

| You type                             | Where it goes                                                |
| ------------------------------------ | ------------------------------------------------------------ |
| `@Semi can you check this pacing?`   | To Semi.                                                     |
| `@room heads up, I fixed the budget` | To everyone in the room ("Everyone in this room"), not Semi. |
| `@alex can you take a look?`         | To the room, and Alex is notified.                           |

Typing `@` suggests Semi, `@room` and the teammates in your account. A mention sends that person an
`assistant_room.mentioned` [notification](/guides/notifications), which can't be switched off.

Room messages are text only: they take no attachments. Over REST, post one with
`POST /api/v2/assistant/conversations/{uid}/messages` and
`{ "audience": "room", "content": "…", "mentionedUserIds": [ … ] }` (up to 8,000 characters);
`GET /api/v2/assistant/mentionable-users` lists who can be mentioned.

## Presence

Everyone viewing a shared room sees who else has it open, with names and avatars, updated live. A
shared chat someone else is in is listed under **Live chats** in the chat list. Clients send a presence
heartbeat with `POST /api/v2/assistant/conversations/{uid}/presence`, which returns who is there.

## Buyer agents in a buyer chat

Buyer accounts also get a **Chat with** picker beside the share control, to bring one of the account's
buyer agents into the conversation. See [Buyer agent credentials](/v2/setup/buyer-agent-credentials).

## Related

* [Semi confirmations](/setup/semi-confirmations)
* [Notifications](/guides/notifications)