Skip to main content
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: Typing @ suggests Semi, @room and the teammates in your account. A mention sends that person an assistant_room.mentioned notification, 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.