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

# Session actions in the Inbox

> Copy, forward, merge, or start sessions, run workflows from the sidebar, and review closed sessions. Use it to find every action beyond replying.

Besides replying, you can act on a session from its **⋮** menu, start a new session with a customer, run a workflow on the session from its sidebar, and switch to a summary view of how a session ended. This page covers each action and who can use it.

> [!NOTE]
>
> In the [Inbox](https://platform.open.cx/inbox) of your OpenCX dashboard. Every action needs access to the session through your role in **Settings → Roles**; extra permissions are listed with each action.

## Use the session menu

Open a session and select **⋮** (**More options**) in the session header.

| Menu item | What it does | When it appears |
| - | - | - |
| **View options** | Shows or hides kinds of rows in the timeline (see below). | Always |
| **New message notifications** | Turns the Inbox alert sounds on or off for you. | Always |
| **Translation** | Chooses the language you read sessions in. | Always |
| **Copy conversation** | Copies a plain-text transcript to your clipboard. | Disabled until the session has a message to copy |
| **Export as PDF** | Downloads the customer-facing messages as a PDF. | Always |
| **Merge sessions into this one**, **Merge into another session** | Merges sessions permanently. | **Merge sessions** permission, with OpenCX, Zendesk, or Genesys Cloud ticketing. Disabled on a merged session or one assigned to AI |
| **Forward conversation** | Emails the conversation to someone else. | Email sessions, with OpenCX, Zendesk, or Genesys Cloud ticketing |
| **Adjust widgets** | Edits the session sidebar layout for the whole workspace. | **Helpdesk settings** write permission, on desktop |

For details, see [Session notification sounds](https://docs.open.cx/inbox/intro.md#session-notification-sounds), [Translate messages in your view](https://docs.open.cx/inbox/intro.md#translate-messages-in-your-view), [Export a session as PDF](https://docs.open.cx/inbox/intro.md#export-a-session-as-pdf), [Merge sessions](https://docs.open.cx/inbox/merge-sessions.md), and [Session sidebar layout](https://docs.open.cx/inbox/intro.md#session-sidebar-layout).

### Choose what the timeline shows

**View options** holds four switches. They change only your view, apply to every session, and are remembered in this browser for the workspace. A link to a specific comment or AI suggestion still opens it while its kind is hidden.

| Switch | Shows or hides | Default |
| - | - | - |
| **Show events** | Timeline events such as assignments, status changes, tags, and handoffs | On |
| **Group similar events** | Collapses consecutive workflow-triggered events into one expandable row. Available while **Show events** is on | On |
| **Show comments** | Internal comments, including merge entries | On |
| **Show AI suggestions** | AI Suggestion drafts written in assist mode | On |

To hide a single item instead, open its options menu and choose **Hide comment** or **Hide suggestion**. It collapses to a placeholder with **Show** to bring it back.

### Copy the conversation

**Copy conversation** puts a plain-text transcript on your clipboard, ready to paste into an email or another tool. It starts with the session number and contact name, then lists each message with its sender (**Customer**, **Agent**, **AI**, **Workflow**, or **Sequence**) and time. Attachments appear as `[attachment: file name]` lines. Agent names follow your workspace's [first-name setting](https://docs.open.cx/inbox/intro.md#agent-first-names), with aliases kept.

Internal comments and notes, unsent email drafts, call cards, timeline events, AI suggestions, and deleted messages are never copied, whatever your view options are.

### Forward an email session

Forward a session to someone outside it, such as a supplier or another team. The forward is sent as a new email session linked to this one as a sub-session.

**1. Open the forward dialog**

In an email session, select **⋮ → Forward conversation**. To forward only part of the session, open the options menu on the last message to include and choose **Forward from here**.

**2. Choose the recipient**

The **To** field starts empty, and the customer's Cc recipients are not copied. Search for a contact, or create one (this requires the **Contacts** permission with write access).

**3. Add context**

The subject starts as `Fwd:` plus the session subject. Optionally choose the **From** address, team, and assignee, and write a note for the recipient. Turn on **Internal note** to keep the note out of the email; it stays on the new session for your team only.

**4. Send**

Check the summary of messages and attachments that will be included, then select **Forward session**.

The email carries your note followed by the quoted conversation and its attachments. Internal notes, drafts, and timeline events are left out. If the attachments are larger than a forwarded email can carry, the dialog says so and the forward can't be sent. The original session's timeline records **Conversation forwarded to** the recipient's address; the customer never sees this. Forwarding requires write access to the session.

## Start a new session

Select **+** (**New Session**) at the top of the session list to contact a customer first. It requires the **New sessions** permission and one of these ticketing systems:

| Ticketing system | Channels you can start on |
| - | - |
| OpenCX | Web, Email, WhatsApp |
| Zendesk | Email |
| Genesys Cloud | Email |

Email shows as **Email (no channel connected)** until you connect an email address, and WhatsApp as **WhatsApp (no numbers available)** until you connect a number.

1. Choose the **Channel** and, for email or WhatsApp, the **From** address or number.
2. Choose a **Team**, or leave **No Team**. Picking a team limits **Assignee** to its members.
3. Choose the **Assignee**. It starts as you; you can also pick **Unassigned**, **AI Agent**, or a teammate. If the selected person isn't in the chosen team, it switches to **Unassigned**.
4. In **To**, search contacts by name, email, or phone, or select **Create a new contact** to enter a name, email, and phone. Email needs an email address and WhatsApp needs a phone number. Creating a contact requires the **Contacts** permission with write access.
5. Optionally add a subject and a first message. On web and email, turn on **Internal note** to start with a note that is not sent to the contact. On WhatsApp, choose **Custom Message** or **Template**; outside the 24-hour reply window, only a template can be sent.
6. Select **Create session**. The new session opens.

After a session is created, the dialog remembers your channel, sender, and team for next time in this browser. Closing the dialog with an unsent message asks **Discard unsent message?**; choose **Keep editing** to return to your draft.

### When the contact already has an open WhatsApp session

You can't start a WhatsApp session for a contact who already has an open session on the selected number. If you pick such a contact, the dialog shows **This contact already has N open WhatsApp sessions on this number**, with each session's number, assignee, and last update. Each number opens that session in a new tab, so your draft stays.

Reply in one of those sessions, or select **Close all open sessions**. When you have already written a first message, the button reads **Close all and continue**: it closes the listed sessions as unresolved and then creates the new one. **Create session** stays disabled while open sessions remain.

## Run a workflow on a session

The **Run Workflow** card in the session sidebar lists every active workflow that starts with the **Manual Ticket Trigger** trigger. Use it for one-off tasks that aren't tied to an automatic trigger.

1. In the session sidebar, select a workflow on the **Run Workflow** card.
2. Read the description and fill in any fields the workflow asks for. **Run workflow** stays disabled until required fields are complete.
3. Select **Run workflow**. The workflow runs in the background with this session as its context, and a confirmation shows its name.

The card is hidden when no active workflow uses that trigger; draft workflows are not listed. Running a workflow requires the **Run workflows** or **Workflows** permission, or write access to the session. Admins can move or hide the card with **Adjust widgets**, where it is named **Run workflow**.

## Review a closed session in Optimize mode

Optimize mode replaces the timeline with a short summary of how the session ended, so you can review closed sessions without scrolling through them. Press `]` while a session the AI handed off is open, or choose **Toggle optimize mode** from the ⌘K command menu on such a session.

* **Status:** **Handed Off**, **Resolved**, **Auto-Resolved**, or **Closed by Agent** for a session the AI didn't close.
* **Why was this handed off:** the AI's explanation, for handoffs.
* **Summary:** the session's AI summary.

The reply composer is hidden while Optimize mode is on. The mode stays on as you open other sessions, and is remembered in this browser, until you select **Exit optimize mode** (✕) or press `]` again on a handed-off session. A session with no AI summary shows **No AI summary available for this session**.

## Troubleshooting

| Symptom | Likely cause | Fix |
| - | - | - |
| **Forward conversation** is missing | The session isn't email, or your ticketing system isn't OpenCX, Zendesk, or Genesys Cloud | Forward from an email session on a supported ticketing system |
| The **+** button is missing | Your role lacks **New sessions**, or your ticketing system doesn't support starting sessions | Ask an admin to add the permission in **Settings → Roles** |
| Merge items are greyed out | The session is assigned to AI or already merged | Hand off or reassign the session first |
| `]` does nothing | The open session wasn't handed off by the AI | Open a handed-off session, or exit with ✕ if Optimize mode is already on |

***

## Related Documentation

> [card] [Merge sessions](https://docs.open.cx/inbox/merge-sessions.md)
>
> Combine duplicate sessions

> [card] [AI writing tools](https://docs.open.cx/inbox/ai-writing-tools.md)
>
> AI commands and suggestions

> [card] [Inbox](https://docs.open.cx/inbox/intro.md)
>
> Views, replies, and settings

> [card] [Roles](https://docs.open.cx/security/roles.md)
>
> Who can use each action


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.