Required Agent

Required Agent for Tasks

In systems, where tasks arrive to the e-mail queue from the Restful Task Management Interface (RTI) or Task Management Interface (TMI) interface, it is possible to define the required agent for the task, and a waiting time for this requirement. If the required agent is defined for the contact, only the defined agent can receive the task. After the expiry time, the task is available for all agents in the queue.

The required agent is defined in the RTI/TMI interface. The tasks can be TMI tasks (type TASK), ECF tasks (type XRI), e-mails (type EMAIL) or action items (type ACTION), the queue can be defined either by GUID or name, or e-mail address, and the agent either by GUID, or user name. For more information, see the Sinch Contact Pro Task Management Interface document.

Do not mix this function with Preferred Agent, see Configuring Channel Settings.

Default Expiry Time for Required Agent

You can define the time after which an agent requirement is removed from the contact in the Default Expiry Time for Required Agent field in either channel or queue settings.

To define this setting in channel settings:
  1. Open System Management > Channels.
  2. Find and open the channel.
  3. Open the E-Mail Channel block and enter the time into the field in the E-Mail Settings section.
To define this setting in queue settings:
  1. Open Queue Management > Queues.
  2. Find and open the email queue.
  3. Open the E-Mail Settings block and enter the time in the field.

The default expiry time is 1 week.

Required Agent for E-Mails

With this function, the e-mail is offered to the same agent who originally answered the e-mail but the agent’s status (not ready/ready or logged on to the queue/logged off from the queue) is also taken into consideration when the e-mail is routed. You can define this setting in either channel or queue settings.

To define this setting in channel settings:

  1. Open System Management > Channels.
  2. Find and open the channel.
  3. Open the E-Mail Channel block and in the E-Mail Settings section select On in the Use Required Agent Instead of Preferred Agent field.
To define this setting in queue settings:
  1. Open Queue Management > Queues.
  2. Find and open the email queue.
  3. Open the E-Mail Settings block and select On in the Use Required Agent Instead of Preferred Agent field.

Set the time after which there's no required agent but the e-mail can be offered to any agent with the setting Default Expiry Time for Required Agent. Both Preferred Agent and Use Required Agent Instead of Preferred Agent must be activated for the required agent function to work.

Note the difference to the the preferred agent function in which the e-mail is also offered to the same agent who originally answered the e-mail but the agent’s status has no effect. In CDT, the e-mail goes to the agent’s pending list. In Communication Panel, the e-mail is being offered to the agent until the time limit defined in Time Limit for Accepting E-Mails has been reached.

Contact Routing with Required Agent and Preferred Agent Functions

The following table shows how these functions affect contact routing.
Table 1. Effects of Required Agent and Preferred Agent Functions

Source

Required Agent in SOAP Request

Preferred Agent Setting

Is There a Preferred Agent for Contact?

Use Required Agent Instead of Preferred Agent Setting

Routing Method

TMI

No

Off

-

-

The contact is routed to any free agent.

TMI

No

On

No

-

The contact is routed to any free agent.

TMI

No

On

Yes

Off

The preferred agent routing is used.

TMI

No

On

Yes

On

The required agent routing is used.

TMI

Yes

Off

-

-

The required agent routing is used.

TMI

Yes

On

No

-

The required agent routing is used.

TMI

Yes

On

Yes

Off

The required agent routing with the agents defined in the SOAP request is used. If none of the required agents accepts the offered contact within the expiry time, then the preferred agent routing is used.

TMI

Yes

On

Yes

On

The required agent routing with the agents defined in the SOAP request is used.

IMAP

-

Off

-

Off

The contact is routed to any free agent.

IMAP

-

Off

-

On

The contact is routed to any free agent.

IMAP

-

On

No

Off

The contact is routed to any free agent.

IMAP

-

On

No

On

The contact is routed to any free agent.

IMAP

-

On

Yes

Off

The preferred agent routing is used.

IMAP

-

On

Yes

On

The required agent routing is used. The preferred agent routing is not used even if none of the required agents accepts the contact within the expiry time.