Live Agent Developer's Guide

About This Guide
Prerequisites
API Versions
Customize Deployments with the Deployment API
Creating Deployments
Logging Deployment Activity with the Deployment API
Customizing Your Chat Window with the Deployment API
Launching a Chat Request with the Deployment API
Customizing Visitor Details with the Deployment API
Find and Create Records Automatically with the Deployment API
Customizing Chat Buttons with the Deployment API
showWhenOnline
showWhenOffline
addButtonEventHandler
Customizing Automated Chat Invitations with the Deployment API
Deployment API Code Sample
Pre-Chat Forms Overview
Accessing Chat Details with the Pre-Chat API
Create Records Automatically with the Pre-Chat API
Customize Chat Windows with Visualforce
Post-Chat Pages Overview
Set Up Direct-to-Agent Chat Routing with the Deployment API
PDF

Newer Version Available

This content describes an older version of this product. View Latest

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 is online. Available in API versions 28.0 and later.

Syntax

void showWhenOnline(String buttonId, Object element, (optional) String userId)

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.
(Optional) 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 29.0 and later.

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

If you specify a user ID but not a button ID, the element will be displayed only if the agent is online. For example, the syntax below tracks an agent’s online status and sets the button to online when that agent is available; however, the button is set to offline if that agent isn’t available.
1liveagent.showWhenOnline('005xx000001Sv1m', document.getElementById('liveagent_button_toAgent_online'));
If you specify a button ID and an agent ID, the element will be 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');