Avaya Logo

Previous Topic

Next Topic

Book Contents

Book Index

ctiNotify

Description

ctiNotify provides answer notification to a voice application that has launched a call.

Input

None.

Return values

The return code indicates whether a tracked call has been answered.

If successful, the result is the call ID of the established call, which means that the tracked call is answered.

On failure, the result is -1, which means that the CTI DIP found no call at the Avaya IR port to track.

Usage notes

ctiNotify is most useful in outbound calling when used in conjunction with ctiDial. The function is solely dependent on receiving answer supervision on a timely basis from the network. Therefore, if the call is sent over a non-ISDN trunk to a destination, the function may return several seconds after the call is actually connected.

When the ctiNotify request is made, a message is sent to the CTI DIP. The CTI DIP checks the status of the calls that are currently at the Avaya IR port.

If a call is found to be either in the DELIVERED or ORIGINATED state, the CTI DIP:

If no call is currently in either the DELIVERED or ORIGINATED state, the CTI DIP returns a -1 to ctiNotify. If ctiNotify receives a -1, it tries up to three times to find a call at the Avaya IR port that is in either the DELIVERED or ORIGINATED state. There is a 500-millisecond pause between attempts.

© 2006 Avaya Inc. All Rights Reserved.