Skip to main content
Open, Resolved and Unresolved cover most days. For the rest (waiting on the customer, escalated to billing, waiting on a courier who has gone quiet), add your own status. Use them when agents, filters and connected helpdesks need to tell sessions apart within the same built-in status.
Settings → Custom Status in your OpenCX dashboard. Creating, editing, and deleting statuses requires the Custom statuses permission under Settings in Settings → Roles. Every inbox agent can see the statuses and apply them.

How custom statuses relate to built-in statuses

Every custom status sits under one parent, shown in the Counts as column: A session carries at most one custom status. Applying one moves the session to its parent status. Choosing a built-in status from the same menu removes the custom status. A custom status under a closed parent closes the session with the same rules as a normal close, including any Structured Fields your workspace requires before closing.

Create a custom status

Creating the custom status Waiting on finance under Open in Settings, Custom Status, and seeing it in the list

Add a status under Open, click Create Status, and it shows up in the list.

1

Open Settings → Custom Status

Go to Settings → Custom Status and click New status.
2

Name it and pick a parent

Enter a Status name, for example In Progress, and choose the Parent status. The name is what agents see in the inbox.
3

Describe when to use it

Add an optional Description of up to 30 words. It is for your team only and is never shown to customers.
4

Choose an icon and color

Under Icon & Color, pick an icon and a status color. The color starts as the parent’s color until you change it. The preview chip shows how the status looks in the inbox.
5

Limit it to teams (optional)

Under Teams (optional), select the teams whose agents may set this status. Leave it empty to allow every team. Admins can always set it.
6

Create it

Click Create Status. The status is available in the inbox right away.

Apply a status to a session

  • Status menu. In a session, click the status badge in the session header. The menu lists Open, Resolved, and Unresolved, each followed by its custom statuses. Pick one to apply it.
  • Send and set status. Admins can add custom statuses to the Send menu under Settings → Workspace → Replies → Send and set status. Agents then see Send and [status] beside Send and resolve and can reply and apply the status in one action. See workspace settings and Send and set a custom status.
  • Workflows. The Apply Custom Status workflow action sets a status on a session.
  • API. Set or clear a session’s custom status.
Every change is recorded on the session timeline with who made it.

Statuses limited to teams

When a status has teams selected, agents outside those teams do not see it in the status menu or the Send menu, and the server refuses the change with This custom status is restricted to specific teams. A session that already carries the status still shows it to everyone. Admins, workflows, and API keys can always apply it.

Show a status to customers in the widget

Turn on Show in widget to show the status to the customer for their sessions. Fill in Display name (up to 100 characters) and Display description (up to 30 words); both are required while the switch is on. The widget uses the status icon and color. Changing this switch requires the Channels settings permission. Each status row shows the status ID; copy it to match the status when customizing your widget.

Sync statuses with your helpdesk

When your ticketing system is Zendesk, HubSpot, or Salesforce, map each custom status to a status in that system.
1

Sync the other system's statuses

Click Sync from Zendesk, Sync from HubSpot, or Sync from Salesforce. The mapping column (Zendesk custom status, HubSpot ticket stage, or Salesforce case status) appears after the first successful sync. Sync from HubSpot appears once you have at least one custom status.
2

Check the automatic links

Each sync links unlinked OpenCX statuses to an active status with the same name and a compatible open or closed state. Links you already set are kept.
3

Correct links by hand

Use the picker in the mapping column to choose a different status, or Not linked to remove a link. A linked status that disappeared from the other system shows as not in roster until you sync again or relink it.
Applying a linked custom status updates the linked Zendesk ticket, HubSpot ticket, or Salesforce case to the mapped status. Without a link, the ticket or case only follows the session’s open or closed state. Status changes made in the other system come back to the session as the mapped custom status. For HubSpot details, including pipeline moves, see Sync custom statuses with ticket stages. With Intercom, one open status can mirror Intercom snooze; see Map snooze to an OpenCX status.

Find sessions by custom status

  • In the inbox, add the Custom Status filter to list sessions in a given status. Save it as a view to return to it.
  • In Filters → Group by, choose Custom status. Sessions without one appear under No custom status.

Edit or delete a status

Choose Edit on a status row to change any field. A new name, icon, or color shows everywhere the status appears. A new parent applies the next time the status is set; sessions that already carry it keep their current open or closed state. Moving a status between an open and a closed parent removes its HubSpot and Salesforce links, so relink it afterwards. Choosing Delete removes the status immediately, without a confirmation step, and cannot be undone. Sessions that carried it lose the custom status and keep their built-in status. The status also drops out of the Send menu.

Troubleshooting


Workspace Settings

Add statuses to the Send menu.

Inbox

Statuses, filters, and grouping in the inbox.

Teams

The teams you can limit a status to.

Custom Statuses API

Manage statuses programmatically.