Configuring Advanced Features
543
Action URI
HTTP/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. When receiving a GET request, the IP
phone will perform the specified action and respond with a 200 OK message. A GET request may
contain variable named as “key” and variable value, which are separated by “=”. The valid URI
format is:
http(s)://<phoneIPAddress>/servlet?key=variable value
. For example:
http://10.10.20.10/servlet?key=SPEAKER.
Note
SIP Notify Message
In addition, Yealink IP phones support performing 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 variable named as “key” and variable
value, which are separated by “=”.
This method is especially useful for users always working in the small office/home office where a
secure firewall may prevent the HTTP or HTTPS GET request from the external network.
Note
Example of a SIP Notify with the variable value (SPEAKER):
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
CSeq: 4 NOTIFY
Contact: <sip:3586@10.2.40.27:5063>
Max-Forwards: 70
User-Agent: Yealink T58 58.80.0.5
Event: ACTION-URI
Content-Type: message/sipfrag
Content-Length: 6
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 on page 293.
Yealink IP phones are compatible with other two old valid URI formats:
http(s)://<phoneIPAddress>/cgi-bin/ConfigManApp.com?key=variable value
and
http(s)://<phoneIPAddress>/cgi-bin/cgiServer.exx?key=variable value
.