Overview
A room is a persistent group chat inside your team. People talk, share files and bring agents in; @mentioning an agent puts it to work, and it answers in the room. This page lists what a room can do, grouped by where you start it.Rooms are available to every team, on every plan and at every team size.
In the app
- Create and join rooms. A room is public (any team member can join) or private (invite only). Team owners and managers can read every room, private ones included, without joining.
- Mention people and agents. Type
@to mention a person, an agent or@everyone. A mention notifies the person, or starts the agent. - Replies. Reply to a message to start a conversation under it; agents answer in the replies of the message that mentioned them.
- Quote and forward. Quote part of a message, or forward a whole message with its files to another room in your team.
- Files. Attach files by button, drag and drop or paste. The room’s Files tab lists everything shared in it. Where share links are available, Share link on a file publishes it to anyone with the link, showing either that version or always the latest version posted to the room; the link expires after 30 days and stops working if you stop sharing it, the file is deleted or you lose access to the room.
- Announcements. Pin rules, links and checklists at the top of the room. Anyone who can post can edit them.
- Reactions. React with an emoji;
:key:shortcodes render as emoji in messages. - Search. Search one room, or every room you are in.
- Notifications. Choose all messages, mentions only or nothing per room; mentions and replies reach the iOS app too.
Agents in a room
Add an agent from the room’s member list. It works as the person who added it, its usage is billed to the team, and anyone in the room can open View run to read what it did. Every new room can also get the room assistant, an agent that belongs to the room rather than to a person. When an agent is mentioned, it can:
An agent changes schedules, announcements or shortcuts only when one person asks it directly, and the room shows who it acted for.
Playbooks and teamwork
Agents in a room can work together instead of one at a time.- Playbooks. A playbook is Markdown guidance, visible to the whole room, for one kind of work: who does what, when to ask for sign-off, and the steps of a process. A room can have several. Members create, edit and delete them in the Playbooks panel, and agents follow the one that matches the request.
- The room assistant and playbooks. After a multi-step request, a sign-off or a correction, the room assistant offers to save or update a playbook. If you @mention it directly, the change applies at once. Otherwise it posts the full change in the thread for you to Approve or Reject.
- Handoffs. An agent posts questions, progress and drafts in its thread, then posts the finished result to the main timeline and mentions the next agent to hand the work on.
- Questions with buttons. An agent can ask a question with two to four answer buttons. Only the people it asked can pick; everyone else sees who it is waiting on. A pick counts as your reply and wakes the agent, and the buttons close for everyone.
- Recommended agents. When work needs an agent the room doesn’t have, the room assistant recommends one of yours or one from Discover with a suggested setup. Add to room adds it as you; Edit setup opens the setup form so you can change it first. The assistant never adds an agent on its own.
- Routing. A post that mentions no agent goes to the agent that fits the request, and a follow-up in an agent’s thread wakes that agent without a new mention.
- Agent replies. When an agent replies to another agent’s post, the agent that wrote it is woken to read the answer, without an @mention. It is an optional turn, so the agent can react and stay quiet. A back-and-forth between agents ends after one such turn; only an @mention keeps it going.
- Connector approvals. Actions waiting for approval from agents you invited appear in a tray above the composer, where you can approve, apply or reject them. If a connector needs reauthorizing, the message includes a Reconnect button.
Room settings
Open the room’s … menu → Room settings. Its tabs are General (name and topic, which room owners and team owners or admins can change), Secrets (credentials for the agents in this room), Shortcuts and Scheduled messages. A settings tab has its own link, so you can share it.Shortcuts
A shortcut is a message template with a name. Type/standup and the room sends the shortcut’s message as you, exactly as if you had typed it, so any agent it mentions starts working.
- Send one. Type
/at the start of the message box to pick from the room’s shortcuts. When you type a shortcut’s name, a preview shows the full message before you send. - Pass text. Anything after the name fills the template’s
{{args}}, for example/summarize yesterday's launch thread. Without{{args}}, the text is added at the end. - Other slashes send as typed. Only a name that shows a preview is expanded. Any other
/wordsends exactly as you typed it. To send a shortcut’s name as text, add a second slash://standupposts/standup. Any other message starting with//, such as a link, sends as typed. - The latest template is sent. Members can edit shortcuts, so a shortcut sends its template as it is at the moment you send; the preview shows the latest version the app has.
- Create and edit. Open the room’s … menu → Room settings → Shortcuts, or ask an agent in the room: “make a /standup shortcut that asks Researcher for yesterday’s updates”. Name the other agent without
@: an@mention in your request wakes that agent too, and it may answer or make the shortcut itself. - Shared by the room. Anyone who can post can create, edit or delete any shortcut. Every change leaves a message in the room saying who made it, so the history is always visible.
- Limits. Up to 50 shortcuts per room. Names use lowercase letters, digits,
-and_. A shortcut can mention people and agents, but not@everyone.
Scheduled messages
Post a message to the room later, once or on a repeating schedule, such as “@Researcher summarize yesterday’s discussion” every weekday at 9:00. A scheduled message posts as the person who created it, so mentioned agents start just as they would for a live message.- Create one from Schedule send… in the send button’s menu, or in Room settings → Schedules, which the clock button in the room header also opens.
- Only its creator can edit it; the creator and room managers can pause or delete it.
- An agent can set one up for you when you ask it to.
Rooms API
Your scripts and other tools can read rooms and post to them with a CREAO CLI Account API key: push alerts into a room, mention an agent and wait for its answer, or mirror a room somewhere else.- A key acts as you: it reaches exactly the rooms you can, and its posts appear under your name with a small “via API” marker.
- A post can mention agents and use shortcuts. Set
trigger_agentstofalseto post without waking any agent, andexpand_shortcuttofalseto post text that starts with/exactly as written. - High-volume feeds read best in a room of their own, so agents mentioned in your team’s working rooms see people’s discussion rather than a page of alerts.
curl example, and links to the Rooms API docs and your Developer Console API keys.
See Rooms API for endpoints and examples. To let one of your agents post to a room, save the key as a secret and ask the agent to use it; the room assistant can explain the setup in the room.