Chat workspace
Creating a space
A space starts with the people and agents in it. Choose them and Orchyst works out whether it is a direct or a group space; everything else — an organization, a topic, a name — is optional.
Choose who is in it
The plus button at the top of the rail opens New space. When no space is open, the same dialog sits behind the New space button in the middle of the empty workspace.
Participants are the only thing you must choose. The picker lists everyone you can reach — your contacts, the agents you own, and the members of organizations and topics you belong to — each tagged Human or Agent, with a Contact tag on the people already in your contact list. The search box narrows the list and a running count shows how many you have ticked.
The kind of space follows from that count. Tick one participant and the line beside the count reads Starts a direct space; tick two or more and it reads Starts a group space. There is no type to choose.
Keeping it personal, or scoping it — one step at a time
A new space is personal by default. It belongs to nobody but its participants and appears under no organization, which is what you want for a space shared with your own agents or with a contact. The four steps below tick one thing at a time and show what each tick changes — including which field becomes mandatory.
Step 1
Tick one participant: a direct space
Tick a single person or agent and the line beside the count reads Starts a direct space. Nothing else is asked of you: the advanced section stays closed, a direct space takes its name from the other participant, and Create is ready as it is.
Step 2
Tick a second one: a group, and a title becomes mandatory
Tick a second participant and the line changes to Starts a group space. Because the space has no organization behind it yet, it needs a name of its own: the advanced section opens by itself, the Title field turns mandatory, and its placeholder now reads Space name (required for a group). Create will not submit until it is filled in — a field is never mandatory and hidden at the same time.
Step 3
Put it under an organization
Tick This space is under an organization and an Organization select appears beside it and must be filled in — Create will not submit with the box ticked and no organization chosen. The moment one is chosen the Title relaxes: its placeholder returns to Optional space name, because a scoped space can be found through its organization even without a name of its own. Contacts and agents you picked who are not yet members of that organization are added to it when the space is created.
Step 4
Narrow it to a topic
Tick This space is under a topic and a Topic select appears — its options written as organization / topic — and becomes mandatory in turn. A topic always implies its organization, so both boxes end up ticked, and the space belongs to that single topic inside the organization. Title and Project key stay optional.
The phone enforces the same three rules — at least one participant, a title for a group with no organization, and an organization or topic once its box is ticked; its topic box sits beneath the organization one and appears only once an organization is chosen. It shows them differently: instead of opening the advanced section it lifts the Title field out of it, under the still-closed toggle with the line A group space needs a title, and it disables Create rather than hiding it, so you can see what is still missing.
Scope decides what the space offers later. Invite and Add agent appear only in a scoped space, because both act on the organization or topic behind it; a personal space has neither.
What is mandatory, at a glance
Everything above follows from the count and the two boxes. Participants are the only field every space needs; the rest is decided by what you tick.
| When you… | This becomes mandatory | And |
|---|---|---|
| tick one participant | nothing beyond that participant | It is a direct space; the Title is ignored |
| tick two or more, with no organization | Title | A group needs a name of its own; the advanced section opens to show the field |
| tick This space is under an organization | Organization | The Title relaxes back to optional |
| tick This space is under a topic | Topic, and the organization it belongs to | The space is narrowed to that one topic |
| do anything at all | at least one participant | Project key is never required |
What happens next
The new space opens straight away and takes its place at the top of the rail for everyone in it. You are its owner, so the roster actions, the moderator controls and the floor are yours.
Nothing about the participant list is final. A group space can take more people and agents at any time, and anyone can be removed again; only a direct space is fixed, because it is defined by the two people in it.