Action URI
Last modified date: 2015/04/21 views: 12320
Description

How to use Action URI

Resolution

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 respond with a 200 OK message. The HTTP GET request may contain variable named as “key” and variable value, which are separated by “=”. The URI format is:

 

http://IP address of phone/cgi-bin/ConfigManApp.com?key= variable value

 

 

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

1. Click on Features->Remote Control.

2. Enter the IP address or ‘any’ in the Action URI allow IP List field.

Multiple IP addresses are separated by commas. If you enter “any” in this field, the IP phone can receive and handle GET requests from any IP address. If you leave the field blank, the IP phone cannot receive or handle any HTTP GET request.

 1.png

 

Example 1:

If you want to trigger press the OK key of your phone, you can fill in the below URI in the Server

http://10.2.4.234/cgi-bin/ConfigManApp.com?key=OK

 2.png

 

Example 2: Outgoing call

Enter the below URI into the address bar of your browser

(T2x)http://phoneIP/cgi-bin/ConfigManApp.com?number=xxx&outgoing_uri=xxx

(T3x)http://phoneIP/cgi-bin/cgiServer.exx?number=xxx&outgoing_uri=xxx
 

For example, my phone IP is 10.2.40.13, I want to make an out a call to extension 4001 via extension 4002.
The important point is you need to add the server URL at the end of outgoing extension. Just like 4002@10.2.5.113. The 10.2.5.113 is the PBX server URL.

http://10.2.40.13/cgi-bin/cgiServer.exx?number=4001&outgoing_uri=4002@10.2.5.113

 

More Information

The following table lists the variable values may be used when specifying a 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.

key=Reboot

Reboot the IP phone.

key=AutoP

Let the IP phone do auto   provisioning.

key=DNDOn

Activate the DND mode.

key=DNDOff

Deactivate the DND mode.

 

Note

The variable does not work with all events. For example, the variable “key=MUTE” is only applicable when the IP phone is during a call.

 

URI format changed in different model of Yealink Phones that means the URI format is different in T2X, T3X, and VP530

 

For more information you can refer to below guide page 176-179 (take the T28 for an example)

 Yealink SIP-T2xP IP Phone Family Administrator Guide-V72



 

Product Type
SIP-T48G , SIP-T46G , SIP-T42G , SIP-T41P , SIP-T38G , SIP-T32G , SIP-T29G , SIP-T28P , SIP-T26P , SIP-T27P , SIP-T23G , SIP-T23P , SIP-T21P , SIP-T20P , SIP-T22P
Version
All
200/200
Please login to post your comment