Newer Version Available

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

getServicePresenceStatusId

Retrieves an agent’s current presence status. Available in API versions 32.0 and later.

Syntax

1sforce.console.presence.getServicePresenceStatusId((optional) callback:function)

Arguments

Name Type Description
callback function JavaScript method to call when the agent’s presence status is retrieved.

Sample Code–Visualforce

1<apex:page>
2    <apex:includeScript value="/support/console/34.0/integration.js"/>
3    <a href="#" onClick="testGetStatusId();return false;">Get Omni-Channel Status ID</a>
4    
5    <script type="text/javascript">
6        function testGetStatusId() {
7            sforce.console.presence.getServicePresenceStatusId(function(result) {
8                if (result.success) {
9                    alert('Get Status Id successful');
10                    alert('Status Id is: ' + result.statusId);
11                } else {
12                    alert('Get Status Id failed');
13                }
14            });
15        }
16    </script>
17</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
success Boolean true if retrieving the presence status ID was successful; false if the retrieving the presence status ID wasn’t successful.
statusId String The ID of the agent’s current presence status.