Details

Feature name

SipThirdPartyCallSetup

Applicable contexts

SIP service

SAS Support

No

Typical feature execution points

SipThirdPartyAccess_SubscriberCheck, SipAccess_CreditAllocatedPostCC, SipAccess_ControlNotRequiredPostCC, SipAccess_PartyRequest, SipAccess_PartyResponse, SipAccess_ServiceTimer, SubscriptionSipRequest, SipMidSession_PartyResponse

Prerequisite Features

SIP Third Party HTTP Trigger Feature

Timer usage

Execution-point targeted timer will trigger the feature at the SipAccess_ServiceTimer execution point on expiry.

The SIP Third Party Call Setup feature:

  1. First unlinks the legs created by SIP Third Party HTTP Trigger Feature.

  2. Starts to set up the call.

  3. The setup begins with A party negotiation.

  4. When it receives a positive answer from the A party, the feature start negotiation with the B party, using the SDP received from the A party.

  5. The call will be established if a positive answer was received from the B party.
    Otherwise the call setup fails.

Note The SIP Third Party Call Setup feature can also be used to provide Third Party Call Control (3pcc) functionality for other services.

Example call flows

Sentinel starts a call setup on valid HTTP requests from the SIP Third Party HTTP Trigger Feature. Below are examples of these call flows: successful; and A party busy, B party busy, and A party disconnects before B party answers failures.

Successful call setup flow

This call flow represents a successful call setup. The B party accepts the SDP offer. Sentinel sends an ACK message to the A party with the SDP answer received from the B party.

sip-third-party-call-setup-success

A party busy failure flow

This flow represents a case where the A party is busy.

sip-third-party-call-setup-a-busy

B party busy failure flow

This flow represents a case where the B party is busy.

sip-third-party-call-setup-b-busy

A party disconnects before B party answers failure flow

This flow represents a case where the A party disconnects before the B party answers.

sip-third-party-call-setup-a-disconnects

Session state inputs and outputs

Inputs

Name Type Format Description

APartyLegName

String

Text

A party leg name

BPartyLegName

String

Text

B party leg name

PreserveSessionOnAPartyFailureResponse

boolean

true or false

Determines if the feature should end or preserve the SIP session if the A Party responds with a failure response.

SentinelSelectionKey

com.opencloud.sentinel.common.SentinelSelectionKey

selection key
for example: <platform>::::

For selecting configuration data

Outputs

Name Type Format Description

CallEstablished

Boolean

true or false

Sets true if the session has been established.

Feature responses

Response Reason

featureHasFinished

feature has finished

Configuration

See under SIP Third Party Call Configuration. The only parameter used by this feature is NoAnswerApplicationTimer.

Statistics

Name Description

FailedToSetupCall

Counter incremented when failed to setup the call.

CallEstablished

Counter incrremented when successfully setup the call.

Previous page Next page
Sentinel Express Version 3.1.0