Outdated documentation

You are looking at the documentation for an older release. For the latest information, please see current release documentation.

Queues

Teams need a workspace and the ability to dispatch work based on skill level, security level, department or responsibility just to name a few. Other teams may also need to view or react in these requests as well.

OTRS uses queues to provide your teams with structure. Queues provide a powerful way to divide and disperse the work to the responsible group of people.

Use this screen to add queues to the system. In a fresh OTRS installation there are 4 default queues: Raw, Junk, Misc and Postmaster. All incoming messages will be stored in the Raw queue if no filter rules are defined. The Junk queue can be used to store spam messages. The queue management screen is available in the Queues module of the Ticket Settings group.

Queue Management Screen

Queue Management Screen

Manage Queues

To add a queue:

  1. Click on the Add Queue button in the left sidebar.
  2. Fill in the required fields.
  3. Click on the Save button.
Add Queue Screen

Add Queue Screen

Warning

Queues can not be deleted from the system. They can only be deactivated by setting the Validity option to invalid or invalid-temporarily.

Warning

The maximum number of 200 valid queues should not be exceeded. Exceeding this limit may affect the system performance.

To edit a queue:

  1. Click on a queue in the list of queues.
  2. Modify the fields.
  3. Click on the Save or Save and finish button.
Edit Queue Screen

Edit Queue Screen

Note

If several queues are added to the system, use the filter box to find a particular queue by just typing the name to filter.

Queue Validation Dialog

Queue Validation Dialog

If you change the name of a queue which is used in the system configuration, a validation check will warn you and give you the following options:

Save and update automatically
Apply the change and also update the affected settings.
Don’t save, update manually
Apply the change, but don’t update the affected settings. The updates need to be done manually.
Cancel
Cancel the action.

Warning

Changing the name of this object should be done with care, the check only provides verification for certain settings and ignores things where the name can’t be verified. Some examples are dashboard filters, access control lists (ACLs), and processes (sequence flow actions) to name a few. Documentation of your setup is key to surviving a name change.

Queue Settings

The following settings are available when adding or editing this resource. The fields marked with an asterisk are mandatory.

Name *
The name of this resource. Any type of characters can be entered to this field including uppercase letters and spaces. The name will be displayed in the overview table.
Sub-queue of
It is possible to add the new queue under an existing one as sub-queue. This will be displayed as Parent Queue::Child Queue.
Group *
It is possible to limit access to the selected group. The group creates a permission link between the queue and an agent or a customer user.
Unlock timeout minutes
Any ticket on open, which is locked, in this queue will automatically unlock after the set amount of minutes. The value 0 (default) means tickets in this queue remain locked.
Escalation - first response time (minutes)

Defines the time span for this queue within the defined business hours, in which an agent has to send the first reply to the customer as a visible article to a ticket created by a customer. The escalation time for the first response is cancelled as soon as the agent sends an article that is visible to the customer.

The first response time is triggered if a ticket has been created by an agent.

Once a ticket has been escalated because of exceeding the defined time span then this ticket stays in the status escalated.

The first response time escalation notification will be sent to all agents who have selected the specific queue as preferred queue in the My Queues setting and the ticket escalation notification is enabled.

Escalation - update time (minutes)

Defines the time span for this queue within the defined business hours, after which the ticket will be escalated if no further articles are written. This escalation update time is reset whenever an agent writes an article that is visible to the customer user. The escalation update time is also reset when a customer user responds to an agent article for the first time. Additional articles written by the customer user do not affect the escalation update time.

The escalation notification will be sent to all agents who have selected the specific queue as preferred queue in the My Queues setting and the ticket escalation notification is enabled.

Escalation - solution time (minutes)

Sets the time span for this queue, within the defined business hours, within the ticket has to be solved. Solved means that the ticket is set to the status closed. If the ticket is not set to solved until the time span defined here is reached, the ticket escalates.

The escalation notification will be sent to all agents who have selected the specific queue as preferred queue in the My Queues setting and the ticket escalation notification is enabled.

Once resolution time escalation has been triggered for a ticket, the ticket remains escalated.

The solution time will not reset if the ticket is reopened.

Note

The escalation settings of Service Level Agreements will overwrite the escalation settings of queues.

Follow up Option *

Specify the handling of a follow up on closed tickets. Possible values:

new ticket
The follow up will create a new ticket.
possible
The follow up will reopen the already closed ticket.
reject
The follow up will be rejected.

See also

See Auto Responses chapter for more information.

Ticket lock after a follow up *

Only applicable if the Follow up Option is set to possible. Locks the previously closed ticket, upon reopening, to the last owner. This ensures that a follow up for a ticket is processed by the agent that has previously handled that ticket.

Warning

This does not take out-of-office into account. Use this setting with care to ensure or in combination with Unlock timeout minutes.

System address *

Select one of the Email Addresses as the sender identity for this queue.

Note

This is an ID in the database. Making changes to the Email Addresses can have adverse effects here.

Default sign key
This is only active if PGP Keys or S/MIME Certificates is enabled in the System Configuration. Choose the key to sign emails per default.
Salutation *
Select one of the defined Salutations.
Signature *
Select one of the defined Signatures.
Calendar
Select the calendar which defines working hours for this queue. Calendars are defined in the System Configuration.
Validity *
Set the validity of this resource. Each resource can be used in OTRS only, if this field is set to valid. Setting this field to invalid or invalid-temporarily will disable the use of the resource.
Comment
Add additional information to this resource. It is recommended to always fill this field as a description of the resource with a full sentence for better clarity, because the comment will be also displayed in the overview table.
Chat Channel
Chat channel that will be used for communication related to the tickets in this queue.