Select Enabled from the pull-down list of Feature Synchronization

3. Click Confirm to save the change.

Action URL is a HTTP GET request allowing the IP phone to interact with web server applications. An administrator can specify a URL that triggers a GET when certain events occur. A HTTP GET request may contain variable name and variable value, which is separated by ―=‖. Each variable value starts with $ in the query part of the URL.

The URL format is: http://IP address of server/help.xml? variable name=variable value (e.g. http:192.168.1.10/help.xml?mac=$mac). Action URLs can be only triggered by the predefined events (e.g. Log on).

The following table lists the predefined events for Action URL triggering:

Event Description

Setup Completed When the phone completes startup.

Log On When the phone successfully registers account.

Log Off When the phone logs off the registered account.

Register Failed When the phone fails to register account.

Off Hook When the phone is off hook.

On Hook When the phone is on hook.

Incoming Call When the phone receives incoming call.

Outgoing Call When the phone places a call.

Call Established When the phone establishes a call.

Call Terminated When the phone terminates a call.

Event Description

Open DND When the phone enables the DND mode.

Close DND When the phone disables the DND mode.

Open Always Forward When the phone enables the always forward.

Close Always Forward When the phone disables the always forward.

Open Busy Forward When the phone enables the busy forward.

Close Busy Forward When the phone disables the busy forward.

Open No Answer Forward When the phone enables the no answer forward.

Close No Answer Forward When the phone disables the no answer forward Transfer Call When the phone transfers a call.

Blind Transfer Call When the phone blind transfers a call.

Attended Transfer Call When the phone performs the attended transfer.

Hold When the phone places a call on hold.

Unhold When the phone retrieves a hold call.

Mute When the phone mutes a call.

Unmute When the phone unmutes a call.

Missed Call When the phone misses a call.

IP Change When the IP address of the phone changes.

Forward Incoming Call When the phone forwards an incoming call.

Reject Incoming Call When the phone rejects an incoming call.

Answer New Incoming Call When the phones answers a new call.

Transfer Finished When the phone completes to forward a call.

Transfer Failed When the phone fails to transfer a call.

Idle to Busy When the state of the phone changes from idle to busy.

Busy to Idle When the state of phone changes from busy to idle.

The following table lists the variable values may be used when specifying the URL:

Variable Description

$mac MAC address of the phone

$ip The current IP address of the phone

$model Phone model

$firmware Phone firmware version

$active_url

The SIP URI of the current account when the phone is in the incoming, outgoing or connecting state.

$active_user

The username of the current account when the phone is in the incoming, outgoing or connecting state.

$active_host

The host name of the current account when the phone is in the incoming, outgoing or connecting state.

$local

The SIP URI of the caller when the phone places a call.

The SIP URI of the callee when the phone receives an incoming call.

$remote

The SIP URI of the callee when the phone places a call.

The SIP URI of the caller when the phone receives an incoming call.

$display_local

The display name of the caller when the phone places a call.

The display name of the callee when receives an incoming call.

$display_remote

The display name of the callee when the phone places a call.

The display name of the caller when the phone receives an incoming call.

$call_id The caller ID when in incoming, outgoing or connecting state.

Procedure

Action URL can be configured using the configuration files or locally.

Configuration File <y0000000000xx>.cfg

Configure the action URL on the IP phone.

For more information, refer to Action URL on page 150.

Local Web User Interface

Configure the action URL on the IP phone.

Navigate to:

http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=41

Opposite to Action URL, Action URI allows the IP phone to interact with web server application by receiving and handling HTTP GET requests. When receiving a URI, the IP phone will perform the specified action and response a 200 OK message. The HTTP GET request may contain variable name ―key‖ and variable value, which is separated by

―=‖. The URI format is: http://IP address ofphone/cgi-bin/ConfigManApp.com?key=

variable value (e.g. http://192.168.1.5/cgi-bin/ConfigManApp.com?key=MUTE). Entering the URI in the web browser triggers the IP phone to perform the predefined event (e.g.

mute the call).

The following table lists the variable values may be used when specifying the URI:

Variable Phone Action

key=OK/key=ENTER Press the OK key or the Enter soft key.

key=SPEAKER Press the Speaker key.

key=F_TRANSFER Press the Transfer key.

key=VOLUME_UP Increase the volume.

key=VOLUME_DOWN Decrease the volume.

key=MUTE Mute the call.

key=F_HOLD Press the Hold key.

key=X Press the X key.

key=0-9/*/POUND Send the DTMF digit (0-9, * or #).

key=L1-L6 Press the Line key.

key=D1-D10 Press the DSS key.

key=F_CONFERENCE Press the Conference key.

key=F1-F4 Press the Soft key.

key=MSG Press the MESSAGE key.

key=HEADSET Press the HEADSET key.

key=RD Press the Redial key.

key=UP/DOWN/LEFT/RIGHT Press the Navigation keys.

Variable Phone Action

key=Reboot Reboot the phone.

key=AutoP Let the phone do auto provisioning.

key=DNDOn Activate the DND mode.

key=DNDOff Deactivate the DND mode.

Note

For security reasons, the IP phone does not receive and handle the HTTP GET request by default. You need to specify which IP address may send the URI to the IP phone. When receiving the HTTP GET request from the specified IP address, the phone LCD screen prompts the message ―Allow Remote Control?‖. You can specify one or more trusted IP addresses on the IP phone, multiple IP addresses are separated by comma. You can also configure the IP phone to receive and handle the URI from any IP address.

Procedure

Specify the trusted IP address for Action URI using the configuration files or locally.

Configuration File <y0000000000xx>.cfg

Specify the trusted IP address(es) for sending the Action URI to the IP phone.

For more information, refer to Action URI on page 151.

Local Web User Interface

Specify the trusted IP address(es) for sending the Action URI to the IP phone.

Navigate to:

http://<phoneIPAddress>/cgi-bi n/ConfigManApp.com?Id=6

To configure the trusted IP address(es) for Action URI via web user interface:

1. Click on Phone->Features->API Security>>.