< Back to Package Overview
Send All Calls (SAC)
Send All Calls (SAC) is a feature that allows a user to redirect incoming calls to their coverage path.
To enable or disable the SAC feature, you must complete the following activities.
- Access the call feature service
- Feature Capability Check
- Implement the feature completion handler to manage the feature activation result
- Enable Send All Calls
- Disable Send All Calls
Access the call feature service
You can access the CSCallFeatureService object through the CSUser object using callFeatureService property.
CSCallFeatureService* featureService = user.callFeatureService;
Feature Capability Check
You can check whether the SAC feature is available by getting the capability of the SAC feature. This can be achieved by using the capabilityForFeature: function.
BOOL featureAvailable =
[featureService capabilityForFeature: CSFeatureTypeSendAllCalls].allowed;
Features supported vary based on the infrastructure your application will be connecting to, as well as by the configuration for that deployment. If this capability returns NO unexpectedly, please consult your system administrator. They will be able to determine if this can be addressed by a configuration change or is a limitation of your target infrastructure.
Implement Feature Completion Handler
Your application can define a block that takes the NSError* parameter and use it to obtain the result for the feature invocation call.
void (^featureCompletionHandler)(NSError* error) =
^(NSError* error) {
if (error) {
// Feature request has failed to complete.
// Reason is described in the error object.
// Add code to update the UI.
} else {
// Feature request has been successfully completed.
// Add code to update the UI.
}
}
Enable Send All Calls
To enable SAC, you can call setSendAllCallsEnabled:completionHandler: function on the CSCallFeatureService object with the enabled parameter set to YES.
[featureService setSendAllCallsEnabled: YES
completionHandler: featureCompletionHandler];
Disable Send All Calls
To disable SAC, you can call setSendAllCallsEnabled:completionHandler: function on the CSCallFeatureService object with the enabled parameter set to NO.
[featureService setSendAllCallsEnabled: NO
completionHandler: featureCompletionHandler];
