Aastra Telecom 41-001343-02 XML SIP Notify Events and Action URIs, Action URI Description

Administrator Level Options

Reference

For more information about key functions see Appendix A, the section, “Softkey/Programmable Key/Keypad Key/Feature Key/Expansion Module Key/Hard Key Parameters” on page A-156.

For information about configuring softkeys, programmable keys, and expansion module keys, see Chapter 5, the section, “Softkeys/Programmable Keys/Feature Keys/Expansion Module Keys” on page 5-104.

Action URI

The IP phones have a feature that allows an administrator to specify a uniform resource identifier (URI) that triggers a GET when certain XML events occur. The Action URI feature prevents the phones from hanging if the Action URIs should fail. The phones also support transparent, non-blocking, XML post execute item URIs.

The IP phone XML events that support this feature are defined in the following table.

Action URI	Description
Startup	Specifies the URI for which the phone executes a GET on when a startup event occurs.
Successful Registration	Specifies the URI for which the phone executes a GET on when a successful registration event occurs.
Registration Event	Specifies the URI for when registration events occur or when there are registration state changes.

	Note:
	This action URI is not called when the same event is repeated (for example, a timeout occurs again when registration is
	already in a timeout state.)
Incoming Call	Specifies the URI for which the phone executes a GET on when an incoming call event occurs.
Outgoing Call	Specifies the URI for which the phone executes a GET on when an outgoing call event occurs.
Offhook	Specifies the URI for which the phone executes a GET on when an offhook event occurs.
Onhook	Specifies the URI for which the phone executes a GET on when an onhook event occurs.
Connected	Specifies the URI for which the phone executes an HTTP GET when it goes into the “connected” state. This includes regular
	phone calls, intercom calls, paging calls, RTP streaming, and the playing of a WAV file. It is also triggered when the phone
	establishes the second leg of a 3-way call.
Disconnected	Specifies the URI that the phone executes a GET on, when it transitions from the incoming, outgoing, calling, or con-
	nected state into the idle state.
XML SIP Notify	Specifies the URI to be called when an empty XML SIP NOTIFY is received by the phone.
Poll	Specifies the URI to be called every "action uri poll interval" seconds.
Poll Interval	Specifies the interval, in seconds, between calls from the phone to the "action uri poll".

You can set these parameters using the configuration files or the Aastra Web UI.

Reference

For more information about setting the Action URIs for XML applications, see “Action URIs” on page 5-246.

XML SIP Notify Events and Action URIs

In order for an XML push to bypass the NAT/firewall, the phone supports a proprietary SIP NOTIFY event (aastra-xml) with or without XML content.

If XML content is provided in the SIP NOTIFY, it is processed directly by the phone as it is done for an XML PUSH.

Reference

For more information about enabling the XML SIP Notify on the IP Phones, see Chapter 5, the section, “XML SIP Notify Events” on page 5-256.

41-001343-02 REV04 – 05.2014 3-46