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

# Shared Murph Rooms

> Bring teammates into a Murph conversation with a shareable room link

## Overview

A shared room is a Murph 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 Murph 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.

<CardGroup cols={2}>
  <Card title="One conversation, several viewers" icon="user-group">
    Everyone who opens the room sees the same transcript and the same live
    updates — no copy-paste, no separate threads.
  </Card>

  <Card title="Private by default" icon="lock">
    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.
  </Card>
</CardGroup>

***

## Turning sharing on

Any Murph conversation can become a shared room. From the conversation you
want to share, turn on the **Share** toggle in the Murph chat surface. Murph
gives you a room link shaped like:

```text theme={null}
https://interchange.io/<account-id>/murph/c/550e8400-e29b-41d4-a716-446655440000
```

Send that link to a teammate. When they open it, they land in the same
conversation with the full message history already loaded.

<Info>
  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.
</Info>

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 — Murph 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 Murph** — sends your message to Murph, the same as any other Murph
  turn. Murph 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 Murph anything. Use this to talk to teammates in the room
  without triggering a Murph response.

You can switch the default target for the whole conversation, or override it
for a single message with a leading mention:

| You type                                 | Where it goes                                      |
| ---------------------------------------- | -------------------------------------------------- |
| `@Murph can you check this pacing note?` | To Murph, regardless of the current default target |
| `@room heads up, I fixed the budget`     | To everyone in the room, not to Murph              |
| `@inez can you take a look?`             | To the room, with `@inez` kept in the message text |

While a room is open, the composer suggests `@Murph`, `@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 Murph 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.

***

## FAQ

<AccordionGroup>
  <Accordion title="Can I share a room with someone outside my company?">
    No. Shared rooms are limited to people signed in to your own
    account. There's no external sharing option.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Can a teammate delete or edit my messages in a shared room?">
    No. Anyone with room access can read the transcript and add new messages,
    but existing messages aren't editable by other participants.
  </Accordion>

  <Accordion title="Does messaging the room use up my Murph usage?">
    No. A room message (`@room` or **Message room**) doesn't invoke Murph, so
    it doesn't count as a Murph turn. Only messages sent to Murph do.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Related

<CardGroup cols={2}>
  <Card title="Ask Murph" href="/v2/setup/ask-murph" icon="sparkles">
    The full Murph assistant — setup, merchandising, analytics, and diagnostics.
  </Card>

  <Card title="Shared conversations API" href="/v2/api/murph/shared-conversations" icon="code">
    The underlying endpoints for sharing, presence, and room messages.
  </Card>
</CardGroup>