Salesforce Console Integration Toolkit Developer's Guide
jNewer Version Available
onAgentStateChanged()
Registers a function to call when agents change their Live Agent
status, such as from Online to Away. Available in API version 29.0 or
later.
Syntax
1sforce.console.chat.onAgentStateChanged(eventHandler:Function)Arguments
| Name | Type | Description |
|---|---|---|
| eventHandler | function | JavaScript method called when the agent's Live Agent status has changed. |
Sample Code–Visualforce
1swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<apex:page>
18 <apex:includeScript value="/support/console/29.0/integration.js"/>
19 <script type="text/javascript">
20 var eventHandler = function (result) {
21 alert("Agent's State has Changed to: " + result.state);
22 };
23 sforce.console.chat.onAgentStateChanged(eventHandler);
24 </script>
25</apex:page>Response
This method is asynchronous so it returns its response in an object in a callback method. The response object contains the following properties:
| Name | Type | Description |
|---|---|---|
| state | String | String that represents the agent’s current Live Agent status—for example, Online, Away, or Offline. |
| success | Boolean | true if firing event was successful; false if firing event wasn’t successful. |