Skip to main content
Version: 6.0

Supervisor

Introduction​

The b+s Supervisor displays team member information in the teams that they are configured to supervise. It also shows queue statistics of all skill groups, which are assigned to the supervised Agents.

This is a Lightning App Page and provides the supervisor with capabilities such as:

Supervisor features​

Team View​

  • Viewing details of team members (CCE only)
  • Changing the agent state of team members
  • Starting silent monitoring (This will start a silent monitoring call. The supervisor can then barge-in and drop participants inside the Connects Gadget)

Queue View​

  • Viewing details of queues

Team Message View​

  • Sending team messages
  • Viewing active team messages
  • Deleting active team messages

Check the CCE Agent Team List notes for more information on how to configure Teams.

info

Supervisors require access to certain resources of the b+s Connects package. These permissions are defined in the b+s Connects Supervisor Permission Set.

Installation​

b+s Supervisor needs to be implemented as a LWC as described in the Installation Guide using the code example below.

Configuration​

The following settings can be configured for the b+s Supervisor component from the b+s Configuration App. In order to do so, please go to Integrations | Integration Settings | + Add

Identifier​

Identifier of Supervisor component

Value: TeamSupervisor

Settings​

Settings are semicolon-separated key=value pairs. Boolean values are true or false; update intervals are in seconds.

SettingValuesDefaultDescription
hideTeamView<Boolean>falseHides the Team View.
hideQueueView<Boolean>falseHides the Queue View. Recommended for CCX deployments, because CCX doesn’t support queues.
hideTeamMessage<Boolean>falseHides the Team Message View.
callAgentID<Boolean>falseUses the agent ID instead of the extension for silent monitoring and click-to-dial actions.
showStateChangeTime<Boolean>trueShows the time since each agent's state changed in the Team View.
sortAgentNameBy0 or 11Sets the name order in the Team View: 0 is last name first; 1 is first name first.
queueUpdateInterval<Number>2Queue data refresh interval, in seconds.
teamUpdateInterval<Number>1Team data refresh interval, in seconds.
channelDetailUpdateInterval<Number>5Refresh interval for an expanded agent channel-detail row, in seconds.

Example:

Identifier: TeamSupervisor
Settings: hideQueueView=true;hideTeamMessage=true;teamUpdateInterval=5

Code Example​

The following files are to be deployed in force-app/main/default/lwc/teamSupervisor/


Filename

teamSupervisor.js

Code

import CNX_RESOURCE_LINK from '@salesforce/resourceUrl/cnx__CnxSfdcResources';
import { loadScript, loadStyle } from 'lightning/platformResourceLoader';
import retrieveTeamSupervisorLabelsForLWC from '@salesforce/apex/cnx.TeamSupervisorController.retrieveTeamSupervisorLabelsForLWC';
import { subscribe, publish, APPLICATION_SCOPE, createMessageContext } from 'lightning/messageService';
import msgChannel from '@salesforce/messageChannel/cnxMessageChannel__c';
import { LightningElement } from 'lwc';

export default class teamSupervisorComponent extends LightningElement {

moduleName = 'TeamSupervisorModule';

labels;
connectedCallback () {
Promise.all([
console.log('####################### Load BsModules.js'),
loadStyle(this, CNX_RESOURCE_LINK + '/addons/TeamSupervisor/css/TeamSupervisor.min.css'),
loadScript(this, CNX_RESOURCE_LINK + '/addons/TeamSupervisor/lib/jquery.min.js'),
loadScript(this, CNX_RESOURCE_LINK + '/addons/TeamSupervisor/lib/svg4everybody.js'),
loadScript(this, CNX_RESOURCE_LINK + '/addons/BsModules/js/BsModules.min.js'),
retrieveTeamSupervisorLabelsForLWC().then(result => { this.labels = result; })
])
.then(() => {
window.utilitySpritePath = `${CNX_RESOURCE_LINK}/addons/TeamSupervisor/img/`;

const messageContext = createMessageContext();
const noConflictInstance = ConnectsIntegrationAPI.noConflict();
noConflictInstance.setLMSEnvironment({
mode: 'LWC',
publishMethod: message => {
publish(messageContext, msgChannel, message);
},
subscribeMethod: handler => {
subscribe(messageContext, msgChannel, handler, { scope: APPLICATION_SCOPE });
}
});
noConflictInstance.waitReady(() => {
const moduleInstance = BsModules.load(this.moduleName, this.refs.teamSupervisorComponent, noConflictInstance);
moduleInstance.setLabels(this.labels);
moduleInstance.initializeModule();
});
})
.catch(error => {
console.error(this.moduleName + ': an error occurred.', error);
});
}
}

Filename

teamSupervisor.html

Code

<template>
<div lwc:ref="teamSupervisorComponent" lwc:dom="manual" class="bsSpvr"></div>
</template>

Filename

teamSupervisor.js-meta.xml

Code

<?xml version="1.0" encoding="UTF-8"?>
<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>60.0</apiVersion>
<description>TeamSupervisorComponent</description>
<isExposed>true</isExposed>
<masterLabel>TeamSupervisorComponent</masterLabel>
<targets>
<target>lightning__AppPage</target>
<target>lightning__RecordPage</target>
<target>lightning__HomePage</target>
<target>lightning__FlowScreen</target>
<target>lightning__Tab</target>
<target>lightning__UtilityBar</target>
</targets>
</LightningComponentBundle>

Troubleshooting​

Supervisor cannot control agent states​

Symptom

Supervisor cannot control agent states.

Possible Cause(s)

Missing Supervisor permission set or Integration API disabled.

Solution

Assign permission set and enable Integration API.