IP Phone Release Notes 2.3
New Features in Release 2.3
Action URI Disconnected Feature
A new parameter, “action uri disconnected” has been added to Release 2.3 that allows a disconnect event to occur when the phone transitions from any active state (outgoing, incoming, connected, or calling) to an idle state. A new line variable called “$$LINESTATE$$” has also been added to Release 2.3 that an Administrator can use with the “action uri disconnected” parameter as well as with existing XML URI parameters.
Note: The $$LINESTATE$$ variable is optional and not required when enabling the “action uri disconnected” parameter.
If the Administrator enables this feature (by specifying a disconnect URI), when a call is disconnected, the phone checks to see if the event has a Disconnect URI configured. If the phones finds a configured URI with a $$LINESTATE$$ variable, it replaces the $$LINESTATE$$ variable with the appropriate line state of the current active line. After all of the variables are bound, the phone executes a GET on the URI. The following table lists the applicable values for the $$LINESTATE$$ variable.
$$LINESTATE$$ Value | Description | Meaning in a Disconnected URI |
|
|
|
IDLE | Phone is idle. | N/A |
|
|
|
DIALING | Phone is offhook and ready to dial. | N/A |
|
|
|
CALLING | A SIP INVITE was sent but no | Error occurred during the call. |
| response was received. |
|
|
|
|
OUTGOING | Remote party is ringing. | Call was cancelled. |
|
|
|
INCOMING | Local phone is ringing. | Call was missed or cancelled. |
|
|
|
CONNECTED | Parties are talking. | Call was successful. |
|
|
|
CLEARING | Call was released but not | N/A |
| acknowledged. |
|
|
|
|
The Action URI Disconnect feature allows an Administrator to determine the reason for the disconnect if required.
Note: If you enable the Action URI Disconnect feature by specifying a URI, the URI is called when any disconnect event occurs including an intercom call or a conference setup.
46 |