Custom Queue

Go to Manage → Queues to set up a Custom queue used to distribute custom activities.

Create a New Custom Queue/Edit a Custom Queue

Go to Manage → Queues.

To create a new queue from scratch, click Add new and select Custom.

To use an existing queue as a template for your new one, click Clone in the Actions column.

To edit an existing queue, click its title.

The queue details will open.

Custom Queue Details

Fill out the Unique queue number, Title and Description (optional), then set up your queue.

Queue Field Details

Open more settings using the Extended button in the top right corner.

Field	Description
Advanced settings
Max. waiting time	Select the maximum time the caller can remain in the queue before chat termination.
Agent ring time	Select how long the agent has to answer the activity. Activities will be routed to the next agent after this time passes.
Sleep time	Select the length of the delay between the activity ringing ending at an agent (Agent ring time running out) and beginning to ring at another agent.
Priority	Set the queue's priority for distribution of activities to agents: 0 – highest, 10 – lowest. When agents are logged in to several queues, activities from queues with a higher priority will be distributed to them first.
Automatic Pause	Select if an agent that rejects or doesn't answer an activity should automatically be put on the Lazy pause.
Wrapup time	Select the amount of time that needs to pass before a new activity can be routed to an agent that has just finished an activity (the length of the Wrap pause).
Distribution strategy	See more information below.
Multiple statuses	Allow or disallow users to set multiple statuses for activities using this queue.
Macro links (Extended )
Links (Extended )	Set up an external URL, e.g. a customer card, that can be opened when using this queue. Name: enter the button label that appears when multiple addresses are set up. URL: enter an external URL address. You can use wildcards that will automatically be replaced with current values (all activity properties are available, e.g. {{user.title}} is the title of the user assigned to the activity). Open: enable to automatically open the external URL when an agent accepts an activity using this queue. Unique: when an agent has multiple activities in this queue open at the same time, enable to open each external URL in a separate new window. Disable to open in the same window. Popup: enable to open the external URL in a popup window instead of a new tab. Set up the width and height of the popup window.

Distribution Strategy

The distribution strategy you select determines how activities that use the queue will be allocated to your agents.

Each strategy takes into account agents' priority (also know as penalty) in the queue depending on the rights they use (0 – highest priority, 10 – lowest priority). You can set up the priorities in each queue by clicking Change in the Agents column.

Examples below illustrate how each distribution strategy distributes activities to agents. We will work with 6 agents and their priorities in the queue:

Rachel and Paul – priority 0 – the most competent to deal with activities in the queue
Tom and Sophie – priority 5 – can help out if Rachel and Paul are busy
Julia and Terry – priority 9 – should only answer activities in the queue if there is no other option

Everyone

This strategy first distributes the activity to all the users with the highest priority at once. If they are available, it will ring there until Wait time runs out or all agents reject the activity.
If there are no agents with the highest priority available or if no one in the group answers the activity, it will be distributed to all users of the next priority group.
If there are no agents available or if the activity is rejected or not answered before Wait time runs out, it will distributed to all agents
1. with higher priority if they become available while it is ringing.
2. with lower priority.

Example 1:

All agents are available.
An activity comes in via the queue and starts ringing for Rachel and Paul. Neither of them answer and Wait time runs out.
The activity starts ringing for Tom and Sophie as they have the next priority. They both reject the activity.
The activity goes back to Rachel and Paul as they are available and have the highest priority.

Example 2:

Everyone but Julia is chatting to customers.
An activity comes in via the queue and starts ringing for Julia. As it's ringing, Tom's and Sophie's activities end. Julia doesn't answer and Wait time runs out.
The activity starts ringing for Tom and Sophie. Meanwhile, Rachel's activity ends. Tom rejects the activity, Sophie doesn't answer and Wait time runs out.
The activity starts ringing for Rachel as she has the highest priority.

Everyone in Priority Order

This strategy first distributes the activity to all the users with the highest priority at once. If they are available, it will ring there until Wait time runs out or all agents reject the activity.
If there are no agents with the highest priority available or if no one in the group answers the activity, it will be distributed to all users of the next priority group.
If there are no agents with the next priority available or if no one in the group answers the activity, it will be distributed to all users of the next priority group in line, regardless of any agents that have become available in higher priorities.
If the activity is not answered even in the group with the lowest priority, distribution will start again from step 1.

Example 1:

All agents are available.
An activity comes in via the queue and starts ringing for Rachel and Paul. Neither of them answer and Wait time runs out.
The activity starts ringing for Tom and Sophie as they have the next priority. They reject the activity.
The activity starts ringing for Julia and Terry as they have the next priority. They reject the activity.
The activity goes back to Rachel and Paul – the distribution starts again from the beginning.

