Newer Version Available

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

getChatRequests()

Returns the chat keys of the chat requests that have been assigned to an agent. Available in API version 29.0 or later.

Syntax

1sforce.console.chat.getChatRequests(callback:Function)

Arguments

Name Type Description
callback function JavaScript method called upon completion of the method.

Sample Code–Visualforce

1<apex:page>
2    <apex:includeScript value="/support/console/55.0/integration.js"/>
3    <a href="#" onClick="testGetChatRequests();return false;">Get Chat Requests</a> 
4
5    <script type="text/javascript">
6        function testGetChatRequests() {
7            sforce.console.chat.getChatRequests(function(result) {
8                if (result.success) {
9                    alert('Number of Chat Requests ' + result.chatKey.length);
10                } else {
11                    alert('getChatRequests has failed');
12                }
13            });
14        }
15    </script>
16</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 Array Array of chatKey values, one for each of the current chat requests.
success Boolean true if getting chat requests was successful; false if getting chat requests wasn’t successful.