ctiCallInfo

Description

The ctiCallInfo external function provides the call ID, ANI, called number, and Avaya IR port extension associated with an active call at the Avaya IR.

Output

• Call ID – Variable where the call ID will be stored.

  (Type: num)

• ANI – Variable where the ANI of the call will be stored.

  (Type: char, Size: 16)

• Called Number – Variable where the Called Number or DNIS will be stored.

  (Type: char, Size: 16)

• Station Extension – Variable where the Avaya IR Port extension will be populated.

  (Type: char, Size: 7)

• Skill – Variable where the skill/split hunt-group number will be stored.

  (Type: char, Size: 7)

Return values

The return code indicates whether the CTI DIP can find any call present at the Avaya IR port.

If successful, the result is > 0.

On failure, the result is <=0.

Usage notes

The ctiCallInfo function is often the first external function that is called in an application. It identifies the call ID of the call that has reached the Avaya IR. This is useful for any controlling function that might be used later in the application, such as placing the call on hold (ctiHold). It also identifies the number that was dialed by the caller. If the call was inbound from an ISDN trunk group, it also identifies the DNIS associated with the call. This feature is most useful in applications that dynamically assign a Avaya IR application on DNIS.

If there is more than one call present at a Avaya IR port, ctiCallInfo reports the latest call. For example, if one call is on hold while another call is active, ctiCallInfo reports only on the most recent call to arrive at the Avaya IR port, regardless of whether this call is on hold or not.

© 2006 Avaya Inc. All Rights Reserved.