
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  |