Key benefits
- Reduced user anxiety. End users receive continuous updates about their queue position and estimated wait time.
- Increased transparency. Real-time visibility into queue status builds trust and sets clear expectations.
- Alternative messaging. Automatically sends a customized message when queue conditions exceed defined thresholds.
- Pattern analysis. Collected queue data helps identify peak times and typical response times.
Prerequisites
- A handover provider is configured. Real-time queue notifications are supported by Cognigy Live Agent, Salesforce Enhanced Chat, and Genesys Cloud Open Messaging.
- For Genesys Cloud Open Messaging, an active Amazon EventBridge Source integration and admin access to Genesys Cloud to configure use and integration settings are required.
- The endpoint that supports the selected handover provider is configured. For testing purposes, you can use the Webchat v3 endpoint with Demo Webchat.
How it works
To set up real-time queue notifications, follow these steps:- Configure the following nodes in your flow:
- Handover to Human Agent node or AI Agent node with the Handover to Human Agent tool — allows queue position and wait time tracking.
- Lookup — routes the flow based on handover status.
- If — evaluates queue conditions.
- Say — displays queue updates or alternative messages to the user.
- Go To — loops back to continue monitoring the queue.
- Configure the provider-side settings to enable queue notifications for Salesforce Enhanced Chat or Genesys Cloud Open Messaging.
- (Optional) Configure the Agent Copilot workspace.
Configure settings for handover to human agent node or tool
- Handover to human agent node
- Handover to human agent tool
- In the flow editor, add a Handover to Human Agent node.
- In the Handover to Human Agent node, select Live Agent, Salesforce Enhanced Chat, or Genesys Cloud Open Messaging from the Handover provider list.
- For the queue position, configure the following:
- Queue position — activate the setting to retrieve the end user’s current queue position. This setting isn’t available for Genesys Cloud Open Messaging, which doesn’t provide a queue position. If you use Genesys Cloud Open Messaging, skip this step and go to step 4.
- Update interval — enter the interval (in seconds) to receive updates on the queue status. For example, set the interval to
30seconds to receive updates every half-minute. This setting is applicable only to Live Agent.
- For estimated wait time, configure the following settings:
- Estimated wait time — activate the setting to retrieve the estimated wait time for the end user.
- Update interval — enter the interval (in seconds) to receive updates on the wait time. For example, set the interval to
30seconds to receive updates every half-minute. This setting isn’t available for Salesforce Enhanced Chat.
- Configure alternative update options:
- Fallback message — activate the alternative update options that trigger when certain conditions are met, such as reaching the maximum queue position or maximum estimated wait time.
- Maximum queue position — enter the maximum queue position. If you set this to
5, the system sends an alternative message when the user’s position exceeds 5. This setting isn’t available for Genesys Cloud Open Messaging, which doesn’t provide a queue position. - Maximum estimated wait time — enter the maximum estimated wait time in milliseconds. Set this to
300000milliseconds (5 minutes). If the estimated wait time exceeds this time, the system sends the alternative message set in the Message text field. - Message text — enter a message that is sent when either the maximum queue position or maximum wait time is reached. For example,
Thank you for your patience. We are experiencing higher than usual wait times. Please hold on, and an agent will assist you shortly.
- Click Save Node.
Add lookup node
- Below the Handover to Human Agent node or tool, add a Lookup node.
- Click the Lookup node and select Handover Status from the Type list.
- Click Save Node.
- In the Case node of the Lookup node, select Queue from the Handover Status list and click Select.
- Click Save Node.
- Remove the second Case node.
Add if node
- Below the Case node, add an If node.
-
In the If node, click Use Advanced Editor and add the following condition:
where:
{{input.data.request.position}} < 2— checks if the customer’s position in the queue is less than 2. If true, it means the customer is either in first or second position in the queue.{{input.data.request.estimatedWaitTime / (1000 * 60)}} < 200— calculates the estimated wait time in minutes. The estimated wait time is provided in milliseconds. Dividing it by(1000 * 60)converts it to minutes. This CognigyScript expression checks if this wait time is less than 200 minutes. If true, it means the estimated wait time is manageable.
- Click Save Node.
Add say nodes
- Below the condition Then, add a Say node.
-
Click the Say node and enter the following text into the Text field:
where:
input.data.request.position— the user’s current position in the queue.input.data.request.estimatedWaitTime / (1000 * 60)minutes — the estimated wait time in minutes. TheestimatedWaitTimeis initially provided in milliseconds. It’s divided by 1000 to convert it to seconds, and then by 60 to convert it to minutes.
- Click Save Node.
-
Below the condition Else, add another Say node and configure the following:
- Text — enter
{{input.handover.data.alternativeText}}. This CognigyScript expression returns the text from the Message text field of the Handover to Human Agent node or tool that you configured earlier. - (Optional) Label — enter
Alternative text.
- Text — enter
- Click Save Node.
Add go to node
- Right-click the Lookup node and select Set Entrypoint.
- Below the Say nodes, add a Go To node.
- In the Go To node, configure the following:
- Select Flow — select the current flow.
- Select Node — select Lookup.
- In the Advanced section, select Go to Node and wait for Input from the Execution Mode list.
- Click Save Node.

