Call Centers and the API

The API provides access to information about computer–telephony integration (CTI) call centers with the describeSoftphoneLayout() call. You must have the CTI feature enabled for your organization. Contact your account representative for assistance.

The API supports limited access to call center-related objects, including being able to create call centers, and create or modify additional numbers for the call center.

Topic Description
CallCenter Call Center object description, including fields and usage.
AdditionalNumber Configuration settings that allow you to add an additional number if it cannot easily be categorized as a user, contact, lead, account, or any other object. Examples include phone queues or conference rooms.

In addition, several fields have been added to existing objects to support call centers. The following fields provide configuration settings for operation of a call center.

<sfdocstbl><table>

<col> </col> <col> </col> <col> </col> <col> </col> <col> </col> <thead> <tr> <th> Object Name </th> <th> Field Name </th> <th> Field Type </th> <th> Field Properties </th> <th> Description </th> </tr> </thead> <tbody> <tr> <td> <p> OpenActivity </p> <p> ActivityHistory </p> <p> Task </p> </td> <td> <code>CallDisposition</code> </td> <td> string </td> <td> Create (Task only) <p> Filter </p> <p> Nillable </p> <p> Update (Task only) </p> </td> <td> <p> Represents the result of a given call, for example, “we'll call back,” or “call unsuccessful.” Limit is 255 characters. </p> <p> For the Task object, corresponds to the Salesforce user interface label <strong>Call Result</strong> . You can also create and update values for this field in Task. </p> </td> </tr> <tr> <td> <p> OpenActivity </p> <p> ActivityHistory </p> <p> Task </p> </td> <td> <code>CallDurationIn​Seconds</code> </td> <td> int </td> <td> Create (Task only) <p> Filter </p> <p> Nillable </p> <p> Update (Task only) </p> </td> <td> <p> Duration of the call in seconds. </p> <p> For Task, you can also create and update values for this field. </p> </td> </tr> <tr> <td> <p> OpenActivity </p> <p> ActivityHistory </p> <p> Task </p> </td> <td> <code>CallObject</code> </td> <td> string </td> <td> Filter <p> Nillable </p> <p> Update (Task only) </p> </td> <td> <p> Name of a call center. Limit is 255 characters. </p> <p> For Task, you can also create and update values for this field. </p> </td> </tr> <tr> <td> <p> OpenActivity </p> <p> ActivityHistory </p> <p> Task </p> </td> <td> <code>CallType</code> </td> <td> picklist </td> <td> Create (Task only) <p> Filter </p> <p> Nillable </p> <p> Restricted picklist </p> <p> Update </p> </td> <td> <p> The type of call being answered: Inbound, Internal, or Outbound. </p> <p> For Task, you can also create and update values for this field. </p> </td> </tr> <tr> <td> <p> User </p> </td> <td> <code>CallCenterId</code> </td> <td> reference </td> <td> Create <p> Filter </p> <p> Nillable </p> <p> Update </p> </td> <td> <p> The unique identifier for the call center associated with this user. </p> </td> </tr> <tr> <td> <p> User </p> </td> <td> <code>UserPermissionsCall​CenterAutoLogin</code> </td> <td> boolean </td> <td> Create <p> Update </p> </td> <td> <p> Indicates whether a user will be automatically logged in to a call center when logging in to the Salesforce application ( <code>true</code> ) or not ( <code>false</code> ). </p> </td> </tr> </tbody> </table></sfdocstbl>