Jump to: navigation, search

Using the Extensions Attribute

T-Server supports the use of the Extensions attribute as documented in the Genesys Events and Models Reference Manual and the Platform SDK 8 .NET (or Java) API Reference.

Additionally, the Extensions attributes described in the following table are also supported.

Use of the Extensions Attribute

Extension Used In Description
Key Type

ACCOUNT_CODE

string integer

TPrivateService EventPrivateInfo

The requested or reported account code. The key name of this Extensions attribute is defined by the accode-name configuration option.

ReasonCode

string integer

TAgentNotReady EventAgentNotReady

When an account code is used as a Walk-Away code, this Extensions attribute specifies the requested or reported account code while the agent is in NotReady state. The default method of reporting the Not Ready activation information.

NO_ANSWER_TIMEOUT

string

TRouteCall

If set, the value of this Extensions attribute overrides any value set in any of the following configuration options for the current call:

  • no-answer-timeout
  • agent-no-answer-timeout
  • extn-no-answer-timeout

See, the Related Configuration Options topic for a description of these options.

NO_ANSWER_ACTION

string

TRouteCall

If set, the value of this Extensions attribute overrides any value set in any of the following configuration options for the current call:

  • no-answer-action
  • agent-no-answer-action

See, the Related Configuration Options topic for a description of these options.

NO_ANSWER_OVERFLOW

comma-separated list

TRouteCall

If set, the value of this Extensions attribute overrides any value set in any of the following configuration options for the current call:

  • no-answer-overflow
  • agent-no-answer-overflow
  • extn-no-answer-overflow

See, the Related Configuration Options topic for a description of these options.

SUPERVISED_ROUTE

string

TRouteCall

Overrides the value in the supervised-route-timeout configuration option for individual calls.

ConvertOtherDN

string integer

See, the Smart OtherDN Handling topic.

  • A value of 0 (zero) disables all conversions for the call.
  • A value of 1 forces the relevant conversion for the call.

EmulateLogin

string

TAgentLogin

  • A value of yes enables an emulated login.
  • A value of no enables a real login.

string

EventAgentLogin EventAddressInfo
EventRegistered

A value of yes indicates that the T-Server has performed an emulated login.

WrapUpTime

integer

TAgentLogin

Specifies the amount of emulated wrap-up time (in seconds) allocated to this agent at the end of a business call. This value is effective for the duration of this login's agent session. It can be overridden by the value in the WrapUpTime Extensions attribute in the TAgentNotReady request.

integer

TAgentNotReady

Specifies the amount of emulated wrap-up time (in seconds) allocated to this agent at the end of a business call. This value is effective only for the lifespan of this request.

BusinessCall

integer

Call-related events

Specifies the business type of a call. Valid values are:

  • 0/private (Private call)
  • 1/business (Business call)
  • 2/work (Work-related call)

BusinessCallType

string integer

TMakeCall TInitiateTransfer
TMuteTransfer
TInitiateConference
TMakePredictiveCall
TAnswerCall

Specifies the call business type to be used by T-Server for the new call or the answering party. Valid values are:

  • 0/private (Private call)
  • 1/business (Business call)
  • 2/work (Work-related call)

AgentLogoutOnUnregister

string

TAgentLogin TRegisterAddress

Specifies whether T-Server performs an automatic logout of an agent whenever their client application unregisters its DN from T-Server. Valid values are:

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

AssociateClientWithLogin

boolean

TAgentLogin TRegisterAddress

Specifies whether the client should be associated with the agent session.

boolean

EventAgentLogin EventRegistered EventPrivateInfo

Specifies that the client has been associated with the agent session.

AgentEmuLoginOnCall

boolean

TAgentLogin TAgentLogout

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

LegalGuardTime

integer

TAgentLogin

Specifies the amount of emulated legal guard time allocated to an agent at the end of a business call.

SyncEmuACW

integer

TAgentLogin

Specifies whether T-Server synchronizes emulated ACW and/or legal guard with the switch for native agents.

ReleasingParty

string

EventReleased EventAbandoned

Identifies which party was the initiator of the call release.
Possible values are:

  • 1 Local
  • 2 Remote
  • 3 Unknown

LinkLoad

string

EventRouteRequest

A value of 1 High indicates that T-Server is in a high watermark condition. This feature is disabled if the value of the use-link-bandwidth option is set to 0 (zero). Possible values are:

  • 0 OK
  • 1 High

Association

string

TRegisterAddress

Defines the association of a DN that is not configured in Configuration Manager. T-Server uses the none (an empty string) value when the Extensions attribute is not provided.

SwitchSpecificType

string integer

TRegisterAddress

Defines the switch-specific type of a DN that is not configured in Configuration Manager.

sdn-licenses-in-use

integer

EventServerInfo

Specifies how many SDN licenses are currently in use.

sdn-licenses-available

integer

Specifies how many SDN licenses are currently available.

PICKUP

string

TMakeCall

The value of the PICKUP Extensions attribute can be anything. If the Extensions attribute is present in the TMakeCall request, T-Server picks up the call ringing on the device specified by OtherDN attribute in the request.

ASSIST

string

TInitiateConferece
TInitiiateTransfer

The value of the ASSIST Extensions attribute can be anything. An agent can add a supervisor to a call in order to receive assistance by passing the ASSIST Extensions attribute in either of the TInitiateConference or TInitiateTransfer requests and specifying the supervisor’s device as an OtherDN in the request.

INTRUDE

string

TSingleStepConference

The value of INTRUDE Extensions attribute can be anything. A device can intrude on a call on another device by passing the INTRUDE Extensions attribute in a TSingleStepConference request and specifying in the OtherDN attribute the device with the call to be intruded on.

OrigSV-n, NumOfOrigSVs

string

EventPartyChanged, EventPartyAdded

Indicates the supervisors monitoring the main call in a transfer/conference scenario. The NumOfOrigSVs Extensions attribute indicates the number of supervisors listening to the main call.

ConsultSV-n, NumOfConsultSVs

string

EventPartyChanged, EventPartyAdded

Indicates the supervisors monitoring the consultation call in a transfer/conference scenario. The NumOfConsultSVs Extensions attribute indicates the number of supervisors listening to the consultation call.

ReleaseController

string, integer

TReleaseCall (CSTA Clear Connection)

Allows overriding the settings of the enable-controller-release configuration option.

  • 0—allows the release of the Conference controller from a third-party conference.
  • false (a positive integer)—clears the conference on the Conference controller.
This page was last edited on August 15, 2013, at 16:01.
Comments or questions about this documentation? Contact us for support!