Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

lightning:omniChannelStatusChanged

Indicates that an agent has changed his or her presence status in Omni-Channel.

Response

Name Type Description
statusId string The ID of the agent’s current presence status.
channels string JSON string of channel objects.
reason string The reason for the user's status change. Possible values are:
  • OmniToolkitStatusChange
  • OmniPushTimeout
  • OmniDeclineWork
  • OmniManualStatusChange
  • OmniSupervisorStatusChange
  • OmniLoginStatusChange
statusName string The name of the agent’s current presence status.
statusApiName string The API name of the agent’s current presence status.

Example

This example prints status details to the browser’s developer console when an Omni-Channel user's presence status is changed.

Component code:

1<aura:component implements="flexipage:availableForAllPageTypes" access="global" >
2    <lightning:omniToolkitAPI aura:id="omniToolkit" />  
3    <aura:handler event="lightning:omniChannelStatusChanged" action="{! c.onStatusChanged }"/>
4</aura:component>

Controller code:

1({
2    onStatusChanged : function(component, event, helper) {
3        console.log("Status changed.");
4        var statusId = event.getParam('statusId');
5        var channels = event.getParam('channels');
6        var statusName = event.getParam('statusName');
7        var statusApiName = event.getParam('statusApiName');
8        console.log(statusId);
9        console.log(channels);
10        console.log(statusName);
11        console.log(statusApiName);
12    }, 
13})

channel

The channel object contains the following properties:

Name Type Description
channelId string Retrieves the ID of the service channel that’s associated with a presence status.
developerName string Retrieves the developer name of the service channel that’s associated with the channelId.