---
schema_version: "1"
id: 07c1216ca7622a6db42109fa00a54a268d90dd15f9a5a557efaf1a63277f2b0e
title: Required Call Center Elements and Attributes
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/api-cti/guides/sforce-api-cti-call-def-file-required.md
canonical_url: https://developer.salesforce.com/docs/service/api-cti/guide/sforce-api-cti-call-def-file-required.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 734559630e7a58c3314c5b65a6bf78b7dd692a9e1edced6be1792c082065c6cd
products:
  - Open CTI Developer Guide
  - Service Cloud Developer Content
---

# Required Call Center Elements and Attributes

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

**important:** 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`.

<sfdocstbl><table><col /><col /><col /><col /><thead><tr><th><item> Name</th><th>Description</th><th>Supported in Salesforce Classic</th><th>Supported in Lightning Experience</th></tr></thead><tbody><tr><td><code>reqAdapterUrl</code></td><td>Represents the location of where the CTI adapter or softphone is hosted. For example:<ul><li><p>http://localhost:11000</p></li></ul><p>Relative URLs are allowed for Visualforce pages. For example:</p><ul><li><p>: /apex/softphone</p></li></ul><p>If you add Canvas applications to Open CTI, those apps can trump <code>reqAdapterUrl</code> when specified.</p><p>To implement in a Lightning Experience org, use https in your URL.</p></td><td><image /></td><td><image /></td></tr><tr><td><code>reqCanvasApiName</code></td><td>Represents the API name associated with any Canvas applications added to your call center. Required if you add canvas apps to Open CTI.</td><td><image /></td><td><image /><p>Not supported</p></td></tr><tr><td><code>reqCanvasNamespace</code></td><td>Represents the namespace associated with any Canvas applications added to your call center. Required if you add canvas apps to Open CTI.</td><td><image /></td><td><image /><p>Not supported</p></td></tr><tr><td><code>reqDisplayName</code></td><td>Represents the name of the call center as displayed in Salesforce. It must have a <code>sortOrder</code> value of <code>1</code>. A value for <code>reqDisplayName</code> has a maximum length of 1,000 UTF-8 characters.</td><td><image /></td><td><image /></td></tr><tr><td><code>reqInternalName</code></td><td>Represents the unique identifier for the call center in the database. It must have a <code>sortOrder</code> value of <code>0</code>, and its value must be specified in the call center definition. A value for <code>reqInternalName</code> 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 <code>reqInternalName</code> of all other call centers defined in your organization.</td><td><image /></td><td><image /></td></tr><tr><td><code>reqSoftphoneHeight</code></td><td>Represents the height of the softphone in pixels as displayed in Salesforce.<p>If you’re using Open CTI for Lightning Experience, enter a number from 240 through 2,560. Value is in pixels (px).</p></td><td><image /></td><td><image /></td></tr><tr><td><code>reqSoftphoneWidth</code></td><td>Represents the width of the softphone in pixels as displayed in Salesforce.<p>If you’re using Open CTI for Lightning Experience, enter a number from 200 through 1,920. Value is in pixels (px).</p></td><td><image /></td><td><image /></td></tr><tr><td><code>reqUseApi</code></td><td>Represents that the call center is using Open CTI (<code>true</code>) or not (<code>false</code>).</td><td><image /></td><td><image /></td></tr></tbody></table></sfdocstbl>

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