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:
- 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.
- 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:
- The application client retrieves the current status of the identifiable
call.
- 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:
- The application client terminates the call identified by the callIdentifier.
This is a sample call flow for the cancelCall method:
- 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.