User Inactivity Detection and Handling¶
The Inactivity Detection and Handling feature allows you to detect inactivity of end users during handovers and allows you to handle this inactivity by auto-closing the handover, configuring automated responses or trigger further actions. This feature helps to ensure that human agent's resources are being used more efficiently.
Configuring several nodes is required to use The Inactivity Detection and Handling feature:
Below, we provide an example of how to set up Inactivity Detection and Handling, which can be customized to meet your specific needs.
Set up Handover to Agent Node¶
To ensure proper detection and handling of inactivity during queue time or active handovers, follow these steps:
- In the Flow editor, add the Handover to Agent Node.
- Open a Node editor by clicking the Handover to Agent Node.
- In the Node editor, go to the Event Settings section:
- Toggle on the Send Queue Event and Send Active Event settings:
- Send Queue Event - if enabled, an event is sent to the Flow once the end user enters the queue. This is a pre-requisite to detect inactivity while the end user is in the queue.
- Send Active Event - if enabled, an event is sent to the Flow as soon as the handover becomes active, that is when the human agent sends the first message. This is a pre-requisite to detect inactivity while a handover is active.
- Click Save Node.

Set up Lookup Node¶
Set up the Lookup Node with handover statuses:
- In the Flow editor, below the Handover to Agent Node, add the Lookup Node.
- Open a Node editor by clicking the Node.
- In the Node editor, go to the Type setting and select Handover Status from the list.
- Click Save Node.
- Go to the child Nodes:
5.1 Click the Case Node.
5.3 In the Value field, specify theactive
handover status if you want to detect and handle inactivity while the end users are in the queue.
5.4 Click Save Node.
5.6 In the Value field, specify thequeue
handover status if you want to detect and handle inactivity while the end users are in the queue.
5.7 Click Save Node.
- Add completed and error child Nodes by analogy.
Set up Set Handover Inactivity Node¶
If you want to detect inactivity during the queue time, the first timer should be started once the end user enters the queue.
To do this, add the Once Node to start the inactivity timer when you receive the queue event:
- Below the queue child Node, add Once Node.
- Below the On First Time child Node, add the Set Handover Inactivity Node.
- In the Set Handover Inactivity Node, specify the inactivity timeout in minutes, for example,
1
. On each incoming user input, the timer is automatically reset and starts from the beginning. Once the timer expires, an inactivity event is sent to the Flow. - Click Save Node.
- Repeat the same steps for the active child Node in case you want to detect and handle inactivity during active handovers.

The timer is set in minutes and may vary by up to one minute. If there is no end user input, the timer will expire after the specified time. If an end user input is received before the timeout, the timer will automatically reset and start from the beginning.
Set up Go to Node¶
Set the Go to Node to return to the Handover To Agent Node. This moves the entrypoint directly above the Lookup node, allowing the Flow to execute the correct Lookup child branch based on incoming events.

Set up If Node¶
An example of how detected inactivity could be handled is explained here:
- Add the IF Node at the end of the Flow.
- In the Node editor, specify
input.handover.inactivityCount >= 2
. This allows to handle the second detected inactivity differently from the first one. Please note that theinput.handover.inactivityCount
is reset to 0 once the End User sends a message. - Below the If Node and its Else child Node, do the following to ask the end user, based on detected inactivity, if he is still there.
3.1 Add the Say Node.
3.2 In the Say Node editor, in the text field, specifyAre you still there? The conversation will be automatically closed soon
.
3.3 In Handover Settings > Handover Output Destination, select User to only show the message to the user and not the human agent.
3.4 Click Save Node.
3.5 Add the Set Handover Inactivity Node to start a subsequent inactivity timer.
If the inactivity count is greater than two, it triggers the close handover process, which can close the handover on both the user and human agent sides. - Below the If Node and its Then child Node, do the following to auto-close the handover after the inactivity timer expired the second time in direct succession.:
4.1 Add the Close Handover Node to auto-close the handover.
4.2 Add the Say Node.
4.3. In the Say Node editor, in the text field, specifyYou are back with the bot now!
.
4.4 In Handover Settings > Handover Output Destination, select User and Agent.
4.5 Click Save Node.
If the inactivity count is less than two, it triggers prompt the user to respond to prevent the conversation from being automatically closed. The Set Handover Inactivity Node will set the time period for inactivity after which the conversation will be closed or restart a Flow from the beginning.

In the end, add the Go to Node.
Test your Flow via the demo Webchat and any connected providers, such as Cognigy Live Agent.