Configure settings in Salesforce Enhanced Chat
If you use Salesforce Enhanced Chat as your handover provider, activate queue notifications in the Salesforce settings:- In Salesforce, go to the Setup page, enter
Messaging Settingsin the Quick Find box, and click Messaging Settings. Alternatively, go to Feature Settings > Service > Messaging > Messaging Settings in the navigation menu. - In the Channels section, find the channel you want to configure, click the arrow-down icon, and select Edit.
- Go to the Queue wait time and position section.
- From the Notification list, select one of the following options:
- Estimated wait time — sends the estimated wait time to the end user.
- Queue position — sends the user’s current position in the queue.
- Click Save.
Configure settings in Genesys Cloud Open Messaging
If you use Genesys Cloud Open Messaging as your handover provider, real-time queue notifications rely on the Amazon EventBridge integration. Complete the following configuration in Genesys Cloud.Genesys Cloud Open Messaging doesn’t provide a queue position. Estimated wait time is the only parameter available and is calculated internally by Genesys Cloud Open Messaging.
1. Add the user.start topic filter to the integration
1. Add the user.start topic filter to the integration
Cognigy needs to receive the event indicating when a human agent accepts (answers) a conversation. This event is delivered through the Amazon EventBridge Source’s event stream.
- In Genesys Cloud, go to IT and Integrations > Integrations.
- On the Integrations page, select the Amazon EventBridge Source that you created previously.
- Open the Configuration tab.
- Go to Properties > Topic Filtering.
- Select
v2.detail.events.conversation.{id}.user.start. - Click Save and Activate.
2. Set the maximum capacity
2. Set the maximum capacity
Estimated wait time is only calculated once an agent has reached maximum capacity and additional conversations are placed on hold.
- In Genesys Cloud, go to Digital and Telephony > Interaction Assets > Utilization.
- On the Organization tab, go to Channels.
- In the Message row, click Edit in the Actions column.
- Set Maximum Capacity to
1, or the value needed for your setup.
(Optional) Agent Copilot
If you use the Agent Copilot workspace and Agent Copilot is active in your contact center, the Agent Copilot flow needs additional configuration to send queue update messages. To configure the Agent Copilot flow for sending queue update messages, complete the following steps:- Add a Handover to Human Agent node to the Agent Copilot flow. Configure this node the same way as the Handover to Human Agent node in your main flow.
- Add a Lookup node for the Queue status, followed by an If node, Say nodes, and a Go To node. Mirror the logic you already configured in the main flow:
- Add Lookup node
- Add If node
- Add Say nodes
- Add Go To node. In the Agent Copilot flow, point the Go To node to the Agent Copilot flow’s own Lookup node so the queue keeps updating.
- In the main flow, below the Case node that checks the Queue status, add a Go To node that points to the Agent Copilot flow’s Lookup node.