onChatRequested()

Registers a function to call when an agent receives a chat request. Available in API version 29.0 or later.

Syntax

1sforce.console.chat.onChatRequested(eventHandler:Function)

Arguments

Name	Type	Description
eventHandler	function	JavaScript method called when a chat request is assigned to an agent.

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('There is a new incoming chat request with this chatKey: ' + result.chatKey);
22        }
23        sforce.console.chat.onChatRequested(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
chatKey	String	The chat key for the incoming chat request.
success	Boolean	`true` if firing event was successful; `false` if firing event wasn’t successful.

Salesforce Console Integration Toolkit Developer's Guide

onChatRequested()

Syntax

Arguments

Sample Code–Visualforce

Response