> This page is for Service Management.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Message Brokering Settings

# Overview

These settings apply to every Message Brokering handoff. Most are on **Ticketing Automation > Handoff > Message Brokering** in Moveworks Setup; per-handoff settings are on **Ticketing Automation > Handoff > Live Agent Handoff**.

# All Settings

**Ticketing Automation > Handoff > Live Agent Handoff** page:

* **App Inbound ID** (ServiceNow): the Virtual Agent API provider application to use. By default Moveworks uses **VA Bot to Bot**. Set this if you run ServiceNow Virtual Agent and Moveworks in parallel with separate provider applications.
* **Live Agent Session Timeout**: when a user can make a new live agent request while one is open. See [Live Agent Session Timeout](#live-agent-session-timeout).

![](https://files.readme.io/1896d4c96593e8b2d060e3e58e2dde857ef72b82ea0893995093722f86fbbba8-image.png)

**Ticketing Automation > Handoff > Message Brokering** page (applies to every Message Brokering handoff):

* **Agent Always Available**: skip the availability check against ServiceNow.
* **Enable Pre Chat Sys Msg Limit** and **Limit System message**: maximum system messages shown to the user before an agent joins. Set both.
* **Agent Language**: the language your agents use. Defaults to English.
* **On Demand Machine Translation**: translate messages between the user's language and the Agent Language. See [Dynamic Translation](#dynamic-translation-service-for-message-brokering).
* **Live agent transcript date format**: ISO (YYYY/MM/DD), US (MM/DD/YYYY, the default), or European (DD/MM/YYYY).
* **Enable File Attachment Size Limit** and **File Attachment Size Limit**: maximum size of one attachment, in MB. Set both.
* **Enable Total File Attachment Allowed Per Session** and **Total File Attachment Allowed Per Session**: maximum attachments per session. Set both.
* **Don't Pass Chat History**: do not send the user's recent conversation with the AI Assistant to the agent. The history options are under **Additional Controls**. See [Chat History](#chat-history).
* **Enable Live Agent Handoff Summary**: send the agent a generated summary of the conversation instead of the raw history.
* **Enable Agent Impersonation**: show the agent's name and photo on agent messages. See [Step 7](/service-management/live-agent-handoff-assistant/live-agent-message-brokering-assistant/how-to-guides-for-message-brokering#step-7-show-agent-names-and-avatars).
* **Enable Post Session Feedback Card**: ask the user whether their issue was resolved after the session.
* **Enable Post Session Trigger Creator Studio Event** and **Creator Studio Event UUID**: run a Tool Studio event when the session ends.
* **CSAT Webhook Configuration**: run an action after the session ends, for example to collect a satisfaction rating.

# Details

## Chat History

When history is passed, the agent receives the last 6 messages by default.

* **Don't Pass Chat History:** Sends no chat history to the agent when the session starts.
* **Max number of messages to pass:** Overrides the default of 6 messages in the chat history, to include more or fewer. The limit is 20 messages, counting both user and AI Assistant messages.
* **Remove links from history:** Removes hyperlinks before the history is sent to the agent.
  * For example, google.com is stored as `[https://google.com|google.com]` in Moveworks. With this setting enabled, the string becomes google.com, so agents see only the label of the URL.
* **Remove user utterances from history:** For security, you can remove user messages from the history and pass only the AI Assistant's messages.

![](https://files.readme.io/c71172a-image.png)

## Agent Image (ServiceNow)

If an agent's ServiceNow profile photo doesn't display, you can show your AI Assistant's image instead of the Moveworks stock agent image.

![](https://files.readme.io/b640e89834fef04e9950fe9b92460552265e566b9ed753a57bb2be4fefbd61a4-image.png)

To configure this setting in Moveworks Setup:

1. Go to **Core Platform > Connectors > Built-in Connectors**.
2. Select your ServiceNow connector.
3. Select **Hide the default live agent stock image**.

![](https://files.readme.io/1ee1a790617ce22b8273915240895f8da6714db2d5d60516df8e93e580a9142c-image.png)

## Dynamic Translation Service for Message Brokering

If your organization uses [Multilingual Support (MLS)](/harness/agentic-reasoning-engine/multilingual-support-assistant), messages between users and agents can be translated as they are sent. In **Ticketing Automation > Handoff > Message Brokering**, set **Agent Language** to the language your agents use (English by default) and select **On Demand Machine Translation**.

* User messages, the initial request, and the chat history are translated from the user's preferred language to the Agent Language. Agent replies are translated back to the user's preferred language.
* Translation runs only when the user's preferred language differs from the Agent Language.

![](https://files.readme.io/a9212097e4647956eb11023e17ae5ead8bacc505ca59541c333ed2523502e478-image.png)

![](https://files.readme.io/8569d18fedf5eb34500ea24458fac27834a1b712ef8ec54f2fc97686815fa234-image_66.png)

* To send text untranslated, set a **Do not translate keyword** in your Multilingual Support settings and add the Message Brokering sources under **Sources**. A message that starts with the keyword is sent as is, without the keyword. For example, an agent can type `DNT //path//folder//file` to send the path without translation.

![](https://files.readme.io/994b2ee1fcd2e9db380b4f02087f841e96759b6978c436c8a25806ffd9b9ff54-image.png)

![](https://files.readme.io/8f7adc1bcd8d423671fb7d57d7b123675de04e81163f5f7cea2f1eea4c0b89d6-image_68.png)

## Live Agent Session Timeout

The session timeout controls when a user can make a new live agent request while their current one is still open. It is measured from when the user submitted the request, including time spent waiting, and is checked only when the same user asks for an agent again:

* Within the timeout, the new request is refused because the user is already in the queue.
* After the timeout, the open session is closed and the new request starts.

The timeout does not end an idle chat. A live agent session lasts at most 12 hours. With the default of 2 minutes:

* 9:30 AM: The user selects **Submit** to start the live agent experience.
* 9:31 AM: The user tries to start another live agent session and can't.
* 9:33 AM: The user tries again. The first session is closed and a new request starts.

You can change the timeout in Moveworks Setup:

1. Go to **Ticketing Automation > Handoff > Live Agent Handoff** and open your handoff.
2. Find the **Live Agent Session Timeout** setting.
3. Enter the new value in **seconds**, for example `300` for 5 minutes. Leave it blank or enter 0 to use the default of 120 seconds.
4. Select **Save**.

The value must be a whole number, 0 or higher.