background image

AltiAgent ActiveX Programmer’s Guide

5.

In the 

Add Member Variable

 dialog, create a member variable named 

m_altictrl

.

6.

Click 

OK

 to add it to the class. 

m_altictrl

 is now a member of 

CAltiCtrl

.

Now, VC has created a member in class 

CExampleVcDlg

 which can be used as a general object.

AltiAgent ActiveX Control API Reference

StartAltiCtrl

Description

Start AltiCtrl on the client. This is the first step to use this AltiCtrl.

VC++ Syntax

BOOL StartAltiCtrl()

VB++ Syntax

object.StartAltiCtrl()

Return type

BOOL - TRUE if connect to AltiAgent successfully; otherwise FALSE.

Remark

This function is the key of using AltiCtrl. Client cannot call the method or get any event from 
AltiAgent if this function call fails.

VC++ Example

BOOL bstart= m_altictrl.StartAltiCtrl();

VB Example

Dim bstart as bool

bstart = AltiCtrl1.StartAltiCtrl()

AltiCtrl Event

CallNotify

Description

When AltiView/AltiAgent 5.0 receives a call event from AltiServ, AltiCtrl will send the event to 
your application, each call will have an unique session ID, each call may several events with its 
unique session ID.

Syntax

OnCallNotifyXXXXX (long ulSessionID, short uStatus, BSTR 

szCallerID, BSTR szCallerName, BSTR szCallDNIS, BSTR szWorkgroup, 

BSTR pszDateTime, BSTR pszDuration)

Summary of Contents for AltiAgent ActiveX

Page 1: ...sing AppWizard to Create a Project 3 Inserting AltiCtrl into dialog 3 Handle AltiCtrl Events 3 AltiCtrl Methods 3 AltiAgent ActiveX Control API Reference 4 StartAltiCtrl 4 AltiCtrl Event 4 CallNotify...

Page 2: ...handled automatically at run time AltiCtrl ocx third party applications use this ActiveX control module to develop applications It needs to be registered before starting application development Note...

Page 3: ...nts To add an event process function 1 Open Class Wizard and go to Message Maps page 2 Set CExampleVcDlg as current class 3 Set IDC_ALTICTRLCTRL1 as current selection of Object Ids list box and all Al...

Page 4: ...connect to AltiAgent successfully otherwise FALSE Remark This function is the key of using AltiCtrl Client cannot call the method or get any event from AltiAgent if this function call fails VC Example...

Page 5: ...iveX Programmer s Guide 5 Parameters ulSessionID uStatus szCallerID szCallerName szCallDNIS pszDateTime pszDuration Session ID Call Status Caller ID Caller Name DNIS Call start date and time Conversat...

Page 6: ...DTRANSFER LINECALLSTATE_DISCONNECTED LINECALLSTATE_AA LINECALLSTATE_VM LINECALLSTATE_PARK LINECALLSTATE_UNKNOWN LINECALLSTATE_MUSICONHOLD LINECALLSTATE_PLAYVOICEMAIL LINECALLSTATE_CALLPENDING LINECALL...

Page 7: ...r a call maximum length is 256 bytes It is only used for trunk line calls Return Type BOOL if successful TRUE otherwise FALSE Remark SessionID Session ID received from OnCallNotify event needs to be p...

Page 8: ...ID SetIVRData Description Set IVR data for existing call used only in Web call IVR data is the format of name value pairs which can be used in Web Call and Auto Atendant for example FirstName John Las...

Page 9: ...nt SessionID VB Syntax object GetIVRData SessionID Parameters SessionID In unique ID for a call Return Type String IVR data for a call maximum length is 256 bytes Remark SessionID Session ID received...

Page 10: ...e ID for a call String In Set URL data for a call maximum length is 256 bytes Return Type BOOL if successful TRUE otherwise FALSE Remark SessionID Session ID received from OnCallNotify event needs to...

Page 11: ...data As String Data AltiCtrl1 GetURLData ulSessionID SetCallerName Description Set Caller Name for existing call VC Syntax BOOL SetCallerName int SessionID BSTR string VB Syntax object SetCallerNameD...

Page 12: ...object GetExtNumber Return type String extension number for the AltiAgent login is 256 bytes VC Example CComBSTR bstrData m_altictrl GetExtNumber VB Example Dim data as String data AltiCtrl1 GetExtNu...

Page 13: ...ccess code set in AltiAgent VC Syntax BSTR GetTrunkAccessCode VB Syntax object GetTrunkAccessCode Return type Default trunk access code set in AltiAgent VC Example CComBSTR bstrTrunkAccess m_altictrl...

Page 14: ...opCall SetBK Description Sets the background color of AltiCtrl VC Syntax long SetBk short sRed short sGreen short sBlue VB Syntax long SetBk short sRed short sGreen short sBlue Parameters sRed in RGB...

Reviews: