Service Cloud Chat Developer Guide

About This Guide
Prerequisites
API Versions
Customize Deployments with the Deployment APIs
Create Deployments
Log Deployment Activity with the Deployment APIs
Customize Your Chat Window with the Deployment APIs
Customize Chat Buttons with the Deployment APIs
showWhenOnline
showWhenOffline
addButtonEventHandler
startChat
startChatWithWindow
Corresponding Calls for Chat Buttons
Find and Create Records Automatically with the Deployment APIs
Customize Automated Chat Invitations with the Deployment APIs
Deployment API Code Sample
Use Pre-Chat to Gather Visitor Information and Set Context for the Agent
Implement a Custom Chat Window Using Visualforce
Use Post-Chat to Wrap Up the Chat Interaction with Your Customer
Set Up Direct-to-Agent Chat Routing with the Deployment APIs
PDF

Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

showWhenOnline

Use the showWhenOnline method to specify what customers see when a particular button is online.

Usage

Displays a particular element when the specified button, agent, or agent-with-fallback-button is online. Available in API versions 28.0 and later.

Syntax

For a button, userId is optional: void showWhenOnline(String buttonId, Object element, (optional) String userId)

For an agent, use userId instead of buttonId: void showWhenOnline(String userId, Object element)

For an agent with fallback-to-button, use both IDs (the element shows when either the agent or button is online): void showWhenOnline(String buttonId, Object element, String userId)

Any time you use both a buttonId and a userId, buttonId must appear first.

Note

Parameters

Name Type Description Available Versions
buttonId String The ID of the chat button for which to display the specified element object when agents that are associated with the button are available to chat. Available in API versions 28.0 and later
element Object The element to be displayed when the specified button is online. Available in API versions 28.0 and later
userId String The ID of the agent to associate with the button. The element object is displayed when that agent is available. Available in API versions 28.0 and later

If you specify a button ID but not a user ID in your parameters, the element is displayed only if the button is online.

If you specify a user ID but not a button ID, the element is displayed only if the agent is online. For example, the following syntax tracks an agent’s online status and sets the button to online when that agent is available and offline if unavailable.
1liveagent.showWhenOnline('005xx000001Sv1m', document.getElementById('liveagent_button_toAgent_online'));
If you specify a button ID and an agent ID, the element is displayed if either the button or the agent is online. For example, the following syntax tracks the status of an agent and a button and displays the element if at least one skilled agent is available.
1liveagent.showWhenOnline('573xx0000000006', document.getElementById('liveagent_button_online_573xx0000000006_USER1'), '005xx000001Sv1m');