Yealink SIP-T41S Administrator's Guide

Advanced Features
476
Action URI
Yealink phones can perform the specified action by receiving and handling an HTTP or HTTPS GET request or
accept a SIP NOTIFY message with the “Event: ACTION-URI” header from a SIP proxy server.
Topics
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 a 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/ser-
vlet?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 trus-
ted 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?”. Select the OK soft key on the phone to allow
remote control. 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 con-
tain a variable 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 mes-
sage 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?”. Select 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
CSeq: 4 NOTIFY

Yealink SIP-T41S Specifications

General

Mounting	Desk/Wall
Handset type	Wired handset
Product type	IP Phone
Product color	Black
Keypad illumination	Yes
Wi-Fi	No
Networking standards	IEEE 802.3af
Ethernet LAN data rates	10, 100 Mbit/s
Ethernet LAN interface type	Fast Ethernet
Supported network protocols	SIP v1, SIP v2, LLDP/CDP/DHCP, OpenVPN, IEEE802.1X, IPv6, FTP/TFTP/HTTP/HTTPS
Volume control	Digital
Number of programmable keys	6
Lines quantity	6 lines
Phonebook capacity	1000 entries
Dual-Tone Multi-Frequency (DTMF) modes	In-band, Out-of band, SIP info
Input frequency	50/60 Hz
AC adapter input voltage	100 - 240 V
AC adapter output current	1.2 A
AC adapter output voltage	5 V
Display diagonal	2.7 \
Display resolution	192 x 64 pixels
Operating temperature (T-T)	-10 - 50 °C
Operating relative humidity (H-H)	10 - 95 %
Voice codecs	CNG, G.711Mu, G.711a, G.723.1, G.726, G.729ab, VAD, iLBC
Certification	CE
Cables included	LAN (RJ-45)
Number of handles included	1 pc(s)
Harmonized System (HS) code	85171800

Weight and Dimensions

Depth	189 mm
Width	212 mm
Height	175 mm
Package depth	223 mm
Package width	246 mm
Package height	120 mm