Related Configuration Options

Enabling or Disabling the Emulated Agent Login

The following configuration options enable or disable the emulated agent login/logout functionality:

agent-emu-login-on-call

Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies whether T-Server allows an emulated agent login or logout on a device where there is a call in progress.

This option can be set in the Configuration Layer in the following places in order of precedence (highest to lowest):

1. The TServer section of the Annex tab of the Agent Login object.
2. The TServer section of the Annex tab of a device.
3. The TServer section of the application.

The value can also be set by using the extension AgentEmuLoginOnCall in the TAgentLogin or TAgentLogout requests. The value specified by the extension, where present, takes precedence over the settings configured in the Configuration Layer.

agent-strict-id

Default Value: false
Valid Values: true, false, passwd
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies whether T-Server allows:

• Any Agent ID to be used during login (value false)
• Only Agent IDs configured in the Configuration Layer to be used during login (value true)
• Only Agent IDs that match an Agent ID configured in the Configuration Layer and that also have a matching password (value passwd)

emulate-login

Default Value: on-RP
Valid Values:

• true—T-Server performs an emulated login.
  
• false—T-Server passes a login request to the PBX.
  
• on-RP—T-Server checks the Agent Group associated with the login request. If the Agent Group is a standard Routing Point, then the emulated login request succeeds. This value can only be set at the Application-level, and is available for backwards compatibility.

Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies whether T-Server performs an emulated agent login when the login device is configured in the Configuration Layer as a device of type extension.

This value can be set in a number of places, and T-Server processes it in the order of precedence shown below, highest first. If the value is not present at the higher level, T-Server checks the next highest level, and so on.

1. In the TAgentLogin request, using EmulateLogin Extensions attribute.
2. In the Agent Login object on the Annex tab.
3. In the login device object on the Annex tab.
4. In the device representing an Agent Group object, on the Annex tab.
5. In the T-Server Application object, in the Tserver section.
6. Using an Agent Group corresponding to an object which is configured in the Configuration Layer as a device of type Routing Point.

emulated-login-state

Default Value: ready
Valid Values:

• not-ready—T-Server distributes EventAgentNotReady after EventAgentLogin.
  
• ready—T-Server distributes EventAgentReady after EventAgentLogin.
  

Changes Take Effect: Immediately
Related Feature: Emulated Agents

When T-Server performs an emulated agent login and the client specifies an agent work mode other than ManualIn or AutoIn, T-Server uses this option to determine which event to distribute.

This option can be set in a number of places, and T-Server processes it in the order of precedence shown below, highest first. If the value is not present at the higher level, T-Server checks the next level, and so on.

1. In the Agent Login object on the Annex tab.
2. In the agent login device on the Annex tab.
3. In the login device representing an Agent Group during login, on the Annex tab.
4. In the T-Server Application object in the Tserver section.

sync-emu-acw

Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies whether T-Server synchronizes emulated ACW for native agents.

This option can be set in Configuration Manager in the following places in order of precedence (highest to lowest):

1. In the TServer section in the Annex tab of an Agent Login object.
2. In the TServer section in the Annex tab of a device.
3. In the TServer section of the application.

The SyncEmuACW Extensions attribute of the TAgentLogin request overrides the value configured for this option.

Enabling or Disabling the Automatic Agent Logout

The following configuration options enable or disable the automatic logout of the agent:

agent-logout-on-unreg

Default Value: false
Valid Values:

• true—T-Server logs out emulated and native agents on unregister.
  
• false—T-Server does not log out emulated or native agents on unregister.
  
• emu-only—T-Server logs out only emulated agents on unregister.
  

Changes Take Effect: At the next agent login session
Related Feature: Emulated Agents

Specifies whether T-Server performs an automatic logout of an agent whenever their client application unregisters the DN from T-Server. This happens whenever a client application disconnects from T-Server.

The option can be set in the Configuration Layer in the following places in order of precedence (highest to lowest):

1. The TServer section in the Annex tab of the device representing the agent's group (such as an ACD queue).
2. The TServer section of the Annex tab of the Agent Login object.
3. TheTServer section of the Annex tab of a device.
4. The TServer section of the application.

The Configuration Layer configuration setting may be overridden by adding the AgentLogoutOnUnregister Extensions attribute to the TAgentLogin request.

Any subsequent self-transition TAgentLogin request can override the current agent association by adding the AgentLogoutOnUnregister Extensions attribute with a value of true.

