On this page
Replies never carry the workspace name. They go out with the sender name of the email channel, and renaming the workspace does not change it. Customers see the workspace name in one place: it is the title of your help center while the help center has no title of its own.
Settings pages
Settings has one page per item of its menu, each at its own address. The menu shows only the pages you can use:
- Account (
/settings/account): your profile and timezone, your preferences, the browsers you are signed in on now (a session that ended is not listed), and the AI apps you connected. - General (
/settings/general): the workspace name and timezone, and conversation numbers. - Members (
/settings/members): four tabs, kept in the address (?tab=people,invites,groups,advanced). People is the team, Invites the invites that add people, Groups is reserved (marked Coming), and Advanced holds the roles. New workspaces start with two roles, Admin and Agent; custom roles are under Advanced. - Channels (
/settings/channels): a dot after its name means a channel needs attention. Each channel type, such as Email, opens from the Channels page, not from the menu. - Response targets, Saved replies.
- AI & agents (
/settings/ai): two tabs, Built-in AI and External AI agents (?tab=built-in,external). Agent tokens are on External AI agents, a tab offered to people who make, revoke or hold agent tokens. - Conversation fields (
/settings/fields): reserved, marked Coming. The page says what is coming. - Data (
/settings/data): import from Freshdesk and export all data. - Plan and billing, on Colliedesk Cloud. A dot after its name means the last payment failed.
While you are in Settings, its menu takes the place of the sidebar, under Back to app. The sheet shows the page alone. Back to app returns to the page you were on before Settings: the conversation you had open, or the inbox when there was none. Esc does the same when nothing on the page has the focus or when the focus is in the Settings menu. When the focus is in a page's own controls, or something is open (a dialog, a menu, the account menu, a role picker), Esc only closes that, so nothing you type is lost; with text not saved, Esc from the page itself asks the question below before it leaves. You can still drag the sidebar's edge to resize it, or fold it: folded, it keeps Back to app as an arrow, and the menu comes back when you open it again.
The help center's settings are in the knowledge base, under Knowledge base → Settings, which is not a
Settings page and keeps the app's sidebar. An old link keeps working and opens the page, tab or section
that holds the content now: /settings/profile, /settings/preferences and /settings/sessions open
Account; /settings/numbers opens General; /settings/roles and /settings/members?tab=roles open
Members → Advanced; /settings/agents opens AI & agents, on the External AI agents tab; /settings/import,
/settings/export and /settings/import-freshdesk open Data; /settings/help-center and
/help-center/settings open Knowledge base → Settings. So do links to a section of the old one-page Settings, such as
/settings#invites-heading. On a phone, Settings shows the menu; open a page from it, and
‹ Settings above its title goes back.
How Settings saves
Every Settings page saves the same way.
- A choice saves when you make it. A switch, a checkbox or a pick from a list (the theme, your timezone, Show the setup guide, a switch on Response targets, a feature switch and the choices under Chat intake on AI & agents, the level of a channel's AI tab) is saved at once. The page says Saved with Undo at its foot; Undo puts the previous value back with one request. The message goes away by itself after a few seconds.
- Text waits for Save. When you type in a field (a name, business hours, a list of sites), a bar appears at the foot of the page. It says Unsaved changes and names the fields. Save keeps them all (press Ctrl+S, or ⌘S on a Mac, or Enter in a one-line field); Discard puts them back as they were. If the server refuses one, that field says why and the bar stays, so nothing you typed is lost.
Leaving a page with text that is not saved asks once: "You have unsaved changes. Leave anyway?" It asks whichever way you leave: a link in the Settings menu, Back to app, Esc, your browser's Back button, or closing the tab. Choose to stay and the text is still in the field; choose to leave and it is dropped. The same question covers text that has its own button: an invite email, a holiday, a support address, the name of a channel you are adding.
Moving between the tabs of one page (People and Invites, Built-in AI and External agents, the tabs of the built-in AI, the tabs of one channel) is not leaving it. Nothing is asked, and what you typed stays: the bar keeps naming it, and Save keeps it from any tab. An invite email you typed stays too, and creating the invite empties the form again. Opening another row's editor, or turning Measure response targets off, while text is typed asks the same question first. Signing out with unsaved text asks it as well.
After Save or Discard the focus moves to the page heading, and a screen reader hears when the bar appears and which fields it names. If Undo is refused, the toast says so and keeps Undo; the value stays as it is. If Save is refused, the bar says which field and why, also when that field is on a tab you are not looking at. Ctrl+S does nothing while a dialog is open. A name the server refuses (a rename on Members) keeps its form open with what you typed and the server's reason. Dialogs and steps that add something (invite people, create a token, add a channel) keep their own buttons.
Rename the workspace
Only people with workspace:update (the Admin role) can rename the workspace.
- Open Settings → General.
- Type the new name in Workspace name.
- Select Save in the bar at the foot of the page. "Saved" appears next to the field.
Everyone sees the new name the next time a screen loads. A name is 2 to 60 characters, as at sign-up. Spaces at the ends are removed. Line breaks and other control characters are refused. On Colliedesk Cloud a name with a well-known brand in it (for example "PayPal Support") is refused; contact us if it is your own brand.
The workspace address (the slug in support@<address>.colliedesk.com, the desk address and the help
center address) is separate. It is changed under Workspace address name in
Email channel.
The workspace address
On Colliedesk Cloud your team works at the workspace's own address, https://<address>.colliedesk.com:
the inbox and every page are there, and the help center is at /help on it. Bookmark it.
- Signing in. Sign in on your workspace's address. If your email is not an agent of that
workspace, the page says so and links to
https://app.colliedesk.com, where you find your workspace. - app.colliedesk.com is where a new team signs up and where you find your workspace: sign in there,
choose the workspace if you are in several, and the browser continues on its address, signed in.
An old bookmark of
app.colliedesk.comopens the same page on your workspace's address. - One workspace per address. A sign-in belongs to the address it was made on. Signed in to two workspaces, you have one tab per address; one never switches the other.
- Links Colliedesk sends you (invites, emails, payment and connection returns) open your workspace's address.
- Changing the workspace address moves the desk to the new address, and the browser that changed it follows, still signed in. Everyone else signs in again on the new address.
A server you run yourself works the same way when it sets
HELP_CENTER_DOMAIN; without it everything
stays on the server's one address.
For developers and AI agents
PATCH /api/v1/workspace/namewith{"name": "Acme Support Team"}renames the workspace. It needsworkspace:update(the Admin role has it), from a person or an agent token; without it the answer is 403permission_missing.- An AI agent uses
colliedesk_workspace_rename(workspace:update), and changes the address withcolliedesk_workspace_slug_change. A token created before roles cannot; it needs a new token.
Was this page helpful?
Updated
This page is rendered from the repository. Spot a mistake? Open an issue or a pull request.