Example 2:

Everyone but Julia is chatting to customers.
An activity comes in via the queue and starts ringing for Julia. As it's ringing, Tom's and Sophie's activities end. Julia doesn't answer and Wait time runs out.
Because Julia is in the lowest priority, the activity goes back to the beginning, but Rachel and Paul are busy, so it starts ringing for Tom and Sophie. They don't answer and Wait time runs out.
The activity goes back to Julia as she is the only agent available in the next priority group.

Least Recent

This strategy first distributes the activity to an available agent with the highest priority.
If there are several agents that have the highest available priority, the one with the longest time since closing their last activity will be selected. If that is the same as well, the agent that has been logged in to the queue longest will be selected.
If there are no agents available or if the activity is rejected or not answered before Wait time runs out, it will go to another agent
1. with higher priority if they become available while the activity is ringing.
2. with the same priority.
3. with lower priority if there are no agents with the same or higher priority available.

If an agent is the last available one with the highest priority and they reject or don't answer an activity, it will be distributed to them again straight away (unless Automatic pause is turned on).

Example 1:

All agents are available.
An activity comes in via the queue and starts ringing for Rachel. She doesn't answer and Wait time runs out.
The activity goes to Paul. He doesn't answer and Wait time runs out.
The activity goes back to Rachel. She doesn't answer and Wait time runs out.
The activity goes back to Paul.
Unless both Paul and Rachel Go Unready or start a pause, the activity will never go to a lower priority.

Example 2:

Everyone but Julia is chatting to customers. Automatic pause is turned on in the queue, meaning that if an agent doesn't answer an activity, they will be put on an unpaid pause.
An activity comes in via the queue and starts ringing for Julia. As it's ringing, Tom's, Sophie's and Rachel's activities end (in that order). Julia doesn't answer and Wait time runs out – she is put on an unpaid pause.
The activity goes to Rachel because she has the highest priority. She doesn't answer and Wait time runs out – she is put on an unpaid pause.
Paul is still busy, so the activity proceeds to the next priority.
The activity goes to Tom as he has been inactive longer than Sophie.

Random in Priority Order

This strategy first distributes the activity to a random available agent with the highest priority to whom the activity has not yet been distributed.
If the activity is rejected or not answered before Wait time runs out, it will go to another agent to whom the activity has not yet been distributed
1. with the same priority.
2. with lower priority if there are no agents with the same priority available.
Once the activity has been distributed to all agents in all priority groups and no one has answered, the process begins again from step 1.

Example 1:

All agents are available.
An activity comes in via the queue and starts ringing for Rachel. She doesn't answer and Wait time runs out.
The activity goes to Paul. He doesn't answer and Wait time runs out.
The activity goes to the next priority group, to a random agent –Tom. He doesn't answer and Wait time runs out.
The activity goes to Sophie. She rejects it.
The activity goes to the next priority group, to a random agent – Julia. She doesn't answer and Wait time runs out.
The activity goes to Terry. He rejects it.
The process starts again from step 1.

Example 2:

Everyone but Julia is chatting to customers.
An activity comes in via the queue and starts ringing for Julia. As it's ringing, Tom's, Sophie's and Rachel's activities end. Julia doesn't answer and Wait time runs out.
Julia was the only available agent in the lowest priority – the activity will go to Rachel (Paul is still busy). She doesn't answer and Wait time runs out.
The activity goes to the next priority – first to Tom, then Sophie. They both don't answer.
The activity goes back to Julia.

Save your queue.

Don't forget to set up:

which Agents can use the queue.
the queue's relations.
the queue's widget scheme.

See Queues for instructions.

Custom activities can only be created via the Daktela API using a POST request at the endpoint /api/v6/activities with the payload:

CODE

{"type" : "CUSTOM"}

To distribute the activity in a custom queue, the API request must contain either:

the queue's unique name, e.g.

CODE

{"queue" : "869980"}

You can find the queue's unique name by opening it in the web app – the name will be displayed in the address in the browser's address bar, e.g.

yourpbx.daktela.com/manage/queues/custom/update/869980

or

a Custom record type's unique name, e.g.

CODE

{"record_type" : "types_60fa7c3025547213196671"}

The Custom record type must also be linked with the queue.

You can find the custom record type's unique name by opening it in the web app – the name will be displayed in the address in the browser's address bar, e.g.

yourpbx.daktela.com/manage/recordTypes/update/types_60fa7c3025547213196671

You can also fill your Custom record type's custom fields via an API request with the payload:

CODE

"customFields": {"customFieldName": ["value"]}

e.g.

"customFields": {"email": ["daktela@daktela.com"]}

Notes

Least recent activity distribution: the time of the last activity is calculated based on activities in the last 2 hours.