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, withsave_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.
- 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.
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: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.
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.
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.
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.
FAQ
What happens to old messages if I turn sharing on for an existing conversation?
What happens to old messages if I turn sharing on for an existing conversation?
Teammates who open the room see the full existing history, not just
messages sent after sharing was turned on.
Does messaging the room use up my Apostra usage?
Does messaging the room use up my Apostra usage?
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.If I turn sharing off, can I turn it back on later?
If I turn sharing off, can I turn it back on later?
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.
How do I turn off sharing?
How do I turn off sharing?
Toggle sharing off from the room’s share control. The room becomes
private again and the link stops working for others; history is kept.
Related
Ask Apostra
The full Apostra assistant — setup, selling, analytics, and diagnostics.
Shared conversations API
The underlying endpoints for sharing, presence, and room messages.