WebSphere brand IBM WebSphere Telecom Web Services Server, Version 7.1

Integrating with Parlay X Call Handling over Parlay

The Parlay X Call Handling over Parlay Web service provides a mechanism for an application to designate how calls are to be handled for a specific number.

Parlay X Call Handling over Parlay provides a rule-based processing capability that applications can access through the following set of operations: setRules, getRules, setRulesForGroup, and clearRules.

The Parlay X Call Handling over Parlay Web service is designed to provide a simplistic method for applications, at they relate to call behavior. The interface functions on a request/response message from the Web client to a Web service. When actual calls are routed, the Web service validates whether the calls are permitted according to a configured address.

Call flows

The following is an example call flow showing how the Parlay X Call Handling over Parlay interfaces are invoked. In this example the call flow begins when the application client invokes the Web service by routing the SOAP message over the HTTP to the Telecom Web Services Access Gateway. The ESB acts as a Web service between the client application and the Call Handling service. The following steps show how the Parlay X Call Handling over Parlay is invoked:
  1. You attempt to make a call from a Parlay gateway.
  2. CallHandlingNotificationManager receives a start/stop event from the Parlay Connector.
  3. CallHandlingRuleProcessor evaluates the rules, and the CHRule executes the rules.
  4. The call negotiation is complete, and you can now start your phone conversation.

Interfaces

setRules
Sets the Call Handling rules for the call destination address. If a set of rules is already in place for the address, then this operation will replace the old rules with the set provided in the operation. The address may not specify a group. If a group is specified, a PolicyException will return.
setRulesForGroup
Sets the Call Handling rules for multiple call destinations. If a set of rules are already in place for any of the addresses, then this operation will replace the old rules with the set provided in the operation. The addresses may include groups with arbitrary prefix for group which will be resolved in the Telecom Web Services Access Gateway for members that use the tel:, sip:, and sips: URIs.
getRules
Retrieves the Call Handling rules for the call destination. The address may not specify a group. If a group is specified, a PolicyException will return.
clearRules
Clears the Call Handling rules associated with the specified address. If rules have not been set for an address, then the operation silently ignores the request and does not return a fault message. The addresses may include groups with members using the tel: and sip: URIs.
Note: Wildcards cannot be used to specify addresses.



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