Required Call Center Elements and Attributes

The call center definition file must include the required <item> elements in the <section> element.

The way you implement Open CTI depends on your org’s user interface. There are separate Open CTI APIs for Salesforce Classic and Lightning Experience. The reqSalesforceCompatibilityMode item in your call center definition file identifies the user interface you plan to use—Salesforce Classic, Lightning Experience, or both. If no value is specified, the default is Classic. This item is optional, but to make calls in Lightning Experience you must specify Lightning or Classic_and_Lightning.

NameDescriptionSupported in Salesforce ClassicSupported in Lightning Experience
reqAdapterUrlRepresents the location of where the CTI adapter or softphone is hosted. For example:

Relative URLs are allowed for Visualforce pages. For example:

  • : /apex/softphone

If you add Canvas applications to Open CTI, those apps can trump reqAdapterUrl when specified.

To implement in a Lightning Experience org, use https in your URL.

reqCanvasApiNameRepresents the API name associated with any Canvas applications added to your call center. Required if you add canvas apps to Open CTI.

Not supported

reqCanvasNamespaceRepresents the namespace associated with any Canvas applications added to your call center. Required if you add canvas apps to Open CTI.

Not supported

reqDisplayNameRepresents the name of the call center as displayed in Salesforce. It must have a sortOrder value of 1. A value for reqDisplayName has a maximum length of 1,000 UTF-8 characters.
reqInternalNameRepresents the unique identifier for the call center in the database. It must have a sortOrder value of 0, and its value must be specified in the call center definition. A value for reqInternalName must be composed of no more than 40 alphanumeric characters with no white space or other punctuation. It must start with an alphabetic character and must be unique from the reqInternalName of all other call centers defined in your organization.
reqSoftphoneHeightRepresents the height of the softphone in pixels as displayed in Salesforce.

If you’re using Open CTI for Lightning Experience, enter a number from 240 through 2,560. Value is in pixels (px).

reqSoftphoneWidthRepresents the width of the softphone in pixels as displayed in Salesforce.

If you’re using Open CTI for Lightning Experience, enter a number from 200 through 1,920. Value is in pixels (px).

reqUseApiRepresents that the call center is using Open CTI (true) or not (false).

If needed, you can add more <item> elements to this section.