User's Manual

29
CHAPTER 4. ACTION URL AND ACTIVE URI –
COLLABORATIVE WORKING
ENVIRONMENT THROUGH
COMPUTER TELEPHONY
INTEGRATION (CTI)
4.1 Introduction
Action URL allows devices to interact with web server applications by sending an HTTP GET request. You
can specify a URL that triggers a GET request when a specified event occurs. Action URL can only be
triggered by the pre-defined events (e.g., Incoming Call). The valid URL format is:
http://<server address>/<processing file>?<variable name=$variable>.
The HTTP GET request may contain variable name and variable value, separated by “=”. Each variable
value starts with $ in the query part of the URL. Variable name can be customized by users, while the
variable value is pre-defined.
For example, an URL “http://192.168.1.100/newcall.xml?num=$call_id” is specified for the New call,
$call_id will be dynamically replaced with the real value of device when the device makes a call.
The following table lists the pre-defined events for action URL.
Event
Description
Setup Completed When the device completes startup.
Registration Succeeded When the device successfully registers an
account.
Registration Disabled When the device logs off the registered account.
Registration Failed When the device fails to register an account.
Phone Off Hooked When the device is off hook.
Phone On Hooked When the device is on hook.