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

# Salesforce Messaging queue position and wait time

## Overview

End users waiting for a live agent after a Salesforce Messaging [Handoff](/docs/handoffs) see a queue banner in the chat widget. It shows their queue position or estimated wait time. The banner reflects the values Salesforce Messaging reports while the end user is in the queue.

![Chat widget showing a Waiting for an agent banner with the text There are 20 people ahead of you](/_fern-img/3f15d97ad706120597c61b33a41e8580237171d0f5ddd35e56e87381fc4b1643.webp)

> **Note**
>
> The queue banner is shown after the Handoff starts. To branch the Handoff on agent availability before it starts, see [Salesforce Messaging agent availability](/docs/handoffs/salesforce/salesforce-messaging/salesforce-messaging-agent-availability).

## Limitations

The queue banner depends on what Salesforce Messaging sends and where the end user is chatting.

* Salesforce supports either queue position or estimated wait time per Messaging Channel, not both.
* Queue position requires a configuration change in Salesforce by a Salesforce admin. Your Ada team can't enable it on your behalf.
* The queue banner appears only in the [Messaging](/docs/channels/messaging) and [legacy Chat](/docs/channels/chat) widgets. Salesforce Messaging Handoffs from other channels don't show a queue banner.

## Capabilities & configuration

Salesforce Messaging reports the end user's place in the queue as one of two signals. The banner shows whichever signal Salesforce sends.

| Signal              | What the end user sees                          | Salesforce configuration                                          |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------- |
| Estimated wait time | The estimated wait before an agent joins        | None. Salesforce sends it automatically.                          |
| Queue position      | The number of people ahead of them in the queue | Enable **Queue Wait Time and Position** on the Messaging Channel. |

The queue banner:

* Persists across a page reload.
* Clears when the agent joins or the Handoff ends.

## Implementation & usage

Estimated wait time requires no setup. To show queue position instead, a Salesforce admin enables it on each Messaging Channel used for the Handoff.

### Set up queue position in Salesforce

Queue position is sent only when the setting is enabled on the Messaging Channel. Each Messaging Channel is configured separately.

**To set up queue position:**

1. In Salesforce **Setup**, open the **Messaging Channel** used for the Handoff.

2. Enable **Queue Wait Time and Position**.

3. Republish the deployment linked to the channel.

   The change takes effect after the deployment is republished.

4. Repeat these steps for each Messaging Channel used for Handoffs.

### Set up in Ada

No additional configuration is required in Ada. Once Salesforce sends queue position or estimated wait time, the end user sees the queue banner in the chat widget while waiting for an agent.

## Related features

Use these pages to set up the rest of the Salesforce Messaging Handoff.

* [Salesforce Messaging Handoff setup](/docs/handoffs/salesforce/salesforce-messaging/salesforce-messaging-handoff-setup)
* [Salesforce Messaging agent availability](/docs/handoffs/salesforce/salesforce-messaging/salesforce-messaging-agent-availability)

---

Have any questions? Contact your Ada team, or email us at [](mailto:help@ada.cx?subject=Help%20Docs%20inquiry).