WebSphere brand IBM WebSphere Telecom Web Services Server, Version 7.1

Integrating with Parlay X Third Party Call over Parlay

Parlay X Third Party Call over Parlay enables applications to send Web service requests to the Telecom Web Services Server requesting third party call services.

Parlay X Third Party Call over Parlay Using this Web service application developers can quickly develop applications use without having detailed knowledge of the telecommunications field. The Parlay X Third Party Call over Parlay provides Parlay X Web service support for applications with the ability to initiate a call between two addresses (makeCall), retrieves the current call status after you have initiated a call (getCallInformation), terminate a call (endCall), or cancel a call if the call is not connected (cancelCall).

Call flows

This is a sample call flow for the makeCall method:
  1. The application client invokes a flow that sets up a voice call between two addresses, callingParty and calledParty, provided that the invoking application is allowed to connect them.
  2. After invoking the flow, the application monitors that status of the requested call. The callIdentifier parameter is used to identify the call.
This is a sample call flow for the getCallInformation method:
  1. The application client retrieves the current status of the identifiable call.
  2. After the call has ended, the status information is available for a limited amount of time. It is specified by the StatusRetainTime service policy.
This is a sample call flow for the endCall method:
  1. The application client terminates the call identified by the callIdentifier.
This is a sample call flow for the cancelCall method:
  1. The application cancels the previous call request identified by the callIdentifier.

Interfaces

ThirdPartyCall
makeCall
Initiates a call between two addresses, CallingParty and CalledParty. Optionally the application can also indicate the charging information (Charging). This is determined by the policy information configured per provider.
getCallInformation
Retrieves the current call status of the CallIdentifier (a parameter returned from makeCall). A CallInformation structure is returned, containing StartTime, Call status, Duration, and TerminationCause (if applicable). Provided that the call status record has not expired and has not been purged, this method can be invoked multiple times even if the call has ended.
endCall
Terminates the call identified by CallIdentifier.
cancelCall
Cancels the call identified by CallIdentifier. This operation has no effect if a call has been connected.

Communication between nodes is facilitated when each endCall or cancelCall request is processed by the same node that initiated the corresponding makeCall request. To achieve this, endCall and cancelCall use ClusterCommn.jar–a common utility file that is provided when you install the Parlay X Third Party Call over Parlay Web service implementation. Its function is to forward each endCall or cancelCall request to the node that initiated the makeCall.




Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.