Skip to main content

Overview

A shared room is an Apostra conversation that more than one person can open at the same time. Turn sharing on, send the link to a teammate, and they land in the exact same conversation — full message history, live presence, and the ability to post their own messages alongside anything Apostra says. Rooms stay inside your own account. Only people who already belong to your account can open a shared room link — there’s no cross-account sharing, and no way for someone outside your account to see or join.

Buyer-agent participants

Buyer-agent participants are in beta and are switched on per organization; ask your Apostra contact to turn them on. A person on the account who has write access and can read the room can add and remove the people and active buyer agents in it, and choose its lead, with save_session. An agent must work for the account: its own agent, or one with an advertiser grant on it. A room supports up to five buyer-agent participants and 100 participants in all, and always has exactly one lead. See Choose who is in a Session. To talk to your hosted buyer agent on its own instead, see Chat with your buyer agent. Everyone in a room sees every message, but only some agents answer it. A message can name the agents it is for, and Apostra finds them from those names, never by reading the words of the message.
  • Only the agents a message names answer it, and each answers once.
  • A message that names nobody goes to the room’s lead when buyer-agent participants are on for your organization. The lead is the buyer agent the room is with. When Apostra is the lead, a room message that names nobody goes to the people in the room and no agent answers it. Where buyer-agent participants are off, it goes to people only.
  • A message that names only people goes to no agent.
  • If a message names an agent that is not in the room, or is not active, Apostra refuses it before it is sent and says which agent. A lead that is not active refuses the message the same way. Where buyer-agent participants are off, naming an agent is refused.
  • A room message can’t name Apostra yet. Apostra refuses it; send that message with Ask Murph instead.
Each agent that answers receives the room’s recent messages, each naming who wrote it: a person, a buyer agent, or Apostra, with the name the room shows for them. It can then add a text-only reply attributed to that agent. These replies are room messages, not Apostra assistant turns, and they are not replayed as assistant messages in later Apostra turns. An agent without a conversational endpoint is shown in the room as unavailable rather than being silently removed. A hosted buyer agent, the agent Apostra runs for your organization, answers as the person whose message started the turn. It can do only what both its own access and that person’s access allow, just as when you chat with it on its own, so the person who asks must be a direct member of your organization. It never acts as the room’s owner or with its own access alone.
  • While it works, the room shows a line saying the agent is working on it. A hosted agent can take several minutes; its reply appears in the room for everyone as soon as it is ready.
  • If it fails or runs past its time limit, the room shows a line saying the agent didn’t answer. If Apostra restarts while the agent is working, the line says so, because the agent may still have acted on the message; check before you ask again.
  • If its work needs an approval, the reply ends with a link to each approval page that is still waiting. A person with the right access opens the link and approves or rejects it there; the agent never approves anything itself.
Each person has their own conversation with the agent in the room, so the agent remembers what you asked it earlier, and every turn also gives it the room’s recent messages.

One conversation, several viewers

Everyone who opens the room sees the same transcript and the same live updates — no copy-paste, no separate threads.

Private by default

A conversation starts private to the person who created it. Sharing is an explicit opt-in, and can be turned off again at any time.

Turning sharing on

Any Apostra conversation can become a shared room. From the conversation you want to share, turn on the Share toggle in the Apostra chat surface. Apostra gives you a room link shaped like:
Send that link to a teammate. When they open it, they land in the same conversation with the full message history already loaded.
Only the person who started a conversation can turn sharing on — a private conversation isn’t visible to anyone else, so there’s no one else who could turn it on. Once a room is shared, any teammate who can open it can turn sharing off again, which makes the room private to its original owner.
Turning sharing off does not delete anything. The conversation and its history stay intact — teammates simply lose access until sharing is turned back on.

Who can join

Shared rooms are scoped to your account. A teammate can open a room link only if:
  • They’re signed in to the same account as the room’s owner.
  • The room’s sharing toggle is currently on.
There is no mechanism to share a room with someone outside your account, and no configuration that changes this. If someone from a different account opens your room link, they get the same “not found” response as anyone else who isn’t allowed to see it — Apostra never reveals that the room exists.

Presence, mentions, and room messages

Once a room is shared, it behaves like a live chat rather than a static transcript. Presence. Everyone currently viewing the room sees who else has it open, with each teammate’s name and avatar. Presence updates live as people open and close the room — there’s no need to refresh. Two ways to send a message. The composer has two targets:
  • Ask Apostra — sends your message to Apostra, the same as any other Apostra turn. Apostra may respond, and your message is tagged with your name so teammates can see who asked.
  • Message room — posts a message to everyone currently viewing the room, without asking Apostra anything. Use this to talk to teammates in the room without triggering an Apostra response.
You can switch the default target for the whole conversation, or override it for a single message with a leading mention: While a room is open, the composer suggests @Apostra, @room, and the names of teammates in your account as you type @, so you don’t need to remember exact names. Messages sent after sharing was turned on show the sender’s name and avatar. Older messages that predate this attribution show as a generic Teammate.

Finding your rooms

Your Apostra conversation list separates rooms into two groups:
  • Live chats — shared rooms that currently have an active viewer, including you if you have the room open, with avatars showing who’s active.
  • Recents — everything else: private conversations, and shared rooms nobody currently has open.
The list refreshes automatically, so a conversation moves into Live chats as soon as a teammate opens it. Recents follows the scope you are working in: an account, advertiser, or buyer; switching a rail workspace begins a new chat scope. The rail shows the five most recent conversations for that scope; choose All to expand the rest. A chat is named after the first thing you ask (or the action that opened it), never after Apostra’s response. An empty shared room does not appear in Recents and is archived 30 minutes after its session ends if nobody sends a message.

FAQ

No. Shared rooms are limited to people signed in to your own account. There’s no external sharing option.
Teammates who open the room see the full existing history, not just messages sent after sharing was turned on.
No. Anyone with room access can read the transcript and add new messages, but existing messages aren’t editable by other participants.
No. A room message (@room or Message room) doesn’t invoke Apostra, so it doesn’t count as an Apostra turn. Only messages sent to Apostra do.
Yes, if you’re the conversation’s owner. Turning sharing off just makes the room private again — the conversation and its history are unaffected. Only the original owner can turn sharing back on, since a private conversation isn’t visible to anyone else.
Toggle sharing off from the room’s share control. The room becomes private again and the link stops working for others; history is kept.

Ask Apostra

The full Apostra assistant — setup, selling, analytics, and diagnostics.

Shared conversations API

The underlying endpoints for sharing, presence, and room messages.