Similarly a TRegisterAddress request can override the current agent association by adding the AgentLogoutOnUnregister Extensions attribute with a value of true.

agent-logout-reassoc

Default Value: false
Valid Values:

• true—T-Server automatically associates a new client application with the agent.
  
• false—T-Server does not automatically associate a new client application with the agent.
  

Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies whether T-Server automatically associates as a new client application with the agent, when the application either:

• Registers on the agent DN, or;
• Sends a login request while T-Server is currently waiting to log the agent out due to the previously associated client disconnecting.

Note: The new client application must have the same application name as the previously disconnected client.

The option can be set in the Configuration Layer in the TServer section of the application.

Enabling or Disabling the Emulated ACW Period

The following configuration options enable or disable the emulated ACW period functionality:

untimed-wrap-up-value

Default Value: 1000
Valid Value: Any positive integer
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies the threshold at which the timing of ACW stops and manual intervention is required (untimed ACW).

wrap-up-threshold

Default Value: 0 (zero)
Valid Values: Any positive integer
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies the minimum period (in seconds) that a business call must last before emulated ACW is applied at the end of the call.

wrap-up-time

Default Value: 0 (zero)
Valid Value: Any positive integer, untimed

0 (zero)	ACW is disabled. Exception: If this option is set in the Annex tab of the Agent Login object, a value of 0 (zero) means that T-Server processes from Step 4 in the processing order of precedence below.
A value greater than 0 (zero), but less than the value set for the untimed-wrap-up-value option.	The number of seconds of timed ACW, after which T-Sever returns the agent automatically to the Ready state.
A value equal to the value set for the untimedwrap-up-value option.	ACW is untimed and the agent must manually return to the Ready state.
A value greater than the value set for the untimed-wrap-up-value option.	Disables ACW.
untimed	ACW is untimed and the agent must manually return to the Ready state. Note: This value cannot be set on the Annex tab of an Agent Login object.

Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies the amount of wrap-up time (ACW) allocated to emulated agents at the end of a business call.

This option can be set in a number of places, and T-Server processes it in the order of precedence shown below, highest first. If the value is not present at the higher level, T-Server checks the next level, and so on.

1. In the WrapUpTime Extensions attribute key of the TAgentPendingACW request (applies to this agent only).
2. In the WrapUpTime Extensions attribute key of the TACWInIdle request (applies to this agent only).
3. In the call, in the WrapUpTime UserData attribute (limited to ISCC scenarios).
4. In a DN configuration object of type ACD Queue or Routing Point, on the Annex tab in the TServer section.
5. In the WrapUpTime Extensions attribute key of the TAgentLogin request, (applies to this agent only).
6. In the Agent Login configuration object, on the Annex tab in the TServer section (but not including the untimed value).
7. Using an Agent Group corresponding to an object configured in the Configuration Layer as a device of type ACD Queue.
8. In the T-Server Application object, on the Options tab in the TServer section.

Enabling or Disabling Pending ACW Functionality

The following configuration options enable or disable the pending ACW functionality:

acw-in-idle-force-ready

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies whether, after timed manual wrap-up (when you have set the value of the timed-acw-in-idle to true), T-Server forces the agent to the Ready state. If this value is set to false, T-Server returns the agent to the agent's previous state prior to requesting manual wrap-up.

timed-acw-in-idle

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies whether T-Server applies the automatic wrap-up timer (using the wrap-up-time parameter) when an agent sends a TAgentNotReady request.

If the value of this option is set to false, T-Server does not automatically end manual wrap-up—the agent must return manually from ACW.

Note: For compatibility with the previous T-Server release, you can use the name timed-cwk-in-idle for this option as an alias.

Determining the Period of Legal Guard Time

The following configuration options determine the period of legal guard time:

legal-guard-reason

Default Value: LegalGuard
Valid Value: Any string
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies the value of the extension used by T-Server to indicate that the agent is in legal guard. T-Server adds this extension to EventAgentNotReady signalling the start of legal guard. If this option is set to a null string then no extension is added.

legal-guard-time

Default Value: 0 (zero)
Valid Value: Any integer from 0-30
Changes Take Effect: Immediately
Related Feature: Emulated Agents

Specifies a legal-guard time (in seconds) for emulated agents to postpone the transition to the Ready state after a business call. T-Server always considers a routed call a business call.