Classic Console API Methods Supported in the Lightning Console API

Visualforce pages and third-party web tabs that use some Salesforce Console Integration Toolkit methods work in Lightning Experience as-is. Just point to the latest version of the toolkit script in your Visualforce pages or third-party web tabs. Third-party content must be whitelisted in the CSP Trusted Sites. This table lists the Salesforce Console Integration Toolkit methods that you can use in Lightning Console JavaScript API starting with API version 42.0.

Only API versions 42.0 and above of the Salesforce Console Integration Toolkit are supported in the Lightning Console JavaScript API. Only API versions 43.0 and above are supported in Open CTI.

Important

Salesforce Console Integration Toolkit methods that aren’t supported in Lightning Experience result in a failure error message.

Methods for Primary Tabs and Subtabs

Methods using objectId return 18-character, case-insensitive record IDs when invoked from within a Lightning console. When invoked from within a Salesforce Classic console, they return 15-character, case-sensitive record IDs.

Workspace tab and subtab IDs in a Lightning console use a different format from Salesforce Classic console primary tab and subtab IDs. Any code that validates the format of tab IDs must be updated or removed to account for the change. A Salesforce Classic console tab ID can look like scc-pt-1 or scc-st-1. A Lightning console tab ID looks like ctab1 or ctab1_3.

Note

Salesforce Classic Method	Supported in Lightning Console	Notes About Use in Lightning Console
`closeTab()`
`disableTabClose()`
`focusPrimaryTabById()`
`focusPrimaryTabByName()`
`focusSidebarComponent()`
`focusSubtabById()`
`focusSubtabByNameAndPrimaryTabId()`
`focusSubtabByNameAndPrimaryTabName()`
`generateConsoleUrl()`
`getEnclosingPrimaryTabId()`
`getEnclosingTabId()`
`getFocusedPrimaryTabId()`
`getFocusedPrimaryTabObjectId()`
`getFocusedSubtabId()`
`getFocusedSubtabObjectId()`
`getPageInfo()`	See notes	These fields aren’t supported and aren’t returned in the response: object displayName accountId contactId personAccount
`getPrimaryTabIds()`
`getSubtabIds()`
`getTabLink()`	See notes	The level argument `sforce.console.TabLink.PARENT_AND_CHILDREN` isn’t supported.
`isInConsole()`
`onEnclosingTabRefresh()`
`onFocusedPrimaryTab()`
`onFocusedSubtab()`		Utility items aren’t supported in the Lightning API.
`onTabSave()`
`openConsoleUrl()`
`openPrimaryTab()`	See notes	Make sure to add third-party domains to the CSP Trusted Sites list. Note The following aren’t supported in the Lightning API: `id` argument `name` argument. As an alternative, save the `tabId` that’s returned and use it in your API calls.
`openSubtab()`	See notes	Make sure to add third-party domains to the CSP Trusted Sites list. Note The following aren’t supported in the Lightning API: `id` argument `name` argument. As an alternative, save the `tabId` that’s returned and use it in your API calls.
`openSubtabByPrimaryTabName()`
`refreshPrimaryTabById()`	See notes	The `fullRefresh` argument isn’t supported in the Lightning API.
`refreshPrimaryTabByName()`
`refreshSubtabById()`	See notes	The `fullRefresh` argument isn’t supported in the Lightning API.
`refreshSubtabByNameAndPrimaryTabId()`
`refreshSubtabByNameAndPrimaryTabName()`
`reopenLastClosedTab()`
`resetSessionTimeOut()`
`setTabUnsavedChanges()`
`setTabIcon()`	See notes	Only Salesforce Lightning Design System icons are supported for `iconUrl`. URLs and custom icons aren’t supported. Sample supported values: `sforce.console.setTabIcon(“standard:email”)` `sforce.console.setTabIcon(“action:new”)` `sforce.console.setTabIcon(“custom:custom1”)`
`setTabLink()`
`setTabStyle()`
`setTabTextStyle()`
`setTabTitle()`

Methods for Application-Level Custom Console Components

The following methods must be called from within a Lightning utility.

