Configure Multiple Connector URLs

You can add multiple connector URLs and the corresponding login URLs in the managed package. The admin can select a connector URL during contact center creation. The connector URL and login URL defined in the CVI are used as the default values. If you provide a VendorURL object with a null login URL, then the default login URL from the CVI is used.

‌VendorURL objects with a null connector URL are ignored and not shown in the URL selection during contact center setup.

Don't send the default Connector URL and Login URL defined in the CVI in the Apex response. The system automatically includes these URLs in the CVI as the default option. Sending them again in the Apex response results in a duplicate entry in the selection list.

If you set the CapabiltiesSupportsMultiVendorConfig field to true, you must implement the service_cloud_voice.VendorConfigProvider Apex interface. Otherwise, it breaks the contact center creation flow.

Note

In the ConversationVendorInfo object, set the CapabiltiesSupportsMultiVendorConfig field to true. Implement the service_cloud_voice.VendorConfigProvider Apex interface.
Implement the service_cloud_voice.VendorConfigProvider Apex interface.
1. Implement the getVendorConfigDetails method: Within the VendorConfigProvider Apex class, implement the getVendorConfigDetails(VendorConfigRequest request) method. This method takes a VendorConfigRequest object, which contains information about the contact center, and returns a VendorConfigResponse object.
2. Construct the Response: To define the method implementation, create an instance of VendorConfigResponse and populate its list of VendorURL objects. Each VendorURL object must contain a connectorUrl and an optional loginUrl.
Return the Response: Return the populated VendorConfigResponse object. The VendorConfigResponse object contains a list of VendorURL objects, where each object can have a connectorUrl and a corresponding loginUrl. The VendorConfigResponse object is used to populate the connector URL option, so that the admin can select the connector URL for the contact center.

An example implementation is:

1public class ByoccIntegrationImpl implements service_cloud_voice.VendorConfigProvider {
2	public service_cloud_voice.VendorConfigResponse getVendorConfigDetails(service_cloud_voice.VendorConfigRequest vendorConfigRequest) {
3            service_cloud_voice.VendorUrl c1 = new service_cloud_voice.VendorUrl(null, 'Connector Option 1');
4            service_cloud_voice.VendorUrl l1 = new service_cloud_voice.VendorUrl('l1', 'Login Option 1');
5            service_cloud_voice.VendorUrl c2 = new service_cloud_voice.VendorUrl('c2', 'Connector Option 2');
6            service_cloud_voice.VendorUrl l2 = new service_cloud_voice.VendorUrl('l2', 'Login Option 2');
7            service_cloud_voice.VendorUrl c3 = new service_cloud_voice.VendorUrl('c3', 'Connector Option 3');
8            service_cloud_voice.VendorUrl l3 = new service_cloud_voice.VendorUrl(null, 'Login Option 3');
9            service_cloud_voice.VendorUrl c4 = new service_cloud_voice.VendorUrl(null, 'Connector Option 4');
10            service_cloud_voice.VendorUrl l4 = new service_cloud_voice.VendorUrl(null, 'Login Option 4');
11            service_cloud_voice.VendorUrl c5 = null;
12            service_cloud_voice.VendorUrl l5 = new service_cloud_voice.VendorUrl('l5', 'Login Option 5');
13            service_cloud_voice.VendorUrl c6 = new service_cloud_voice.VendorUrl('c6', 'Connector Option 6');
14            service_cloud_voice.VendorUrl l6 = null;
15            service_cloud_voice.VendorUrl c7 = null;
16            service_cloud_voice.VendorUrl l7 = null;
17            service_cloud_voice.VendorConfigInfo v1 = new service_cloud_voice.VendorConfigInfo(c1, l1);
18            service_cloud_voice.VendorConfigInfo v2 = new service_cloud_voice.VendorConfigInfo(c2, l2);
19            service_cloud_voice.VendorConfigInfo v3 = new service_cloud_voice.VendorConfigInfo(c3, l3);
20            service_cloud_voice.VendorConfigInfo v4 = new service_cloud_voice.VendorConfigInfo(c4, l4);
21            service_cloud_voice.VendorConfigInfo v5 = new service_cloud_voice.VendorConfigInfo(c5, l5);
22            service_cloud_voice.VendorConfigInfo v6 = new service_cloud_voice.VendorConfigInfo(c6, l6);
23            service_cloud_voice.VendorConfigInfo v7 = new service_cloud_voice.VendorConfigInfo(c7, l7);
24            List<service_cloud_voice.VendorConfigInfo> vendorlist = new List<service_cloud_voice.VendorConfigInfo>{v1, v2, v3, v4, v5, v6, v7};
25}

Service Cloud Voice for Partner Telephony Developer Guide

Configure Multiple Connector URLs