voIPTerminate Element
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
Represents a request by the Unified Communications client to terminate a VoIP session.
Syntax
<voIPTerminate/>
Attributes
None.
Element Information
Parent Elements
Element |
Description |
---|---|
Groups conference-related requests. |
Child Elements
Element |
Occurrence |
Description |
---|---|---|
1 |
Specifies the action that the Communicator Web Access server takes on termination of the VoIP call. Acceptable values: declineeverywhere|temporarilyunavailable|busyhere|voicemail |
Remarks
This request allows a user to terminate a VoIP session without redirecting the invitation or replying with an IM. The child action element indicates the action a user has taken to terminate a VoIP call. For an explanation of the possible action values, see the action Element.
Examples
Example 1:
The user wants to transfer the received VoIP call to her voice mail. The Unified Communications client application creates a conference request element and uses the voIPterminate element to specify the request to end the VoIP call. The Communicator Web Access server sees that the action specified on termination of the call is to forward the VoIP call to the users previously configured voice mail number.
<cwaRequests xmlns="http://schemas.microsoft.com/2006/09/rtc/cwa" sid="378">
<conference confId="1">
<voIPTerminate>
<action>voicemail</action>
</voIPTerminate>
</conference>
</cwaRequests>
Example 2:
In this example, the user is terminating the VoIP call without requesting any further action from the Communicator Web Access server.
<cwaRequests xmlns="http://schemas.microsoft.com/2006/09/rtc/cwa" sid="378">
<conference confId="1">
<voIPTerminate>
<action>declineeverywhere</action>
</voIPTerminate>
</conference>
</cwaRequests>