Salesforce Classic Method	Supported in Lightning Console	Notes About Use in Lightning Console
`addToBrowserTitleQueue()`
`blinkCustomConsoleComponentButtonText()`
`isCustomConsoleComponentPoppedOut()`
`isCustomConsoleComponentHidden()`
`isInCustomConsoleComponent()`
`onCustomConsoleComponentButtonClicked()`
`removeFromBrowserTitleQueue()`
`runSelectedMacro()`
`scrollCustomConsoleComponentButtonText()`
`selectMacro()`
`setCustomConsoleComponentButtonIconUrl()`	See notes	In Lightning Console, URL values for icons aren’t supported in utility bar utilities. Only Salesforce Lightning Design System are supported. Sample supported `iconUrl` values: `setCustomConsoleComponentButtonIconUrl("clock");` `setCustomConsoleComponentButtonIconUrl("utility:clock");`
`setCustomConsoleComponentButtonStyle()`
`setCustomConsoleComponentButtonText()`
`setCustomConsoleComponentHeight()`
`setCustomConsoleComponentVisible()`
`setCustomConsoleComponentWidth()`
`setCustomConsoleComponentPopoutable()`
`setCustomConsoleComponentWindowVisible()`
`setSidebarVisible()`

Methods for Navigation Tabs

Salesforce Classic Method	Supported in Lightning Console	Notes About Use in Lightning Console
`focusNavigationTab()`
`getNavigationTabs()`
`getSelectedNavigationTab()`
`refreshNavigationTab()`
`setSelectedNavigationTab()`

Methods for Live Agent

Salesforce Classic Method	Supported in Lightning Console	Notes About Use in Lightning Console
`acceptChat()`
`cancelFileTransferByAgent()`
`declineChat()`
`endChat()`
`getAgentInput()`
`getAgentState()`
`getChatLog()`
`getChatRequests()`
`getDetailsByChatKey()`
`getDetailsByPrimaryTabId()`
`getEngagedChats()`
`getMaxCapacity()`
`initFileTransfer()`
`onAgentSend()`
`onAgentStateChanged()`
`onChatCanceled()`
`onChatCriticalWaitState()`
`onChatDeclined()`
`onChatEnded()`
`onChatRequested()`
`onChatStarted()`
`onChatTransferredOut()`
`onCurrentCapacityChanged()`
`onCustomEvent()`
`onFileTransferCompleted()`
`onNewMessage()`
`onTypingUpdate()`
`sendCustomEvent()`
`sendMessage()`
`setAgentInput()`
`setAgentState()`

Methods for Omni-Channel

Salesforce Classic Method	Supported in Lightning Console	Notes About Use in Lightning Console
`acceptAgentWork()`
`closeAgentWork()`
`declineAgentWork()`
`getAgentWorkload()`
`getAgentWorks()`
`getServicePresenceStatusChannels()`
`getServicePresenceStatusId()`
`login()`
`logout()`
`setServicePresenceStatus()`

Methods for Console Events

Salesforce Classic Method	Supported in Lightning Console	Notes About Use in Lightning Console
`addEventListener()`		`sforce.console.ConsoleEvent.CONSOLE_LOGOUT` isn’t supported in the Lightning API. `sforce.console.ConsoleEvent.CLOSE_TAB` returns the ID of the closed tab only. The Lightning API doesn’t return the objectId or the tabObjectId. The Lightning API doesn’t return special message responses from custom keyboard shortcuts. However, if the response is from a console event, the message includes payload details.
`fireEvent()`	See notes	`fireEvent()` returns `success true` even when eventListeners for the given eventType are removed.
`removeEventListener()`

Salesforce Classic Method

Supported in Lightning Console

Notes About Use in Lightning Console

addEventListener()

sforce.console.ConsoleEvent.CONSOLE_LOGOUT isn’t supported in the Lightning API.

sforce.console.ConsoleEvent.CLOSE_TAB returns the ID of the closed tab only. The Lightning API doesn’t return the objectId or the tabObjectId.

The Lightning API doesn’t return special message responses from custom keyboard shortcuts. However, if the response is from a console event, the message includes payload details.

fireEvent()

See notes

fireEvent() returns success true even when eventListeners for the given eventType are removed.

removeEventListener()

Salesforce Console Developer Guide