Yealink T5 Series Administrator's Guide

Advanced Features
371
Supported HTTP/HTTPS GET Request
Supported SIP Notify Message
Variable Values List
Action URI Configuration
Example: Capturing the Current Screen of the Phone
Example: Placing a Call via Web User Interface
Supported HTTP/HTTPS GET Request
Opposite to action URL, action URI allows the phones to interact with web server application by receiving and handling
an HTTP or HTTPS GET request. When receiving a GET request, the phone will perform the specified action and respond
with a 200 OK message.
A GET request may contain a variable named as “key” and a variable value, which are separated by “=”. The valid URI
format is: http(s)://<phoneIPAddress>/servlet?key=variable value. For example: http://10.3.20.10/servlet?key=OK.
Note
Yealink phones are compatible with other two old valid URI formats: http(s)://<phoneIPAddress>/cgi-bin/Con-
figManApp.com?key=variable value and http(s)://<phoneIPAddress>/cgi-bin/cgiServer.exx?key=variable value.
For security reasons, the phones do not handle HTTP/HTTPS GET requests by default. You need to specify the trusted
IP address for action URI. When the IP phone receives a GET request from the trusted IP address for the first time, the
phone screen prompts the message “Allow remote control?”. Tap the OK soft key on the phone to allow remote con-
trol. You can specify one or more trusted IP addresses on the IP phone, or configure the IP phone to receive and
handle the URI from any IP address.
Supported SIP Notify Message
In addition, Yealink phones can perform the specified action immediately by accepting a SIP NOTIFY message with the
“Event: ACTION-URI” header from a SIP proxy server. The message body of the SIP NOTIFY message may contain a vari-
able named as “key” and a variable value, which are separated by “=”.
This method is especially useful for users who always work in the small office/home office where a secure firewall may
prevent the HTTP or HTTPS GET request from the external network.
Note
If you want to only accept the SIP NOTIFY message from your SIP server and outbound proxy server, you have to enable the
Accept SIP Trust Server Only feature. For more information, refer to Accept SIP Trust Server Only.
If you use SIP NOTIFY message method, you do not need to specify the trusted IP address for action URI. However, you
should enable the IP phone to receive the action URI requests. When the IP phone receives a SIP NOTIFY message with
the “Event: ACTION-URI” header from a SIP proxy server for the first time, the LCD screen also prompts the message
“Allow remote control?”. Tap the OK soft key on the phone to allow remote control.
Example of a SIP Notify with the variable value (OK):
Message Header
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.2.1.48>;tag=2900480538
To: "3583" <sip:3583@10.2.1.48>;tag=490600926
Call-ID: 2923387519@10.2.40.10

Yealink T5 Series Specifications

General

Brand	Yealink
Model	T5 Series
Category	IP Phone
Language	English