Live Agent Developer's Guide

About This Guide
Prerequisites
API Versions
Customize Deployments with the Deployment APIs
Create Deployments
Log Deployment Activity with the Deployment APIs
enableLogging
Customize Your Chat Window with the Deployment APIs
Customize Chat Buttons with the Deployment APIs
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

Newer Version Available

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

enableLogging

Use the enableLogging deployment method to enable logging on a particular deployment. Available in API versions 28.0 and later.

Usage

Enables logging for a particular deployment, allowing your Web browser’s JavaScript console to store information about the activity that occurs within a deployment. You can retrieve the information from your browser’s developer console, so check the help for your browser if you’re not sure how to find it.

Syntax

liveagent.enableLogging();

Parameters

None

Messages for Logged Events

Message Triggered Meaning
System initialized. Waiting for the DOM to be ready. When liveagent.init() is called, usually at page load Live Agent endpoint URL, org ID and deployment ID have been set, now waiting for DOM to be ready before continuing.
No available event model. Exiting. During liveagent.init(), if there is an error This means no DOM event listener was found, which would be very rare. We would not be able to continue at this point, so it would be a hard stop.
DOM is ready. Setting up environment. Upon DOM ready of the page The page has fully loaded and the DOM is ready, so we perform our first "ping" to the server, which is to get the settings/information about the given deployment ID.
Setting state for button {Button ID} to online When the state of a button has changed to online The button is available for a chat request to be made.
Setting state for button {Button ID} to offline When the state of a button has changed to offline The button is not available for a chat request to be made.
Requesting new session During the first ping to the server No session ID cookie was found, so a new one must be generated. This means it was the first time visiting the site with this deployment code for this browsing session.
Reusing existing session During the first ping to the server A session cookie exists, so it is reused. This means the visitor has already been to this site during this browsing session (e.g., going from one page to another).
Received new session ID As a response to the first ping The server generated a new session ID, and it is being stored as a session cookie named "liveagent_sid.���
Ping rate set to {Rate}ms As a response to the first ping Indicates how frequently (in milliseconds) the page will ping the Live Agent server. The default is 50000 (50 seconds). This effectively indicates when button refreshes will occur.
Pinging server to keep presence When a ping to the server is made Indicates the visitor is still connected to and pinging the Live Agent server, meaning no errors or disconnects have occurred.
Disconnecting from Live Agent When an error occurs An error was thrown, whether in response from the server or due to network connectivity issues. Indicates that the visitor will no longer ping Live Agent for this page load (i.e., they will need to refresh).
Received updated LiveAgent server url: {URL}! Consider updating this site's deployment code. When an org has moved to a new core instance The Live Agent instance specified in the deployment code is no longer valid for this org, so the new URL has been provided. For better performance, we recommend updating the deployment code if they receive this.
Server Warning: {Message} A non-fatal exception occurred A warning condition was encountered, but processing can continue. The message provides further details.
Server sent an anonymous warning A non-fatal exception occurred A warning condition was encountered, but processing can continue. No message was provided.
Server Error: {Message} A fatal exception occurred An error condition was encountered, and processing cannot be continued. The message provides further details.
Server responded with an error A fatal exception occurred An error condition was encountered, and processing cannot be continued. No message was provided.
Group Start: Invite {Button ID} Rule Evaluation Rule evaluation has been triggered Evaluation of the filter logic for the given invite button ID has begun. This means the button is online and available for chat, and the filter logic will be used to determine if it should be displayed/presented or not.
Filter Logic: {Filter Logic} Rule evaluation has been triggered An information log containing the string representation of the filter logic of the invite rules as specified in the admin setup area. Useful to understand how the rules will be evaulated.
Evaluating StandardInviteRule When a standard rule is being evaluated Standard rules are "Number of Page Views" and "URL Match." They are part of the out-of-the-box rules that are provided in the admin setup area.
Evaluating TimerInviteRule When a timer-based rule is being evaluated Timer-based rules are "Seconds on Page" and "Seconds on Site." They are part of the out-of-the-box rules as well, except these rules will be re-evaluated again in the future when the required number of seconds has passed if the criteria was not met the first time (e.g., on page load).
Evaluating CustomInviteRule When a custom rule is being evaluated "Custom Variable" rules allow variable names to be specified which will be compared against upon evaluating these rules. The "setCustomVariable" API is used in conjunction with these to specify the value to compare with against the value specified in the admin setup area.
CustomInviteRule evaluation failed due to missing custom variable When a custom rule is being evaluated A "Custom Variable" rule was set up, but the "setCustomVariable" API was never called with this variable name specified, therefore the rule can not be evaluated.
Evaluate: {From Value} == {To Value} When a rule with an "equals" comparator is being evaluated A rule is being evaluated by comparing that the two values match exactly.
Not Equals - Evaluate: {From Value} != {To Value} When a rule with a "not equal to" comparator is being evaluated A rule is being evaluated by comparing that the two values do not match.
Starts With - Evaluate: {From Value} indexOf {To Value} == 0 When a rule with a "starts with" comparator is being evaluated. A rule is being evaluated by comparing that the first value starts with the second value.
Contains - Evaluate: {From Value} indexOf {To Value} != -1 When a rule with a "contains" comparator is being evaluated A rule is being evaluated by comparing that the first value contains the second value.
Does Not Contain - Evaluate: {From Value} indexOf {To Value} == -1 When a rule with a "does not contain" comparator is being evaluated A rule is being evaluated by comparing that the first value does not contain the second value.
Less Than - Evaluate: {From Value} < {To Value} When a rule with a "less than" comparator is being evaluated A rule is being evaluated by comparing that the first value is less than the second value.
Greater Than - Evaluate: {From Value} > {To Value} When a rule with a "greater than" comparator is being evaluated A rule is being evaluated by comparing that the first value is greater than the second value.
Less or Equal - Evaluate: {From Value} <= {To Value} When a rule with a "less or equal" comparator is being evaluated A rule is being evaluated by comparing that the first value is less than or equal to the second value.
Greater or Equal - Evaluate: {From Value} >= {To Value} When a rule with a "greater or equal" comparator is being evaluated A rule is being evaluated by comparing that the first value is greater than or equal to the second value.
Evaluating Atom Node: {Rule ID} When a rule is being evaluated Indicates that an actual rule is being evaluated.
Group Start: Evaluating And Node When two rules are being evaluated with an "AND" clause When multiple rules are used, this indicates when the criteria of a pair of rules must both be "true."
Group Start: Evaluating Or Node When two rules are being evaluated with an "OR" clause When multiple rules are used, this indicates when the criteria of a pair of rules must be "true" for one of them.
Group Start: Evaluating Not Node When two rules are being evaluated with a "NOT" clause This indicates to check for the opposite of what the criteria evaluates to.
Setting invite delay to: {Invite Delay} When a timer-based rule has not yet met the criteria If the criteria for a timer-based rule is not met, a delay is set to attempt to evaluate the rules again in the future when the criteria will have been met.