Secondary keywords

AAIKeys

For Genesys I-Server, this is user call data used by Genesys in the form of a string array of key value pairs, for example:

Name=Agent:Customer:Bank

The key value pairs are arbitrary, and it is the responsibility of developers to extract and handle information contained in the fields. The values are supplied by the Genesys I-Server at the start of a call within:

VoiceXML session variable session.connection.aai
CCXML connection class aai field during connection.alerting and connection.connected transitions.

The AAIKeys information is changed when the VXML <transfer> tag updates call data. The information used to update the user date is held in the aai attribute of the tag. Mandatory

Example showing getting the AAI call data from CCXML:

<transition event="connection.alerting" name="evt">
<log expr="'[connection.alerting] connectionid = '+ evt.connectionid "/>
<log expr="'[connection.alerting] aai = '+ evt.connection.aai "/>
<accept connectionid="evt.connectionid"/>
</transition>

An example of setting using a CCXML dialog.transfer request (Generated from VXML):

<transition event="dialog.transfer" name="evt">
<var name="purpose" expr="'transfer'"/>
<var name="wait_for_answer" expr="true"/>
<var name="target" expr="evt.URI"/>
<var name="aai" expr="evt.aai"/>
<send target="evt.connectionid" targettype="'connection'"
   name="'ibmwvr.consult'" namelist="purpose wait_for_answer target aai"/>
</transition>

Example showing how to get the AAI call data from VoiceXML:

<log> aai : <value expr="session.connection.aai"/></log>

Example showing how to set the AAIKeys in VoiceXML for a Transfer from VXML:

<transfer dest="tel:21199;phone-context=1962"
   aai="Name=J Doe:Bank=National" bridge="true"/>

AAIKVPSeparator

Defines the separator character to be used in AAIkeys key value pairs. (See “AAIkeys”, above.) Valid separator characters are:

: ; , . | ! ^ * + - ~ #

The default value is a colon (:).

The separator character defined by AAIKVPSeparator is overridden by any optional AAI separator character specified using the <object> element to access the advanced Genesys API function RouteRequest. (See Using advanced CTI features.)

CalledNumberType

For Genesys I-Server, this is an optional parameter that specifies the source of the number presented as the called number. The valid options are CalledNumber or Address. The default is CalledNumber.

CalledNumber uses the called number as presented by the call (from signaling, or configured channel phone number). This is the ideal option to use in a TDM-based environment as every channel has a unique called number.

Address uses a calculated number based on the incoming trunk and channel. This is the ideal option to use in a VoIP/SIP-based environment as the real called number is often the same across calls, and is thus unsuitable for Genesys I-Server. The Address number is calculated using the formula trunk * 30 + channel, where both trunk and channel are 1-based numbers. For example, a call arriving at trunk 1, channel 1 presents the called number as 31 to Genesys I-Server. A call arriving at trunk 7, channel 18 presents the called number as 228 to Genesys I-Server.

Enabled

Yes or No. Optional. Default is Yes.

InitialAddresses

Allows the IVR port numbers to be recorded within file default.cff rather than when the first call arrives on a given channel, which can delay the registering of local/remote values (ANI/DNIS) when using CCXML. To pre define the IVR ports, add the InitialAddresses line to the existing TelephonyService definition for the Tserver. Addresses can be listed individually and delimited by a semicolon (;) or ranges can be defined by the use of a hyphen (-) as shown is following example:

TelephonyService=Tserver
Enabled=yes
ServerName=TSERVER:3009@lvl3cti
InitialAddresses=20801-20803;20804
;

Optional

Password

For Genesys CallPath, this is the password defined in the CallPath Enterprise Server JTAPI configuration. Optional.

For Genesys T-Server, this is required when you are using a multi-tennant T-Server environment. Enter the tennant name and tennant password separated by a slash (/). For example:

Password=somename/somepassword

ServerName

For Genesys CallPath this is the port number and IP address of the CallPath Enterprise Server. For example:

7600@blackbird

Mandatory.

For Genesys T-Server this is the port number and IP address of the T-Server, preceded by 'TSERVER:'. For example:

TSERVER:7600@blackbird

Mandatory.

For Genesys I-Server this is the port number and IP address of the I-Server, preceded by 'ISERVER:'. For example:

ISERVER:7600@blackbird

Mandatory.

UserName

For Genesys CallPath, this is the user name defined in the CallPath Enterprise Server JTAPI configuration. Optional.

For Genesys T-Server, this is an arbitrary name that T-Server will use to represent the voice response node. Optional.

Secondary keywords

Related information