YEALINK NETWORK TECHNOLOGY CO.,LTD.

www.yealink.com

Action URI and URL

 Feature mechanism:
Action URI and URL can be considered as API for a Web Application; Action URL allows IP phones
to interact with web server applications by sending an HTTP or HTTPS GET request. Opposite to
action URL, action URI allows IP phones to interact with web server application by receiving and
handling an HTTP or HTTPS GET request.
They are mostly used to interacted with third party PC APP, to trigger the phone to do auto
provision and so on.
The application scenario: Call center, Control center and so on.

More details you can refer to the latest Yealink “Administrator” guide on support.yealink.com.

 Issue Description:
1. The phone has no response when using Action URI

2. Customer’s requirements

 Resolution: （Checking list）

Issue1: The phone has no response when using Action URI
a. Please make sure you have configured the correct trusted IP for the phone.

For security reasons, IP phones do not receive and handle HTTP/HTTPS GET requests by

default. You need to specify the trusted IP address for action URI. You can specify one or

more trusted IP addresses separated by the commas on the IP phone, or configure the IP

phone to receive and handle the URI from any IP address by configure it with “any”.

b. When the IP phone receives a GET request from the trusted IP address for the first time,

the LCD screen prompts the message “Allow Remote Control’. Press OK button to

allow it

1
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
c. If customer used HTTP, catch the trace to see if the phone has received the URI and then
see if the URI has used the correct URI format, you can do the local simulate test.
If using HTTPS, it maybe failed by the authentication time is too long.
If above steps can’t work, ask the customer to send us the config.bin file, pcap trace and
level 6 syslog to further analysis.

Issue2. Customer’s requirements

b. The phone can support Action URI through SIP NOTIFY.

NOTIFY sip:3583@10.2.40.10:5062 SIP/2.0

Via: SIP/2.0/UDP 10.2.40.27:5063;branch=z9hG4bK4163876675
From: <sip:3586@10.3.5.199>;tag=2900480538
To: "3583" <sip:3583@10.3.5.199>;tag=490600926
Call-ID: 2923387519@10.2.40.10
CSeq: 4 NOTIFY
Contact: <sip:3586@10.2.40.27:5063>
Max-Forwards: 70
User-Agent: Yealink SIP-T46G
Event: ACTION-URI
Content-Type: message/sipfrag
Content-Length: xxx

Supported by the version higher than V71

c. Need support of Call ID, supported by the version higher than V72, details can refer to below

Action
URI+call_id.doc

d. When the phone receive the URI in a call and want the phone to reboot or auto provision
immediately
features.reboot_in_talk_enable =1
features_action_uri_force_autop=1
features.reboot_in_talk_enable :
#It enables or disables the phone to reboot during a call when it receives a reboot request by action URI.
0-Disabled
1-Enabled
Note: It works only if the value of the parameter “features.action_uri_limit_ip” is set to “any” or trusted IP
address(es) and it is not the first time for the IP phone to receive HTTP/HTTPS GET request from the trusted IP
address(es).

features_action_uri_force_autop:
2
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
#It enables or disables the IP phone to be forced to end the call for triggering auto provisioning immediately when
receiving an HTTP or HTTPS GET request with variable value set to AutoP during a call.
0-Disabled

1-Enabled
If it is set to 0 (Disabled), the IP phone will trigger auto provision after the call.
Note: It works only if the value of the parameter “features.action_uri.enable” is set to 1 (Enabled).

e. when the phone first receive the Action URI , don’t need to pop up the Allow Remote
Control prompt that need you to press OK button to allow it .
The feature can be enabled or disabled by below option:
features.show_action_uri_option=
# It enables or disables the phone to pop up the Allow Remote Control prompt when it receives an HTTP or HTTPS
GET request.
0-Disabled
1-Enabled
Note: It works only if the value of the parameter “features.action_uri.enable” is set to 1 (Enabled).

f. Action URL can support more parameters at the same time, please refer to below FAQ
http://support.yealink.com/faq/faqInfo?id=124
Note: different version may use different URI format.
V60/V61： http://phone ip/cgi-bin/cgiServer.exx?key=variable value
V70 and higher version： http://phone ip/servlet?key=variable value

Trace analysis:

a. When you configured below URL in the Open DND option under Action URL page.
When the phone enable DND, the phone will replace the $mac with its own MAC address and
report to the server 192.168.1.10
http://192.168.1.10/help.xml?mac=$mac

URL open DND.pcapng

 Products:
3
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
All

 Firmware version:
All