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:
- You attempt to make a call from a Parlay gateway.
- CallHandlingNotificationManager receives a start/stop event from the Parlay
Connector.
- CallHandlingRuleProcessor evaluates the rules, and the CHRule executes
the rules.
- 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.