Active Call Center API

The Active Call Center API defines the programming interfaces to core telephony features. The API is provided for developers that are developing solutions which require seamless integration of Active Call Center features with another application, without requiring the use of the Active Call Center user interface. We regret that we cannot provide technical support for these advanced features.

Note that Active Call Center does not include any redistributable components, therefore use of the API requires having a complete installation of Active Call Center on the computer being used. Developers that would like to distribute Active Call Center functionality with their application may be interested in the Active Call Center Runtimes. For more information on runtime files, visit the Active Call Center home page at http://www.activecallcenter.com.

The core of Active Call Center's telephony features are packaged into the "ACC Monitor.DLL" file. Visual Basic programmers should use the following function declarations to call telephony features directly:

Private Declare Sub MonitorPhones Lib "ACC Monitor.DLL" _
(ByVal hWnd As Long, ByVal CallTree As String, _
ByVal CallLog As String, ByVal AppPath As String)
Private Declare Sub SimulateCall Lib "ACC Monitor.DLL" _
(ByVal hWnd As Long, ByVal CallTree As String, _
ByVal CallLog As String, ByVal AppPath As String)
Private Declare Sub MakeCall Lib "ACC Monitor.DLL" _
(ByVal hWnd As Long, ByVal CallTree As String, _
ByVal CallLog As String, ByVal AppPath As String, _
ByVal Number As String, ByVal Passed As String, _
ByVal lineID As Long)
Private Declare Sub VoiceSetup Lib "ACC Monitor.DLL" _
(ByVal hWnd As Long)

The functions have the following uses:

• MonitorPhones starts the Call Monitor.
• SimulateCall starts the Call Simulator.
• MakeCall begins outbound dialing.
• VoiceSetup opens the speech engine selection dialog.

Parameters of the functions are as follows:

• hWnd is always the Windows handle to the parent application window or form. This must be a valid windows handle, and usually can be retrieved in Visual Basic by using the form's hWnd property.
• CallTree is the fully qualified path and file name to the Call Tree to use for either inbound or outbound dialing.
• CallLog is the fully qualified path and file name to the Call History file to use for recording call data. Usually this is "C:\Program Files\Active Call Center\Phone Call Log.mdb".
• AppPath is the path name to the default file path for Active Call Center files, without the trailing backslash. Usually this is "C:\Program Files\Active Call Center".
• Number is the number or numbers to dial for outbound dialing. Separate multiple numbers with line breaks (CR/LF).
• Passed is a value that is to be passed to an outbound Call Tree. This parameter is analagous to the PassValue property of the outbound dialing COM object.
• lineID is the number of the line to use for outbound dialing. This parameter is analagous to the lineID property of the outbound dialing COM object.

Note that the MakeCalls function will modify the title of the parent window to reflect the state of outbound calls. All functions when called do not return until they are completely finished: i.e., the monitor or simulator is closed, outbound calls completed, or engine selection dialog closed.