getSoftphoneLayout() for Lightning Experience

Returns the softphone layout of the current user. This method is available in API version 38.0 or later.

The Open CTI for Lightning Experience methods screenPop() and searchAndScreenPop() don’t support screenPopSettings.

NameTypeDescription
callbackfunctionJavaScript method executed when the API method call is completed.

This method is asynchronous. The response is returned in an object passed to a callback method. The response object contains the following fields.

NameTypeDescription
successbooleantrue if the API call succeeded and the softphone layout definition is returned in returnValue; false otherwise.
returnValueobjectThe softphone layout definition if the call succeeded; null if it failed. See returnValue Fields.
errorsarraynull if the call succeeded. Otherwise, an array of error messages.

The returned object contains three keys — "Internal", "Inbound", and "Outbound" — one for each call type. Each call-type object has the these fields.

callRelatedFields

An array of call-related fields selected to display. Possible values are "ANI", "DNIS", "SEGMENT", and "QUEUE".

objects

The set of Salesforce objects selected to display, along with the Field Label and Field Name (API name) selected to display from each object.

screenPopSettings

Contains a screenPopsOpenWithin field with a value of either "ExistingWindow" or "NewWindow".

Also contains settings for each screen pop match type: "NoMatch", "SingleMatch", and "MultipleMatches". Each match type has a screenPopType field and an optional screenPopData field.

screenPopType valuescreenPopData value
"PopToEntity"Name of the target object.
"PopToVisualforce"Name of the target Visualforce page.
"PopToSearch"Not present.
"PopToFlow"Name of the target flow.