@webex/contact-center 3.12.0-webex-services-ready.4 → 3.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.sdd/manifest.json +24 -13
- package/ai-docs/ARCHITECTURE.md +1 -1
- package/ai-docs/CONTRACTS.md +19 -3
- package/ai-docs/SECURITY.md +1 -1
- package/ai-docs/SERVICE_STATE.md +4 -0
- package/ai-docs/contact-center-spec.md +50 -6
- package/ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md +362 -0
- package/ai-docs/features/contact-owner-change-refactor.md +78 -0
- package/dist/cc.js +757 -22
- package/dist/cc.js.map +1 -1
- package/dist/config.js +7 -0
- package/dist/config.js.map +1 -1
- package/dist/constants.js +23 -2
- package/dist/constants.js.map +1 -1
- package/dist/index.js +34 -12
- package/dist/index.js.map +1 -1
- package/dist/metrics/MetricsManager.js +16 -0
- package/dist/metrics/MetricsManager.js.map +1 -1
- package/dist/metrics/behavioral-events.js +110 -0
- package/dist/metrics/behavioral-events.js.map +1 -1
- package/dist/metrics/constants.js +33 -0
- package/dist/metrics/constants.js.map +1 -1
- package/dist/services/AddressBook.js +18 -15
- package/dist/services/AddressBook.js.map +1 -1
- package/dist/services/AnswerCallOnWebexService.js +202 -0
- package/dist/services/AnswerCallOnWebexService.js.map +1 -0
- package/dist/services/ApiAiAssistant.js +221 -11
- package/dist/services/ApiAiAssistant.js.map +1 -1
- package/dist/services/EntryPoint.js +46 -68
- package/dist/services/EntryPoint.js.map +1 -1
- package/dist/services/Queue.js +27 -22
- package/dist/services/Queue.js.map +1 -1
- package/dist/services/WebCallingService.js +10 -2
- package/dist/services/WebCallingService.js.map +1 -1
- package/dist/services/WebexCrossClientService.js +225 -0
- package/dist/services/WebexCrossClientService.js.map +1 -0
- package/dist/services/WxAppTelephonyMercurySync.js +111 -0
- package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
- package/dist/services/config/Util.js +46 -46
- package/dist/services/config/Util.js.map +1 -1
- package/dist/services/config/constants.js +34 -77
- package/dist/services/config/constants.js.map +1 -1
- package/dist/services/config/index.js +100 -226
- package/dist/services/config/index.js.map +1 -1
- package/dist/services/config/types.js +51 -18
- package/dist/services/config/types.js.map +1 -1
- package/dist/services/constants.js +11 -1
- package/dist/services/constants.js.map +1 -1
- package/dist/services/core/Err.js.map +1 -1
- package/dist/services/core/Utils.js +25 -1
- package/dist/services/core/Utils.js.map +1 -1
- package/dist/services/core/WebexRequest.js +6 -2
- package/dist/services/core/WebexRequest.js.map +1 -1
- package/dist/services/core/aqm-reqs.js +17 -11
- package/dist/services/core/aqm-reqs.js.map +1 -1
- package/dist/services/core/constants.js +9 -1
- package/dist/services/core/constants.js.map +1 -1
- package/dist/services/core/types.js.map +1 -1
- package/dist/services/core/websocket/WebSocketManager.js +17 -1
- package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
- package/dist/services/task/Task.js +275 -8
- package/dist/services/task/Task.js.map +1 -1
- package/dist/services/task/TaskFactory.js +11 -6
- package/dist/services/task/TaskFactory.js.map +1 -1
- package/dist/services/task/TaskManager.js +590 -42
- package/dist/services/task/TaskManager.js.map +1 -1
- package/dist/services/task/TaskUtils.js +11 -1
- package/dist/services/task/TaskUtils.js.map +1 -1
- package/dist/services/task/WebexCallingUtils.js +70 -0
- package/dist/services/task/WebexCallingUtils.js.map +1 -0
- package/dist/services/task/constants.js +14 -2
- package/dist/services/task/constants.js.map +1 -1
- package/dist/services/task/contact.js +29 -0
- package/dist/services/task/contact.js.map +1 -1
- package/dist/services/task/digital/Digital.js +4 -3
- package/dist/services/task/digital/Digital.js.map +1 -1
- package/dist/services/task/state-machine/TaskStateMachine.js +162 -53
- package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -1
- package/dist/services/task/state-machine/actions.js +6 -1
- package/dist/services/task/state-machine/actions.js.map +1 -1
- package/dist/services/task/state-machine/guards.js +7 -10
- package/dist/services/task/state-machine/guards.js.map +1 -1
- package/dist/services/task/state-machine/types.js.map +1 -1
- package/dist/services/task/state-machine/uiControlsComputer.js +118 -18
- package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -1
- package/dist/services/task/types.js +47 -1
- package/dist/services/task/types.js.map +1 -1
- package/dist/services/task/voice/Voice.js +477 -17
- package/dist/services/task/voice/Voice.js.map +1 -1
- package/dist/services/task/voice/WebRTC.js +6 -3
- package/dist/services/task/voice/WebRTC.js.map +1 -1
- package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
- package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
- package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
- package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
- package/dist/services/wxAppDiagnosticLogging.js +159 -0
- package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
- package/dist/services/wxAppTelephonyUtils.js +19 -0
- package/dist/services/wxAppTelephonyUtils.js.map +1 -0
- package/dist/types/cc.d.ts +102 -8
- package/dist/types/config.d.ts +7 -0
- package/dist/types/constants.d.ts +21 -0
- package/dist/types/index.d.ts +34 -15
- package/dist/types/metrics/MetricsManager.d.ts +6 -0
- package/dist/types/metrics/constants.d.ts +31 -0
- package/dist/types/services/AddressBook.d.ts +2 -1
- package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
- package/dist/types/services/ApiAiAssistant.d.ts +48 -4
- package/dist/types/services/EntryPoint.d.ts +7 -5
- package/dist/types/services/Queue.d.ts +5 -3
- package/dist/types/services/WebexCrossClientService.d.ts +32 -0
- package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
- package/dist/types/services/config/Util.d.ts +4 -8
- package/dist/types/services/config/constants.d.ts +28 -76
- package/dist/types/services/config/index.d.ts +16 -64
- package/dist/types/services/config/types.d.ts +146 -173
- package/dist/types/services/constants.d.ts +9 -0
- package/dist/types/services/core/Err.d.ts +2 -0
- package/dist/types/services/core/Utils.d.ts +10 -0
- package/dist/types/services/core/WebexRequest.d.ts +1 -0
- package/dist/types/services/core/constants.d.ts +7 -0
- package/dist/types/services/core/types.d.ts +2 -0
- package/dist/types/services/task/Task.d.ts +34 -5
- package/dist/types/services/task/TaskFactory.d.ts +4 -2
- package/dist/types/services/task/TaskUtils.d.ts +6 -0
- package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
- package/dist/types/services/task/constants.d.ts +12 -0
- package/dist/types/services/task/contact.d.ts +4 -0
- package/dist/types/services/task/digital/Digital.d.ts +4 -3
- package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +304 -56
- package/dist/types/services/task/state-machine/guards.d.ts +6 -5
- package/dist/types/services/task/state-machine/types.d.ts +9 -1
- package/dist/types/services/task/types.d.ts +192 -5
- package/dist/types/services/task/voice/Voice.d.ts +68 -11
- package/dist/types/services/task/voice/WebRTC.d.ts +5 -4
- package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
- package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
- package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
- package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
- package/dist/types/types.d.ts +80 -13
- package/dist/types/utils/PageCache.d.ts +20 -3
- package/dist/types.js +54 -8
- package/dist/types.js.map +1 -1
- package/dist/utils/PageCache.js +19 -5
- package/dist/utils/PageCache.js.map +1 -1
- package/dist/webex.js +9 -1
- package/dist/webex.js.map +1 -1
- package/package.json +10 -9
- package/src/cc.ts +969 -38
- package/src/config.ts +7 -0
- package/src/constants.ts +24 -0
- package/src/index.ts +39 -10
- package/src/metrics/MetricsManager.ts +16 -0
- package/src/metrics/ai-docs/metrics-spec.md +138 -21
- package/src/metrics/behavioral-events.ts +112 -0
- package/src/metrics/constants.ts +36 -0
- package/src/services/AddressBook.ts +17 -6
- package/src/services/AnswerCallOnWebexService.ts +239 -0
- package/src/services/ApiAiAssistant.ts +297 -13
- package/src/services/EntryPoint.ts +59 -60
- package/src/services/Queue.ts +29 -12
- package/src/services/WebCallingService.ts +16 -2
- package/src/services/WebexCrossClientService.ts +298 -0
- package/src/services/WxAppTelephonyMercurySync.ts +142 -0
- package/src/services/agent/ai-docs/AGENTS.md +1 -1
- package/src/services/agent/ai-docs/agent-spec.md +1 -0
- package/src/services/ai-docs/AGENTS.md +10 -10
- package/src/services/ai-docs/services-spec.md +25 -5
- package/src/services/config/Util.ts +52 -82
- package/src/services/config/ai-docs/AGENTS.md +35 -40
- package/src/services/config/ai-docs/ARCHITECTURE.md +90 -103
- package/src/services/config/ai-docs/config-spec.md +132 -132
- package/src/services/config/constants.ts +39 -85
- package/src/services/config/index.ts +116 -277
- package/src/services/config/types.ts +140 -195
- package/src/services/constants.ts +10 -0
- package/src/services/core/Err.ts +1 -0
- package/src/services/core/Utils.ts +28 -0
- package/src/services/core/WebexRequest.ts +3 -1
- package/src/services/core/ai-docs/core-spec.md +25 -11
- package/src/services/core/aqm-reqs.ts +18 -12
- package/src/services/core/constants.ts +8 -0
- package/src/services/core/types.ts +33 -1
- package/src/services/core/websocket/WebSocketManager.ts +26 -2
- package/src/services/task/Task.ts +386 -12
- package/src/services/task/TaskFactory.ts +33 -6
- package/src/services/task/TaskManager.ts +857 -41
- package/src/services/task/TaskUtils.ts +13 -0
- package/src/services/task/WebexCallingUtils.ts +136 -0
- package/src/services/task/ai-docs/ARCHITECTURE.md +1 -0
- package/src/services/task/ai-docs/task-spec.md +190 -8
- package/src/services/task/constants.ts +13 -0
- package/src/services/task/contact.ts +30 -0
- package/src/services/task/digital/Digital.ts +11 -4
- package/src/services/task/state-machine/TaskStateMachine.ts +235 -81
- package/src/services/task/state-machine/actions.ts +5 -2
- package/src/services/task/state-machine/ai-docs/AGENTS.md +6 -4
- package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +35 -16
- package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +103 -33
- package/src/services/task/state-machine/guards.ts +7 -10
- package/src/services/task/state-machine/types.ts +16 -1
- package/src/services/task/state-machine/uiControlsComputer.ts +206 -32
- package/src/services/task/types.ts +269 -4
- package/src/services/task/voice/Voice.ts +625 -17
- package/src/services/task/voice/WebRTC.ts +11 -4
- package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
- package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
- package/src/services/wxAppDiagnosticLogging.ts +286 -0
- package/src/services/wxAppTelephonyUtils.ts +14 -0
- package/src/types.ts +108 -13
- package/src/utils/AGENTS.md +21 -10
- package/src/utils/PageCache.ts +38 -5
- package/src/utils/ai-docs/utils-spec.md +21 -11
- package/src/webex.js +8 -0
- package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
- package/test/unit/spec/cc.ts +3408 -152
- package/test/unit/spec/index.ts +885 -0
- package/test/unit/spec/metrics/MetricsManager.ts +25 -0
- package/test/unit/spec/metrics/behavioral-events.ts +60 -0
- package/test/unit/spec/services/AddressBook.ts +37 -6
- package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
- package/test/unit/spec/services/ApiAiAssistant.ts +269 -8
- package/test/unit/spec/services/EntryPoint.ts +87 -40
- package/test/unit/spec/services/Queue.ts +123 -12
- package/test/unit/spec/services/WebCallingService.ts +38 -0
- package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
- package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
- package/test/unit/spec/services/config/Util.ts +501 -0
- package/test/unit/spec/services/config/index.ts +313 -543
- package/test/unit/spec/services/core/Utils.ts +22 -0
- package/test/unit/spec/services/core/WebexRequest.ts +8 -7
- package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
- package/test/unit/spec/services/core/websocket/WebSocketManager.ts +64 -14
- package/test/unit/spec/services/task/Task.ts +2257 -11
- package/test/unit/spec/services/task/TaskFactory.ts +56 -2
- package/test/unit/spec/services/task/TaskManager.ts +5559 -1493
- package/test/unit/spec/services/task/TaskUtils.ts +72 -0
- package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
- package/test/unit/spec/services/task/contact.ts +33 -0
- package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +1501 -92
- package/test/unit/spec/services/task/state-machine/guards.ts +210 -8
- package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +445 -7
- package/test/unit/spec/services/task/voice/Voice.ts +1710 -4
- package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
- package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
- package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
- package/test/unit/spec/wellnessSampleUtils.ts +288 -0
- package/typedoc.md +1 -1
- package/umd/contact-center.min.js +2 -2
- package/umd/contact-center.min.js.map +1 -1
package/dist/cc.js
CHANGED
|
@@ -19,6 +19,10 @@ var _Utils = require("./services/core/Utils");
|
|
|
19
19
|
var _types3 = require("./services/config/types");
|
|
20
20
|
var _TaskManager = _interopRequireDefault(require("./services/task/TaskManager"));
|
|
21
21
|
var _WebCallingService = _interopRequireDefault(require("./services/WebCallingService"));
|
|
22
|
+
var _AnswerCallOnWebexService = _interopRequireDefault(require("./services/AnswerCallOnWebexService"));
|
|
23
|
+
var _WebexCrossClientService = _interopRequireDefault(require("./services/WebexCrossClientService"));
|
|
24
|
+
var _WxAppTelephonyMercurySync = _interopRequireDefault(require("./services/WxAppTelephonyMercurySync"));
|
|
25
|
+
var _wxAppDiagnosticLogging = require("./services/wxAppDiagnosticLogging");
|
|
22
26
|
var _types4 = require("./services/task/types");
|
|
23
27
|
var _MetricsManager = _interopRequireDefault(require("./metrics/MetricsManager"));
|
|
24
28
|
var _constants4 = require("./metrics/constants");
|
|
@@ -36,6 +40,13 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
|
|
|
36
40
|
* with Webex Contact Center features through the WebexSDK.
|
|
37
41
|
*/
|
|
38
42
|
|
|
43
|
+
/**
|
|
44
|
+
* Typed allow-list of server-controlled websocket event names this SDK re-emits verbatim.
|
|
45
|
+
* Guards against emitting an arbitrary/unknown `data.type` supplied by the websocket payload.
|
|
46
|
+
* @ignore
|
|
47
|
+
*/
|
|
48
|
+
const CC_EVENT_ALLOW_LIST = new Set(Object.values(_types3.CC_EVENTS));
|
|
49
|
+
|
|
39
50
|
/**
|
|
40
51
|
* The main Contact Center plugin class that enables integration with Webex Contact Center.
|
|
41
52
|
*
|
|
@@ -119,7 +130,7 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
|
|
|
119
130
|
*
|
|
120
131
|
* // Login with browser-based calling
|
|
121
132
|
* await cc.stationLogin({
|
|
122
|
-
* teamId: profile.teams[0].
|
|
133
|
+
* teamId: profile.teams[0].id,
|
|
123
134
|
* loginOption: 'BROWSER'
|
|
124
135
|
* });
|
|
125
136
|
*
|
|
@@ -185,6 +196,29 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
185
196
|
* @private
|
|
186
197
|
*/
|
|
187
198
|
|
|
199
|
+
/**
|
|
200
|
+
* REST telephony for wxApp thick-client answer (WXCC-6026)
|
|
201
|
+
* @private
|
|
202
|
+
*/
|
|
203
|
+
|
|
204
|
+
/**
|
|
205
|
+
* usersub cross-client state for Webex App toast suppression
|
|
206
|
+
* @private
|
|
207
|
+
*/
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* Mercury telephony mute sync for wxApp thick-client answer
|
|
211
|
+
* @private
|
|
212
|
+
*/
|
|
213
|
+
|
|
214
|
+
/** True when wxApp mute sync opened Mercury (Extension/DN-only profiles). */
|
|
215
|
+
wxAppMercuryConnectedByCc = false;
|
|
216
|
+
|
|
217
|
+
/** True when wxApp mute sync registered the Webex device. */
|
|
218
|
+
wxAppDeviceRegisteredByCc = false;
|
|
219
|
+
static WXAPP_FALSE_PUBLISH_RETRY_DELAY_MS = 30_000;
|
|
220
|
+
static WXAPP_FALSE_PUBLISH_MAX_RETRIES = 3;
|
|
221
|
+
|
|
188
222
|
/**
|
|
189
223
|
* Core service managers for Contact Center operations
|
|
190
224
|
* Includes agent, connection, and configuration services
|
|
@@ -213,6 +247,16 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
213
247
|
* @private
|
|
214
248
|
*/
|
|
215
249
|
|
|
250
|
+
/** Current login/relogin session used for agent-scoped wellness validation. */
|
|
251
|
+
|
|
252
|
+
/** Registered-session cache for the system WellbeingBreak idle code. */
|
|
253
|
+
|
|
254
|
+
/** Registration generation that owns the wellness idle-code cache and in-flight lookups. */
|
|
255
|
+
wellnessRegistrationGeneration = 0;
|
|
256
|
+
updateWellnessSession(agentSessionId) {
|
|
257
|
+
this.currentAgentSessionId = agentSessionId;
|
|
258
|
+
}
|
|
259
|
+
|
|
216
260
|
/**
|
|
217
261
|
* API instance for managing Webex Contact Center entry points
|
|
218
262
|
* Provides functionality to fetch entry points with caching support
|
|
@@ -345,11 +389,19 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
345
389
|
connectionConfig: this.getConnectionConfig()
|
|
346
390
|
});
|
|
347
391
|
this.webCallingService = new _WebCallingService.default(this.$webex);
|
|
348
|
-
this.
|
|
392
|
+
this.answerCallOnWebexService = new _AnswerCallOnWebexService.default(this.$webex);
|
|
393
|
+
this.webexCrossClientService = new _WebexCrossClientService.default(this.$webex);
|
|
394
|
+
this.wxAppTelephonyMercurySync = new _WxAppTelephonyMercurySync.default(this.$webex);
|
|
395
|
+
this.apiAIAssistant = new _ApiAiAssistant.ApiAIAssistant(this.$webex, () => ({
|
|
396
|
+
isWellnessBreakEnabled: this.agentConfig?.isWellnessBreakEnabled === true,
|
|
397
|
+
agentId: this.agentConfig?.agentId,
|
|
398
|
+
agentSessionId: this.currentAgentSessionId
|
|
399
|
+
}));
|
|
349
400
|
this.metricsManager = _MetricsManager.default.getInstance({
|
|
350
401
|
webex: this.$webex
|
|
351
402
|
});
|
|
352
403
|
this.taskManager = _TaskManager.default.getTaskManager(this.apiAIAssistant, this.services.contact, this.webCallingService, this.services.webSocketManager, this.services.rtdWebSocketManager);
|
|
404
|
+
this.taskManager.setAnswerCallOnWebexService(this.answerCallOnWebexService);
|
|
353
405
|
this.incomingTaskListener();
|
|
354
406
|
|
|
355
407
|
// Initialize API instances
|
|
@@ -411,7 +463,82 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
411
463
|
// @ts-ignore
|
|
412
464
|
this.trigger(_types4.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, task);
|
|
413
465
|
};
|
|
466
|
+
trackInvalidWellnessEvent(reason) {
|
|
467
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_EVENT_INVALID, {
|
|
468
|
+
reason
|
|
469
|
+
}, ['operational']);
|
|
470
|
+
}
|
|
471
|
+
normalizeWellnessBreakEvent(payload) {
|
|
472
|
+
if (this.agentConfig?.isWellnessBreakEnabled !== true) {
|
|
473
|
+
this.trackInvalidWellnessEvent('wellness_disabled');
|
|
474
|
+
return null;
|
|
475
|
+
}
|
|
476
|
+
const notificationData = (0, _Utils.isRecord)(payload.data) ? payload.data : null;
|
|
477
|
+
const notificationDetails = notificationData && (0, _Utils.isRecord)(notificationData.notifDetails) ? notificationData.notifDetails : null;
|
|
478
|
+
const sessionData = notificationData && (0, _Utils.isRecord)(notificationData.data) ? notificationData.data : null;
|
|
479
|
+
const actionEvent = notificationDetails?.actionEvent;
|
|
480
|
+
if (payload.type !== _constants.WELLNESS_BREAK_HANDLER || notificationData?.notifType !== _constants.WELLNESS_BREAK_HANDLER || typeof actionEvent !== 'string') {
|
|
481
|
+
this.trackInvalidWellnessEvent('malformed_wellness_event');
|
|
482
|
+
return null;
|
|
483
|
+
}
|
|
484
|
+
if (!Object.values(_types.WELLNESS_BREAK_NOTIFICATION_ACTIONS).includes(actionEvent)) {
|
|
485
|
+
this.trackInvalidWellnessEvent('unknown_wellness_action');
|
|
486
|
+
return null;
|
|
487
|
+
}
|
|
488
|
+
const agentId = notificationData.agentId;
|
|
489
|
+
const eventOrgId = notificationData.orgId;
|
|
490
|
+
const sessionOrgId = sessionData?.orgId;
|
|
491
|
+
const envelopeOrgId = payload.orgId;
|
|
492
|
+
const agentSessionId = sessionData?.agentSessionId;
|
|
493
|
+
const currentOrgId = this.$webex.credentials.getOrgId();
|
|
494
|
+
if (typeof agentId !== 'string' || typeof eventOrgId !== 'string' || typeof sessionOrgId !== 'string' || typeof envelopeOrgId !== 'string' || typeof agentSessionId !== 'string' || !agentId || !eventOrgId || !sessionOrgId || !envelopeOrgId || !agentSessionId) {
|
|
495
|
+
this.trackInvalidWellnessEvent('missing_wellness_identity');
|
|
496
|
+
return null;
|
|
497
|
+
}
|
|
498
|
+
if (agentId !== this.agentConfig?.agentId || eventOrgId !== currentOrgId || sessionOrgId !== currentOrgId || envelopeOrgId !== currentOrgId) {
|
|
499
|
+
this.trackInvalidWellnessEvent('mismatched_wellness_identity');
|
|
500
|
+
return null;
|
|
501
|
+
}
|
|
502
|
+
const interactionValue = sessionData.interactionId ?? sessionData.InteractionId;
|
|
503
|
+
const actionText = notificationDetails.actionText;
|
|
504
|
+
const trackingId = payload.trackingId;
|
|
505
|
+
return {
|
|
506
|
+
agentId,
|
|
507
|
+
orgId: currentOrgId,
|
|
508
|
+
agentSessionId,
|
|
509
|
+
actionEvent: actionEvent,
|
|
510
|
+
...(typeof actionText === 'string' ? {
|
|
511
|
+
actionText
|
|
512
|
+
} : {}),
|
|
513
|
+
...(typeof interactionValue === 'string' ? {
|
|
514
|
+
interactionId: interactionValue
|
|
515
|
+
} : {}),
|
|
516
|
+
...(typeof trackingId === 'string' ? {
|
|
517
|
+
trackingId
|
|
518
|
+
} : {})
|
|
519
|
+
};
|
|
520
|
+
}
|
|
521
|
+
handleWellnessBreakWebsocketPayload(payload) {
|
|
522
|
+
if (payload.type !== _constants.WELLNESS_BREAK_HANDLER) {
|
|
523
|
+
return false;
|
|
524
|
+
}
|
|
525
|
+
const wellnessEvent = this.normalizeWellnessBreakEvent(payload);
|
|
526
|
+
if (wellnessEvent) {
|
|
527
|
+
// @ts-ignore - WebexPlugin emit is available at runtime but absent from its declaration.
|
|
528
|
+
this.emit(_types3.CC_EVENTS.WELLNESS_BREAK, wellnessEvent);
|
|
529
|
+
}
|
|
530
|
+
return true;
|
|
531
|
+
}
|
|
414
532
|
handleRTDWebsocketMessage = event => {
|
|
533
|
+
let payload;
|
|
534
|
+
try {
|
|
535
|
+
payload = JSON.parse(event);
|
|
536
|
+
} catch {
|
|
537
|
+
// TaskManager retains its existing malformed RTD message handling.
|
|
538
|
+
}
|
|
539
|
+
if ((0, _Utils.isRecord)(payload) && this.handleWellnessBreakWebsocketPayload(payload)) {
|
|
540
|
+
return;
|
|
541
|
+
}
|
|
415
542
|
this.taskManager.handleRealtimeWebsocketEvent(event);
|
|
416
543
|
};
|
|
417
544
|
|
|
@@ -456,15 +583,17 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
456
583
|
*
|
|
457
584
|
* console.log('Agent ID:', profile.agentId);
|
|
458
585
|
* console.log('Default DN:', profile.defaultDn);
|
|
459
|
-
* console.log('Teams:', profile.teams.map(t => t.
|
|
586
|
+
* console.log('Teams:', profile.teams.map(t => t.id));
|
|
460
587
|
* console.log('WebRTC Enabled:', profile.webRtcEnabled);
|
|
461
588
|
* console.log('Supported Login Options:', profile.loginVoiceOptions);
|
|
462
589
|
*
|
|
463
590
|
* // Now you can proceed with station login, state changes, etc.
|
|
464
|
-
* await cc.stationLogin({ teamId: profile.teams[0].
|
|
591
|
+
* await cc.stationLogin({ teamId: profile.teams[0].id, loginOption: 'BROWSER' });
|
|
465
592
|
* ```
|
|
466
593
|
*/
|
|
467
594
|
async register() {
|
|
595
|
+
this.wellnessRegistrationGeneration += 1;
|
|
596
|
+
this.wellbeingBreakIdleCode = undefined;
|
|
468
597
|
_loggerProxy.default.log('Starting CC SDK registration', {
|
|
469
598
|
module: _constants.CC_FILE,
|
|
470
599
|
method: _constants.METHODS.REGISTER
|
|
@@ -484,7 +613,14 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
484
613
|
module: _constants.CC_FILE,
|
|
485
614
|
method: _constants.METHODS.REGISTER
|
|
486
615
|
});
|
|
487
|
-
|
|
616
|
+
|
|
617
|
+
// Registration can silently restore a station session without emitting a
|
|
618
|
+
// relogin event. Project the active session for consumers that must
|
|
619
|
+
// recover session-scoped state after a page refresh.
|
|
620
|
+
return resp.isAgentLoggedIn && this.currentAgentSessionId ? {
|
|
621
|
+
...resp,
|
|
622
|
+
agentSessionId: this.currentAgentSessionId
|
|
623
|
+
} : resp;
|
|
488
624
|
} catch (error) {
|
|
489
625
|
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WEBSOCKET_REGISTER_FAILED, {
|
|
490
626
|
orgId: error.orgId
|
|
@@ -531,8 +667,12 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
531
667
|
*
|
|
532
668
|
*/
|
|
533
669
|
async deregister() {
|
|
670
|
+
this.wellnessRegistrationGeneration += 1;
|
|
671
|
+
this.wellbeingBreakIdleCode = undefined;
|
|
672
|
+
this.updateWellnessSession();
|
|
534
673
|
try {
|
|
535
674
|
this.metricsManager.timeEvent([_constants4.METRIC_EVENT_NAMES.WEBSOCKET_DEREGISTER_SUCCESS, _constants4.METRIC_EVENT_NAMES.WEBSOCKET_DEREGISTER_FAIL]);
|
|
675
|
+
this.taskManager.clearAISummaryState();
|
|
536
676
|
this.taskManager.off(_types4.TASK_EVENTS.TASK_INCOMING, this.handleIncomingTask);
|
|
537
677
|
this.taskManager.off(_types4.TASK_EVENTS.TASK_HYDRATE, this.handleTaskHydrate);
|
|
538
678
|
this.taskManager.off(_types4.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, this.handleTaskMultiLoginHydrate);
|
|
@@ -541,6 +681,11 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
541
681
|
this.services.webSocketManager.off('message', this.handleWebsocketMessage);
|
|
542
682
|
this.services.rtdWebSocketManager.off('message', this.handleRTDWebsocketMessage);
|
|
543
683
|
this.services.connectionService.off('connectionLost', this.handleConnectionLost);
|
|
684
|
+
const {
|
|
685
|
+
publishError: wxAppPublishError
|
|
686
|
+
} = await this.teardownWxAppLocalState({
|
|
687
|
+
clearInitFlag: true
|
|
688
|
+
});
|
|
544
689
|
if (this.agentConfig.webRtcEnabled && this.agentConfig.loginVoiceOptions.includes(_types.LoginOption.BROWSER)) {
|
|
545
690
|
if (this.$webex.internal.mercury.connected) {
|
|
546
691
|
this.$webex.internal.mercury.off('online');
|
|
@@ -565,7 +710,12 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
565
710
|
}
|
|
566
711
|
|
|
567
712
|
// Clear any cached agent configuration
|
|
713
|
+
this.wellbeingBreakIdleCode = undefined;
|
|
568
714
|
this.agentConfig = null;
|
|
715
|
+
this.updateWellnessSession();
|
|
716
|
+
if (wxAppPublishError) {
|
|
717
|
+
throw wxAppPublishError;
|
|
718
|
+
}
|
|
569
719
|
_loggerProxy.default.log('Deregistered successfully', {
|
|
570
720
|
module: _constants.CC_FILE,
|
|
571
721
|
method: _constants.METHODS.DEREGISTER
|
|
@@ -619,6 +769,12 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
619
769
|
* ```
|
|
620
770
|
*/
|
|
621
771
|
async getBuddyAgents(data) {
|
|
772
|
+
const {
|
|
773
|
+
action,
|
|
774
|
+
state,
|
|
775
|
+
mediaType = 'telephony'
|
|
776
|
+
} = data;
|
|
777
|
+
const buddyAgentState = state ?? (action === 'Transfer' ? _constants2.AGENT_STATE_AVAILABLE : undefined);
|
|
622
778
|
_loggerProxy.default.info('Fetching buddy agents', {
|
|
623
779
|
module: _constants.CC_FILE,
|
|
624
780
|
method: _constants.METHODS.GET_BUDDY_AGENTS
|
|
@@ -628,13 +784,16 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
628
784
|
const resp = await this.services.agent.buddyAgents({
|
|
629
785
|
data: {
|
|
630
786
|
agentProfileId: this.agentConfig.agentProfileID,
|
|
631
|
-
|
|
787
|
+
mediaType,
|
|
788
|
+
...(buddyAgentState ? {
|
|
789
|
+
state: buddyAgentState
|
|
790
|
+
} : {})
|
|
632
791
|
}
|
|
633
792
|
});
|
|
634
793
|
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.FETCH_BUDDY_AGENTS_SUCCESS, {
|
|
635
794
|
..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(resp),
|
|
636
|
-
mediaType
|
|
637
|
-
buddyAgentState
|
|
795
|
+
mediaType,
|
|
796
|
+
buddyAgentState,
|
|
638
797
|
buddyAgentCount: resp.data.agentList.length
|
|
639
798
|
}, ['operational']);
|
|
640
799
|
_loggerProxy.default.log(`Successfully retrieved ${resp.data.agentList.length} buddy agents`, {
|
|
@@ -647,8 +806,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
647
806
|
const failureResp = error.details;
|
|
648
807
|
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.FETCH_BUDDY_AGENTS_FAILED, {
|
|
649
808
|
..._MetricsManager.default.getCommonTrackingFieldForAQMResponseFailed(failureResp),
|
|
650
|
-
mediaType
|
|
651
|
-
buddyAgentState
|
|
809
|
+
mediaType,
|
|
810
|
+
buddyAgentState
|
|
652
811
|
}, ['operational']);
|
|
653
812
|
const {
|
|
654
813
|
error: detailedError
|
|
@@ -685,20 +844,32 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
685
844
|
isEndConsultEnabled: this.agentConfig.isEndConsultEnabled,
|
|
686
845
|
webRtcEnabled: this.agentConfig.webRtcEnabled,
|
|
687
846
|
autoWrapup: this.agentConfig.wrapUpData?.wrapUpProps?.autoWrapup ?? false,
|
|
688
|
-
aiFeature: this.agentConfig.aiFeature
|
|
847
|
+
aiFeature: this.agentConfig.aiFeature,
|
|
848
|
+
consultTransfer: {
|
|
849
|
+
allowConsultToQueue: this.agentConfig.allowConsultToQueue,
|
|
850
|
+
accessQueue: this.agentConfig.accessQueue,
|
|
851
|
+
accessEntryPoint: this.agentConfig.accessEntryPoint,
|
|
852
|
+
accessBuddyTeam: this.agentConfig.accessBuddyTeam
|
|
853
|
+
},
|
|
854
|
+
enableWxBetterTogether: this.isWxBetterTogetherEnabled(),
|
|
855
|
+
getWxAppUsersubPublished: () => this.webexCrossClientService.isAnswerCallsStateActive()
|
|
689
856
|
};
|
|
690
857
|
this.taskManager.setConfigFlags(configFlags);
|
|
691
858
|
// TODO: Make profile a singleton to make it available throughout app/sdk so we dont need to inject info everywhere
|
|
692
859
|
this.taskManager.setWrapupData(this.agentConfig.wrapUpData);
|
|
693
860
|
this.taskManager.setAgentId(this.agentConfig.agentId);
|
|
861
|
+
this.taskManager.setAgentName(this.agentConfig.agentName);
|
|
694
862
|
this.taskManager.setWebRtcEnabled(this.agentConfig.webRtcEnabled);
|
|
695
863
|
this.apiAIAssistant.setAIFeatureFlags(this.agentConfig.aiFeature);
|
|
864
|
+
this.wellbeingBreakIdleCode = undefined;
|
|
865
|
+
this.updateWellnessSession();
|
|
696
866
|
|
|
697
867
|
/**
|
|
698
868
|
* RTD websocket currently supports realtime transcripts and suggested responses.
|
|
699
869
|
* Extend this condition when additional AI RTD features are introduced.
|
|
870
|
+
* Wellness break notifications also arrive on this websocket.
|
|
700
871
|
*/
|
|
701
|
-
if (this.agentConfig.aiFeature?.realtimeTranscripts?.enable || this.agentConfig.aiFeature?.suggestedResponses?.enable) {
|
|
872
|
+
if (this.agentConfig.aiFeature?.realtimeTranscripts?.enable || this.agentConfig.aiFeature?.suggestedResponses?.enable || this.agentConfig.aiFeature?.generatedSummaries?.wrapUpSummariesEnabled === true || this.agentConfig.aiFeature?.generatedSummaries?.consultTransferSummariesEnabled === true || this.agentConfig.isWellnessBreakEnabled) {
|
|
702
873
|
_loggerProxy.default.info('Connecting to RTD websocket', {
|
|
703
874
|
module: _constants.CC_FILE,
|
|
704
875
|
method: _constants.METHODS.CONNECT_WEBSOCKET
|
|
@@ -748,6 +919,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
748
919
|
}
|
|
749
920
|
return this.agentConfig;
|
|
750
921
|
} catch (error) {
|
|
922
|
+
this.updateWellnessSession();
|
|
751
923
|
_loggerProxy.default.error(`Error during register: ${error}`, {
|
|
752
924
|
module: _constants.CC_FILE,
|
|
753
925
|
method: _constants.METHODS.CONNECT_WEBSOCKET
|
|
@@ -807,13 +979,15 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
807
979
|
throw error;
|
|
808
980
|
}
|
|
809
981
|
}
|
|
982
|
+
const deviceId = this.getDeviceId(data.loginOption, data.dialNumber);
|
|
810
983
|
const loginResponse = await this.services.agent.stationLogin({
|
|
811
984
|
data: {
|
|
812
|
-
|
|
985
|
+
// BROWSER DN must be webrtc-{agentId} so VPOP/RTMS do not treat a bare UUID as PSTN.
|
|
986
|
+
dialNumber: data.loginOption === _types.LoginOption.BROWSER ? deviceId : data.dialNumber,
|
|
813
987
|
teamId: data.teamId,
|
|
814
988
|
deviceType: data.loginOption,
|
|
815
989
|
isExtension: data.loginOption === _types.LoginOption.EXTENSION,
|
|
816
|
-
deviceId
|
|
990
|
+
deviceId,
|
|
817
991
|
roles: [_constants3.AGENT],
|
|
818
992
|
teamName: _constants.EMPTY_STRING,
|
|
819
993
|
siteId: _constants.EMPTY_STRING,
|
|
@@ -834,6 +1008,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
834
1008
|
channelsMap,
|
|
835
1009
|
...loginData
|
|
836
1010
|
} = resp.data;
|
|
1011
|
+
this.updateWellnessSession(resp.data.agentSessionId);
|
|
837
1012
|
this.agentConfig.currentTeamId = resp.data.teamId;
|
|
838
1013
|
const response = {
|
|
839
1014
|
...loginData,
|
|
@@ -846,6 +1021,13 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
846
1021
|
notifsTrackingId: resp.trackingId
|
|
847
1022
|
};
|
|
848
1023
|
this.webCallingService.setLoginOption(data.loginOption);
|
|
1024
|
+
if (this.agentConfig) {
|
|
1025
|
+
this.agentConfig.deviceType = data.loginOption;
|
|
1026
|
+
if (data.loginOption === _types.LoginOption.AGENT_DN || data.loginOption === _types.LoginOption.EXTENSION) {
|
|
1027
|
+
this.agentConfig.defaultDn = data.dialNumber;
|
|
1028
|
+
this.agentConfig.dn = data.dialNumber;
|
|
1029
|
+
}
|
|
1030
|
+
}
|
|
849
1031
|
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.STATION_LOGIN_SUCCESS, {
|
|
850
1032
|
..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(resp),
|
|
851
1033
|
loginType: data.loginOption,
|
|
@@ -858,6 +1040,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
858
1040
|
method: _constants.METHODS.STATION_LOGIN,
|
|
859
1041
|
trackingId: resp.trackingId
|
|
860
1042
|
});
|
|
1043
|
+
await this.ensureWxAppPostStationLogin();
|
|
861
1044
|
return response;
|
|
862
1045
|
} catch (error) {
|
|
863
1046
|
const failure = error.details;
|
|
@@ -912,6 +1095,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
912
1095
|
if (this.webCallingService) {
|
|
913
1096
|
this.webCallingService.deregisterWebCallingLine();
|
|
914
1097
|
}
|
|
1098
|
+
await this.teardownWxAppLocalState();
|
|
1099
|
+
this.updateWellnessSession();
|
|
915
1100
|
_loggerProxy.default.log(`Agent station logout completed successfully`, {
|
|
916
1101
|
module: _constants.CC_FILE,
|
|
917
1102
|
method: _constants.METHODS.STATION_LOGOUT,
|
|
@@ -1005,7 +1190,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1005
1190
|
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.AGENT_STATE_CHANGE_SUCCESS, {
|
|
1006
1191
|
..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(agentStatusResponse),
|
|
1007
1192
|
requestedState: data.state,
|
|
1008
|
-
teamId: this.agentConfig?.teams[0]?.
|
|
1193
|
+
teamId: this.agentConfig?.teams[0]?.id ?? _constants.EMPTY_STRING,
|
|
1009
1194
|
status: agentStatusResponse.data?.status,
|
|
1010
1195
|
subStatus: agentStatusResponse.data?.subStatus,
|
|
1011
1196
|
auxCodeId: data.auxCodeId,
|
|
@@ -1032,6 +1217,63 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1032
1217
|
}
|
|
1033
1218
|
}
|
|
1034
1219
|
|
|
1220
|
+
/**
|
|
1221
|
+
* Returns the system-managed `WellbeingBreak` idle code for the current registration.
|
|
1222
|
+
* The value is fetched outside Desktop Profile filtering and cached until deregistration.
|
|
1223
|
+
* @returns The normalized system idle-code entity
|
|
1224
|
+
* @throws Structured Contact Center error when wellness is disabled or the code is unavailable
|
|
1225
|
+
* @example
|
|
1226
|
+
* const idleCode = await webex.cc.getWellbeingBreakIdleCode();
|
|
1227
|
+
* @public
|
|
1228
|
+
*/
|
|
1229
|
+
async getWellbeingBreakIdleCode() {
|
|
1230
|
+
const method = _constants.METHODS.GET_WELLBEING_BREAK_IDLE_CODE;
|
|
1231
|
+
try {
|
|
1232
|
+
if (!this.agentConfig?.isWellnessBreakEnabled) {
|
|
1233
|
+
const validationError = new Error('WELLNESS_BREAK_NOT_ENABLED');
|
|
1234
|
+
validationError.details = {
|
|
1235
|
+
type: 'SDK_VALIDATION_ERROR',
|
|
1236
|
+
orgId: this.$webex.credentials.getOrgId(),
|
|
1237
|
+
trackingId: _constants.EMPTY_STRING,
|
|
1238
|
+
data: {
|
|
1239
|
+
reason: 'WELLNESS_BREAK_NOT_ENABLED'
|
|
1240
|
+
}
|
|
1241
|
+
};
|
|
1242
|
+
throw validationError;
|
|
1243
|
+
}
|
|
1244
|
+
if (this.wellbeingBreakIdleCode) {
|
|
1245
|
+
return this.wellbeingBreakIdleCode;
|
|
1246
|
+
}
|
|
1247
|
+
this.metricsManager.timeEvent([_constants4.METRIC_EVENT_NAMES.WELLBEING_BREAK_IDLE_CODE_FETCH_SUCCESS, _constants4.METRIC_EVENT_NAMES.WELLBEING_BREAK_IDLE_CODE_FETCH_FAILED]);
|
|
1248
|
+
const registrationGeneration = this.wellnessRegistrationGeneration;
|
|
1249
|
+
const orgId = this.$webex.credentials.getOrgId();
|
|
1250
|
+
const idleCode = await this.services.config.getWellbeingBreakIdleCode(orgId);
|
|
1251
|
+
if (registrationGeneration !== this.wellnessRegistrationGeneration || orgId !== this.$webex.credentials.getOrgId() || !this.agentConfig?.isWellnessBreakEnabled) {
|
|
1252
|
+
const staleRegistrationError = new Error('WELLNESS_BREAK_REGISTRATION_CHANGED');
|
|
1253
|
+
staleRegistrationError.details = {
|
|
1254
|
+
type: 'SDK_VALIDATION_ERROR',
|
|
1255
|
+
orgId,
|
|
1256
|
+
trackingId: _constants.EMPTY_STRING,
|
|
1257
|
+
data: {
|
|
1258
|
+
reason: 'WELLNESS_BREAK_REGISTRATION_CHANGED'
|
|
1259
|
+
}
|
|
1260
|
+
};
|
|
1261
|
+
throw staleRegistrationError;
|
|
1262
|
+
}
|
|
1263
|
+
this.wellbeingBreakIdleCode = idleCode;
|
|
1264
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WELLBEING_BREAK_IDLE_CODE_FETCH_SUCCESS, {}, ['operational']);
|
|
1265
|
+
return idleCode;
|
|
1266
|
+
} catch (error) {
|
|
1267
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WELLBEING_BREAK_IDLE_CODE_FETCH_FAILED, {
|
|
1268
|
+
reason: error instanceof Error ? error.message : _constants.UNKNOWN_ERROR
|
|
1269
|
+
}, ['operational']);
|
|
1270
|
+
const {
|
|
1271
|
+
error: detailedError
|
|
1272
|
+
} = (0, _Utils.getErrorDetails)(error, method, _constants.CC_FILE);
|
|
1273
|
+
throw detailedError;
|
|
1274
|
+
}
|
|
1275
|
+
}
|
|
1276
|
+
|
|
1035
1277
|
/**
|
|
1036
1278
|
* Processes incoming websocket messages and emits corresponding events
|
|
1037
1279
|
* Handles various event types including agent state changes, login events,
|
|
@@ -1041,8 +1283,9 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1041
1283
|
*/
|
|
1042
1284
|
handleWebsocketMessage = event => {
|
|
1043
1285
|
const eventData = JSON.parse(event);
|
|
1044
|
-
// Re-emit all the events related to agent except keep-alives
|
|
1045
|
-
|
|
1286
|
+
// Re-emit all the events related to agent except keep-alives. Only event names present in
|
|
1287
|
+
// the typed CC_EVENTS allow-list are emitted; unknown/server-injected types are ignored.
|
|
1288
|
+
if (!eventData.keepalive && eventData.data && eventData.data.type && CC_EVENT_ALLOW_LIST.has(eventData.data.type)) {
|
|
1046
1289
|
// @ts-ignore
|
|
1047
1290
|
this.emit(eventData.data.type, eventData.data);
|
|
1048
1291
|
}
|
|
@@ -1065,8 +1308,14 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1065
1308
|
};
|
|
1066
1309
|
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WEBSOCKET_EVENT_RECEIVED, metricsPayload, ['operational']);
|
|
1067
1310
|
}
|
|
1311
|
+
if (this.handleWellnessBreakWebsocketPayload(eventData)) {
|
|
1312
|
+
return;
|
|
1313
|
+
}
|
|
1068
1314
|
switch (eventData.type) {
|
|
1069
1315
|
case _types3.CC_EVENTS.AGENT_MULTI_LOGIN:
|
|
1316
|
+
if (eventData.data?.type === 'AgentMultiLoginCloseSession' && (!eventData.data.agentSessionId || eventData.data.agentSessionId === this.currentAgentSessionId)) {
|
|
1317
|
+
this.updateWellnessSession();
|
|
1318
|
+
}
|
|
1070
1319
|
// @ts-ignore
|
|
1071
1320
|
this.emit(_types2.AGENT_EVENTS.AGENT_MULTI_LOGIN, eventData.data);
|
|
1072
1321
|
break;
|
|
@@ -1087,6 +1336,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1087
1336
|
channelsMap,
|
|
1088
1337
|
...loginData
|
|
1089
1338
|
} = eventData.data;
|
|
1339
|
+
this.updateWellnessSession(loginData.agentSessionId);
|
|
1090
1340
|
const stationLoginData = {
|
|
1091
1341
|
...loginData,
|
|
1092
1342
|
mmProfile: {
|
|
@@ -1108,6 +1358,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1108
1358
|
channelsMap,
|
|
1109
1359
|
...loginData
|
|
1110
1360
|
} = eventData.data;
|
|
1361
|
+
this.updateWellnessSession(loginData.agentSessionId);
|
|
1111
1362
|
const stationReLoginData = {
|
|
1112
1363
|
...loginData,
|
|
1113
1364
|
mmProfile: {
|
|
@@ -1120,8 +1371,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1120
1371
|
};
|
|
1121
1372
|
// @ts-ignore
|
|
1122
1373
|
this.emit(_types2.AGENT_EVENTS.AGENT_RELOGIN_SUCCESS, stationReLoginData);
|
|
1374
|
+
break;
|
|
1123
1375
|
}
|
|
1124
|
-
break;
|
|
1125
1376
|
case _types3.CC_EVENTS.AGENT_STATE_CHANGE_SUCCESS:
|
|
1126
1377
|
// @ts-ignore
|
|
1127
1378
|
this.emit(_types2.AGENT_EVENTS.AGENT_STATE_CHANGE_SUCCESS, eventData.data);
|
|
@@ -1135,6 +1386,9 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1135
1386
|
this.emit(_types2.AGENT_EVENTS.AGENT_STATION_LOGIN_FAILED, eventData.data);
|
|
1136
1387
|
break;
|
|
1137
1388
|
case _types3.CC_EVENTS.AGENT_LOGOUT_SUCCESS:
|
|
1389
|
+
if (!eventData.data.agentSessionId || eventData.data.agentSessionId === this.currentAgentSessionId) {
|
|
1390
|
+
this.updateWellnessSession();
|
|
1391
|
+
}
|
|
1138
1392
|
// @ts-ignore
|
|
1139
1393
|
this.emit(_types2.AGENT_EVENTS.AGENT_LOGOUT_SUCCESS, eventData.data);
|
|
1140
1394
|
break;
|
|
@@ -1170,6 +1424,485 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1170
1424
|
}
|
|
1171
1425
|
}
|
|
1172
1426
|
|
|
1427
|
+
/**
|
|
1428
|
+
* Whether wxApp thick-client answer is enabled for this SDK instance.
|
|
1429
|
+
* @public
|
|
1430
|
+
*/
|
|
1431
|
+
isWxBetterTogetherEnabled() {
|
|
1432
|
+
return this.$config?.enableWxBetterTogether === true;
|
|
1433
|
+
}
|
|
1434
|
+
|
|
1435
|
+
/**
|
|
1436
|
+
* Current station login option (Extension, Dial Number, or Browser/Desktop).
|
|
1437
|
+
* Prefer webCallingService — updated on every stationLogin before wxApp hooks run.
|
|
1438
|
+
* @private
|
|
1439
|
+
*/
|
|
1440
|
+
getCurrentStationLoginOption() {
|
|
1441
|
+
return this.webCallingService?.loginOption ?? this.agentConfig?.deviceType;
|
|
1442
|
+
}
|
|
1443
|
+
|
|
1444
|
+
/**
|
|
1445
|
+
* wxApp thick-client answer is supported for Extension and Dial Number station login only —
|
|
1446
|
+
* not Browser/Desktop (WebRTC) login.
|
|
1447
|
+
* @private
|
|
1448
|
+
*/
|
|
1449
|
+
assertWxAppStationLoginSupportedForEnable() {
|
|
1450
|
+
const loginOption = this.getCurrentStationLoginOption();
|
|
1451
|
+
if (loginOption !== _types.LoginOption.EXTENSION && loginOption !== _types.LoginOption.AGENT_DN) {
|
|
1452
|
+
throw new Error('setManageWebexCallingInWxcc requires EXTENSION or AGENT_DN station login. Complete station login before enabling.');
|
|
1453
|
+
}
|
|
1454
|
+
}
|
|
1455
|
+
|
|
1456
|
+
/**
|
|
1457
|
+
* Clears runtime wxApp config after logout/deregister so stale flags do not apply on relogin.
|
|
1458
|
+
* @private
|
|
1459
|
+
*/
|
|
1460
|
+
resetEnableWxBetterTogetherConfig() {
|
|
1461
|
+
if (this.$config) {
|
|
1462
|
+
this.$config.enableWxBetterTogether = false;
|
|
1463
|
+
}
|
|
1464
|
+
this.taskManager.applyEnableWxBetterTogether(false);
|
|
1465
|
+
}
|
|
1466
|
+
|
|
1467
|
+
/**
|
|
1468
|
+
* Runtime enable/disable for wxApp Better Together (toast suppression + Mercury mute sync).
|
|
1469
|
+
*
|
|
1470
|
+
* **Phase 1 (WXCC-6026 / MMT): NOT part of the public host contract.**
|
|
1471
|
+
* Hosts must set `webexConfig.cc.enableWxBetterTogether` before `webex.init()` / `cc.register()`.
|
|
1472
|
+
* To change the flag after the SDK is initialized, re-init the SDK with the updated config.
|
|
1473
|
+
*
|
|
1474
|
+
* **Supported public read API:** {@link isWxBetterTogetherEnabled}.
|
|
1475
|
+
* **Supported telephony API:** unified `task.accept()`, `task.decline()`, `task.toggleMute()`,
|
|
1476
|
+
* `task.transmitDtmf()` — SDK routes wxApp calls internally when the init flag is active.
|
|
1477
|
+
*
|
|
1478
|
+
* **Production lifecycle does not call this method.** Station login, silent relogin, logout,
|
|
1479
|
+
* and deregister use {@link ensureWxAppPostStationLogin} and {@link teardownWxAppLocalState}
|
|
1480
|
+
* (usersub publish + Mercury subscribe/unsubscribe based on the init flag).
|
|
1481
|
+
*
|
|
1482
|
+
* This setter remains as a **private implementation** for Phase 2 runtime toggle and unit tests.
|
|
1483
|
+
* It updates `$config.enableWxBetterTogether`, TaskManager flags, cross-client usersub
|
|
1484
|
+
* (`answer-calls-on-wxcc`), and Mercury mute sync; rolls back config on publish/connect failure.
|
|
1485
|
+
*
|
|
1486
|
+
* @param enabled - `true` to enable wxApp answer + usersub suppression; `false` to disable and tear down.
|
|
1487
|
+
* @throws When enabling without login, on unsupported BROWSER station login, or when usersub/Mercury init fails.
|
|
1488
|
+
* @internal
|
|
1489
|
+
* @see enableWxBetterTogether (CCPluginConfig init flag)
|
|
1490
|
+
* @see ensureWxAppPostStationLogin
|
|
1491
|
+
* @see teardownWxAppLocalState
|
|
1492
|
+
*/
|
|
1493
|
+
async setManageWebexCallingInWxcc(enabled) {
|
|
1494
|
+
if (enabled && !this.$webex.internal.device?.userId) {
|
|
1495
|
+
throw new Error('Cannot publish answer-calls-on-wxcc: user is not logged in');
|
|
1496
|
+
}
|
|
1497
|
+
if (enabled) {
|
|
1498
|
+
this.assertWxAppStationLoginSupportedForEnable();
|
|
1499
|
+
}
|
|
1500
|
+
const previousEnabled = this.isWxBetterTogetherEnabled();
|
|
1501
|
+
if (this.$config) {
|
|
1502
|
+
this.$config.enableWxBetterTogether = enabled;
|
|
1503
|
+
}
|
|
1504
|
+
this.taskManager.applyEnableWxBetterTogether(enabled);
|
|
1505
|
+
let publishedEnable = false;
|
|
1506
|
+
try {
|
|
1507
|
+
if (enabled) {
|
|
1508
|
+
await this.ensureWxAppMercuryAndSubscribe();
|
|
1509
|
+
await this.publishAnswerOnWebexCrossClientState(true);
|
|
1510
|
+
publishedEnable = true;
|
|
1511
|
+
this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
|
|
1512
|
+
this.taskManager.refreshWxAppOfferObservabilityForAllTasks();
|
|
1513
|
+
} else {
|
|
1514
|
+
await this.publishAnswerOnWebexCrossClientState(false);
|
|
1515
|
+
this.wxAppTelephonyMercurySync.unsubscribe();
|
|
1516
|
+
await this.releaseWxAppMercuryResources();
|
|
1517
|
+
}
|
|
1518
|
+
} catch (error) {
|
|
1519
|
+
if (publishedEnable) {
|
|
1520
|
+
await this.revertWxAppCrossClientPublish();
|
|
1521
|
+
} else if (enabled) {
|
|
1522
|
+
this.wxAppTelephonyMercurySync.unsubscribe();
|
|
1523
|
+
await this.releaseWxAppMercuryResources();
|
|
1524
|
+
}
|
|
1525
|
+
if (this.$config) {
|
|
1526
|
+
this.$config.enableWxBetterTogether = previousEnabled;
|
|
1527
|
+
}
|
|
1528
|
+
this.taskManager.applyEnableWxBetterTogether(previousEnabled);
|
|
1529
|
+
throw error;
|
|
1530
|
+
}
|
|
1531
|
+
}
|
|
1532
|
+
getWxAppTelephonyTaskType() {
|
|
1533
|
+
const loginOption = this.getCurrentStationLoginOption();
|
|
1534
|
+
if (loginOption === _types.LoginOption.BROWSER) {
|
|
1535
|
+
return 'WebRTC';
|
|
1536
|
+
}
|
|
1537
|
+
if (loginOption === _types.LoginOption.EXTENSION || loginOption === _types.LoginOption.AGENT_DN) {
|
|
1538
|
+
return 'Voice';
|
|
1539
|
+
}
|
|
1540
|
+
return 'unknown';
|
|
1541
|
+
}
|
|
1542
|
+
async ensureWxAppPostStationLogin() {
|
|
1543
|
+
const loginOption = this.getCurrentStationLoginOption();
|
|
1544
|
+
const flagEnabled = this.isWxBetterTogetherEnabled();
|
|
1545
|
+
const telephonyTaskType = this.getWxAppTelephonyTaskType();
|
|
1546
|
+
if (loginOption === _types.LoginOption.BROWSER) {
|
|
1547
|
+
if (flagEnabled) {
|
|
1548
|
+
(0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
|
|
1549
|
+
enableWxBetterTogether: true,
|
|
1550
|
+
loginOption,
|
|
1551
|
+
wxAppHooksApplied: false,
|
|
1552
|
+
usersubPublished: false,
|
|
1553
|
+
mercurySubscribed: false,
|
|
1554
|
+
telephonyTaskType,
|
|
1555
|
+
skipReason: 'unsupported_browser_login'
|
|
1556
|
+
});
|
|
1557
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_SKIPPED, {
|
|
1558
|
+
loginOption,
|
|
1559
|
+
enableWxBetterTogether: true,
|
|
1560
|
+
skipReason: 'unsupported_browser_login'
|
|
1561
|
+
}, ['operational', 'behavioral']);
|
|
1562
|
+
}
|
|
1563
|
+
return;
|
|
1564
|
+
}
|
|
1565
|
+
let publishedEnable = false;
|
|
1566
|
+
let wxAppInitStage = 'mercury';
|
|
1567
|
+
try {
|
|
1568
|
+
if (flagEnabled) {
|
|
1569
|
+
this.metricsManager.timeEvent([_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_SUCCESS, _constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED]);
|
|
1570
|
+
await this.ensureWxAppMercuryAndSubscribe();
|
|
1571
|
+
wxAppInitStage = 'publish';
|
|
1572
|
+
await this.publishAnswerOnWebexCrossClientState(true);
|
|
1573
|
+
publishedEnable = true;
|
|
1574
|
+
this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
|
|
1575
|
+
this.taskManager.refreshWxAppOfferObservabilityForAllTasks();
|
|
1576
|
+
const mercurySubscribed = this.wxAppTelephonyMercurySync.isSubscribed();
|
|
1577
|
+
const usersubPublished = this.webexCrossClientService.isAnswerCallsStateActive();
|
|
1578
|
+
(0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
|
|
1579
|
+
enableWxBetterTogether: true,
|
|
1580
|
+
loginOption,
|
|
1581
|
+
wxAppHooksApplied: true,
|
|
1582
|
+
usersubPublished,
|
|
1583
|
+
mercurySubscribed,
|
|
1584
|
+
telephonyTaskType
|
|
1585
|
+
});
|
|
1586
|
+
const sessionInitReady = mercurySubscribed && usersubPublished;
|
|
1587
|
+
if (sessionInitReady) {
|
|
1588
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_SUCCESS, {
|
|
1589
|
+
loginOption,
|
|
1590
|
+
enableWxBetterTogether: true,
|
|
1591
|
+
usersubPublished,
|
|
1592
|
+
mercurySubscribed,
|
|
1593
|
+
telephonyTaskType
|
|
1594
|
+
}, ['operational', 'behavioral']);
|
|
1595
|
+
} else {
|
|
1596
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED, {
|
|
1597
|
+
loginOption,
|
|
1598
|
+
enableWxBetterTogether: true,
|
|
1599
|
+
usersubPublished,
|
|
1600
|
+
mercurySubscribed,
|
|
1601
|
+
telephonyTaskType,
|
|
1602
|
+
skipReason: !usersubPublished ? 'usersub_not_published' : 'mercury_not_subscribed'
|
|
1603
|
+
}, ['operational', 'behavioral']);
|
|
1604
|
+
}
|
|
1605
|
+
} else {
|
|
1606
|
+
await this.ensureWxAppDeviceRegistered();
|
|
1607
|
+
await this.publishAnswerOnWebexCrossClientState(false, {
|
|
1608
|
+
force: true
|
|
1609
|
+
});
|
|
1610
|
+
this.webexCrossClientService.teardown();
|
|
1611
|
+
this.wxAppTelephonyMercurySync.unsubscribe();
|
|
1612
|
+
await this.releaseWxAppMercuryResources();
|
|
1613
|
+
(0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
|
|
1614
|
+
enableWxBetterTogether: false,
|
|
1615
|
+
loginOption,
|
|
1616
|
+
wxAppHooksApplied: true,
|
|
1617
|
+
usersubPublished: false,
|
|
1618
|
+
mercurySubscribed: false,
|
|
1619
|
+
telephonyTaskType,
|
|
1620
|
+
skipReason: 'flag_disabled'
|
|
1621
|
+
});
|
|
1622
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_SKIPPED, {
|
|
1623
|
+
loginOption,
|
|
1624
|
+
enableWxBetterTogether: false,
|
|
1625
|
+
skipReason: 'flag_disabled'
|
|
1626
|
+
}, ['operational', 'behavioral']);
|
|
1627
|
+
}
|
|
1628
|
+
} catch (error) {
|
|
1629
|
+
_loggerProxy.default.error(`Failed to initialize wxApp post-station-login: ${error}`, {
|
|
1630
|
+
module: _constants.CC_FILE,
|
|
1631
|
+
method: _constants.METHODS.STATION_LOGIN
|
|
1632
|
+
});
|
|
1633
|
+
if (flagEnabled) {
|
|
1634
|
+
const sessionInitFailureReason = wxAppInitStage === 'mercury' ? 'mercury_subscribe_failed' : 'publish_failed';
|
|
1635
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED, {
|
|
1636
|
+
loginOption,
|
|
1637
|
+
enableWxBetterTogether: true,
|
|
1638
|
+
usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
|
|
1639
|
+
mercurySubscribed: this.wxAppTelephonyMercurySync.isSubscribed(),
|
|
1640
|
+
telephonyTaskType,
|
|
1641
|
+
skipReason: sessionInitFailureReason,
|
|
1642
|
+
error: error instanceof Error ? error.toString() : String(error)
|
|
1643
|
+
}, ['operational', 'behavioral']);
|
|
1644
|
+
(0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
|
|
1645
|
+
enableWxBetterTogether: true,
|
|
1646
|
+
loginOption,
|
|
1647
|
+
wxAppHooksApplied: false,
|
|
1648
|
+
usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
|
|
1649
|
+
mercurySubscribed: this.wxAppTelephonyMercurySync.isSubscribed(),
|
|
1650
|
+
telephonyTaskType,
|
|
1651
|
+
skipReason: sessionInitFailureReason
|
|
1652
|
+
});
|
|
1653
|
+
if (publishedEnable) {
|
|
1654
|
+
await this.revertWxAppCrossClientPublish();
|
|
1655
|
+
} else {
|
|
1656
|
+
this.wxAppTelephonyMercurySync.unsubscribe();
|
|
1657
|
+
await this.releaseWxAppMercuryResources();
|
|
1658
|
+
}
|
|
1659
|
+
this.resetEnableWxBetterTogetherConfig();
|
|
1660
|
+
} else {
|
|
1661
|
+
this.scheduleForcedFalsePublishRetry();
|
|
1662
|
+
}
|
|
1663
|
+
}
|
|
1664
|
+
}
|
|
1665
|
+
clearWxAppFalsePublishRetryTimer() {
|
|
1666
|
+
if (this.wxAppFalsePublishRetryTimer) {
|
|
1667
|
+
clearTimeout(this.wxAppFalsePublishRetryTimer);
|
|
1668
|
+
this.wxAppFalsePublishRetryTimer = undefined;
|
|
1669
|
+
}
|
|
1670
|
+
}
|
|
1671
|
+
scheduleForcedFalsePublishRetry(retryAttempt = 0) {
|
|
1672
|
+
this.scheduleFalsePublishRetry(retryAttempt, {
|
|
1673
|
+
requireDisabled: true
|
|
1674
|
+
});
|
|
1675
|
+
}
|
|
1676
|
+
|
|
1677
|
+
/**
|
|
1678
|
+
* Retries compensating false publish after rollback failure, regardless of enabled flag.
|
|
1679
|
+
* @private
|
|
1680
|
+
*/
|
|
1681
|
+
scheduleCompensatingFalsePublishRetry(retryAttempt = 0) {
|
|
1682
|
+
this.scheduleFalsePublishRetry(retryAttempt);
|
|
1683
|
+
}
|
|
1684
|
+
scheduleFalsePublishRetry(retryAttempt = 0, options = {}) {
|
|
1685
|
+
if (retryAttempt >= ContactCenter.WXAPP_FALSE_PUBLISH_MAX_RETRIES) {
|
|
1686
|
+
return;
|
|
1687
|
+
}
|
|
1688
|
+
if (options?.requireDisabled && this.isWxBetterTogetherEnabled()) {
|
|
1689
|
+
return;
|
|
1690
|
+
}
|
|
1691
|
+
this.clearWxAppFalsePublishRetryTimer();
|
|
1692
|
+
this.wxAppFalsePublishRetryTimer = setTimeout(async () => {
|
|
1693
|
+
this.wxAppFalsePublishRetryTimer = undefined;
|
|
1694
|
+
if (options?.requireDisabled && this.isWxBetterTogetherEnabled()) {
|
|
1695
|
+
return;
|
|
1696
|
+
}
|
|
1697
|
+
if (!options?.requireDisabled && this.isWxBetterTogetherEnabled() && this.webexCrossClientService.isAnswerCallsStateActive()) {
|
|
1698
|
+
return;
|
|
1699
|
+
}
|
|
1700
|
+
try {
|
|
1701
|
+
await this.ensureWxAppDeviceRegistered();
|
|
1702
|
+
await this.publishAnswerOnWebexCrossClientState(false, {
|
|
1703
|
+
force: true
|
|
1704
|
+
});
|
|
1705
|
+
this.webexCrossClientService.teardown();
|
|
1706
|
+
this.wxAppTelephonyMercurySync.unsubscribe();
|
|
1707
|
+
await this.releaseWxAppMercuryResources();
|
|
1708
|
+
} catch (retryError) {
|
|
1709
|
+
_loggerProxy.default.error(`Failed to retry forced answer-calls-on-wxcc false publish: ${retryError}`, {
|
|
1710
|
+
module: _constants.CC_FILE,
|
|
1711
|
+
method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
|
|
1712
|
+
});
|
|
1713
|
+
this.scheduleFalsePublishRetry(retryAttempt + 1, options);
|
|
1714
|
+
}
|
|
1715
|
+
}, ContactCenter.WXAPP_FALSE_PUBLISH_RETRY_DELAY_MS);
|
|
1716
|
+
}
|
|
1717
|
+
|
|
1718
|
+
/**
|
|
1719
|
+
* Best-effort rollback when usersub true was published but wxApp setup did not complete.
|
|
1720
|
+
* @private
|
|
1721
|
+
*/
|
|
1722
|
+
async revertWxAppCrossClientPublish() {
|
|
1723
|
+
try {
|
|
1724
|
+
await this.publishAnswerOnWebexCrossClientState(false, {
|
|
1725
|
+
force: true
|
|
1726
|
+
});
|
|
1727
|
+
} catch (error) {
|
|
1728
|
+
_loggerProxy.default.error(`Failed to publish compensating answer-calls-on-wxcc false during wxApp rollback: ${error}`, {
|
|
1729
|
+
module: _constants.CC_FILE,
|
|
1730
|
+
method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
|
|
1731
|
+
});
|
|
1732
|
+
this.scheduleCompensatingFalsePublishRetry();
|
|
1733
|
+
}
|
|
1734
|
+
this.webexCrossClientService.teardown();
|
|
1735
|
+
this.wxAppTelephonyMercurySync.unsubscribe();
|
|
1736
|
+
await this.releaseWxAppMercuryResources();
|
|
1737
|
+
}
|
|
1738
|
+
async ensureWxAppDeviceRegistered() {
|
|
1739
|
+
const device = this.$webex.internal.device;
|
|
1740
|
+
if (device && !device.registered && device.register) {
|
|
1741
|
+
await device.register();
|
|
1742
|
+
this.wxAppDeviceRegisteredByCc = true;
|
|
1743
|
+
_loggerProxy.default.log('WxApp: device registered for cross-client publish', {
|
|
1744
|
+
module: _constants.CC_FILE,
|
|
1745
|
+
method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
|
|
1746
|
+
});
|
|
1747
|
+
}
|
|
1748
|
+
}
|
|
1749
|
+
async ensureWxAppMercuryConnected() {
|
|
1750
|
+
const mercury = this.$webex.internal.mercury;
|
|
1751
|
+
await this.ensureWxAppDeviceRegistered();
|
|
1752
|
+
if (mercury && !mercury.connected) {
|
|
1753
|
+
await mercury.connect();
|
|
1754
|
+
this.wxAppMercuryConnectedByCc = true;
|
|
1755
|
+
_loggerProxy.default.log('WxApp mute sync: mercury connected', {
|
|
1756
|
+
module: _constants.CC_FILE,
|
|
1757
|
+
method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
|
|
1758
|
+
});
|
|
1759
|
+
}
|
|
1760
|
+
}
|
|
1761
|
+
|
|
1762
|
+
/**
|
|
1763
|
+
* Disconnects Mercury and unregisters the device when wxApp mute sync opened them.
|
|
1764
|
+
* @private
|
|
1765
|
+
*/
|
|
1766
|
+
async releaseWxAppMercuryResources() {
|
|
1767
|
+
const mercury = this.$webex.internal.mercury;
|
|
1768
|
+
const device = this.$webex.internal.device;
|
|
1769
|
+
if (this.wxAppMercuryConnectedByCc && mercury?.connected) {
|
|
1770
|
+
try {
|
|
1771
|
+
await mercury.disconnect();
|
|
1772
|
+
this.wxAppMercuryConnectedByCc = false;
|
|
1773
|
+
_loggerProxy.default.log('WxApp mute sync: mercury disconnected', {
|
|
1774
|
+
module: _constants.CC_FILE,
|
|
1775
|
+
method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
|
|
1776
|
+
});
|
|
1777
|
+
} catch (error) {
|
|
1778
|
+
_loggerProxy.default.error(`Failed to disconnect wxApp Mercury: ${error}`, {
|
|
1779
|
+
module: _constants.CC_FILE,
|
|
1780
|
+
method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
|
|
1781
|
+
});
|
|
1782
|
+
}
|
|
1783
|
+
}
|
|
1784
|
+
if (this.wxAppDeviceRegisteredByCc && device?.registered && device.unregister) {
|
|
1785
|
+
try {
|
|
1786
|
+
// @ts-ignore
|
|
1787
|
+
await device.unregister();
|
|
1788
|
+
this.wxAppDeviceRegisteredByCc = false;
|
|
1789
|
+
_loggerProxy.default.log('WxApp mute sync: device unregistered', {
|
|
1790
|
+
module: _constants.CC_FILE,
|
|
1791
|
+
method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
|
|
1792
|
+
});
|
|
1793
|
+
} catch (error) {
|
|
1794
|
+
_loggerProxy.default.error(`Failed to unregister wxApp device: ${error}`, {
|
|
1795
|
+
module: _constants.CC_FILE,
|
|
1796
|
+
method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
|
|
1797
|
+
});
|
|
1798
|
+
}
|
|
1799
|
+
} else if (this.wxAppDeviceRegisteredByCc) {
|
|
1800
|
+
this.wxAppDeviceRegisteredByCc = false;
|
|
1801
|
+
}
|
|
1802
|
+
}
|
|
1803
|
+
|
|
1804
|
+
/**
|
|
1805
|
+
* Clears wxApp runtime state and feature-owned resources. Publish failures are logged;
|
|
1806
|
+
* optional rethrow for deregister when callers need to surface usersub errors.
|
|
1807
|
+
* @private
|
|
1808
|
+
*/
|
|
1809
|
+
async teardownWxAppLocalState(options) {
|
|
1810
|
+
this.clearWxAppFalsePublishRetryTimer();
|
|
1811
|
+
let publishError;
|
|
1812
|
+
try {
|
|
1813
|
+
const shouldForceFalsePublish = this.isWxBetterTogetherEnabled() || this.webexCrossClientService.isAnswerCallsStateActive();
|
|
1814
|
+
await this.publishAnswerOnWebexCrossClientState(false, {
|
|
1815
|
+
force: shouldForceFalsePublish
|
|
1816
|
+
});
|
|
1817
|
+
} catch (error) {
|
|
1818
|
+
publishError = error;
|
|
1819
|
+
_loggerProxy.default.error(`Failed to publish answer-calls-on-wxcc false during wxApp teardown: ${error}`, {
|
|
1820
|
+
module: _constants.CC_FILE,
|
|
1821
|
+
method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
|
|
1822
|
+
});
|
|
1823
|
+
}
|
|
1824
|
+
this.webexCrossClientService.teardown();
|
|
1825
|
+
this.wxAppTelephonyMercurySync.unsubscribe();
|
|
1826
|
+
await this.releaseWxAppMercuryResources();
|
|
1827
|
+
if (options?.clearInitFlag) {
|
|
1828
|
+
this.resetEnableWxBetterTogetherConfig();
|
|
1829
|
+
}
|
|
1830
|
+
if (publishError) {
|
|
1831
|
+
this.scheduleCompensatingFalsePublishRetry();
|
|
1832
|
+
}
|
|
1833
|
+
if (options?.rethrowPublishError && publishError) {
|
|
1834
|
+
throw publishError;
|
|
1835
|
+
}
|
|
1836
|
+
return {
|
|
1837
|
+
publishError: publishError ?? undefined
|
|
1838
|
+
};
|
|
1839
|
+
}
|
|
1840
|
+
async ensureWxAppMercuryAndSubscribe() {
|
|
1841
|
+
if (!this.isWxBetterTogetherEnabled()) {
|
|
1842
|
+
return;
|
|
1843
|
+
}
|
|
1844
|
+
if (this.getCurrentStationLoginOption() === _types.LoginOption.BROWSER) {
|
|
1845
|
+
return;
|
|
1846
|
+
}
|
|
1847
|
+
const agentId = this.agentConfig?.agentId;
|
|
1848
|
+
if (!agentId) {
|
|
1849
|
+
_loggerProxy.default.error('Cannot subscribe wxApp mute sync: agentId unavailable', {
|
|
1850
|
+
module: _constants.CC_FILE,
|
|
1851
|
+
method: _constants.METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY
|
|
1852
|
+
});
|
|
1853
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED, {
|
|
1854
|
+
error: 'agentId unavailable',
|
|
1855
|
+
mercurySubscribed: false
|
|
1856
|
+
}, ['operational', 'behavioral']);
|
|
1857
|
+
return;
|
|
1858
|
+
}
|
|
1859
|
+
try {
|
|
1860
|
+
await this.ensureWxAppMercuryConnected();
|
|
1861
|
+
this.wxAppTelephonyMercurySync.subscribe(agentId, (callId, muted) => {
|
|
1862
|
+
this.taskManager.applyWxAppMuteStateFromSync(callId, muted);
|
|
1863
|
+
});
|
|
1864
|
+
} catch (error) {
|
|
1865
|
+
_loggerProxy.default.error(`Failed to ensure wxApp Mercury mute sync: ${error}`, {
|
|
1866
|
+
module: _constants.CC_FILE,
|
|
1867
|
+
method: _constants.METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY
|
|
1868
|
+
});
|
|
1869
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED, {
|
|
1870
|
+
error: error instanceof Error ? error.toString() : String(error),
|
|
1871
|
+
mercurySubscribed: false
|
|
1872
|
+
}, ['operational', 'behavioral']);
|
|
1873
|
+
this.wxAppTelephonyMercurySync.unsubscribe();
|
|
1874
|
+
await this.releaseWxAppMercuryResources();
|
|
1875
|
+
throw error;
|
|
1876
|
+
}
|
|
1877
|
+
}
|
|
1878
|
+
async publishAnswerOnWebexCrossClientState(enable, options) {
|
|
1879
|
+
if (enable && !this.isWxBetterTogetherEnabled()) {
|
|
1880
|
+
return;
|
|
1881
|
+
}
|
|
1882
|
+
if (!enable && !options?.force && !this.webexCrossClientService.isAnswerCallsStateActive()) {
|
|
1883
|
+
return;
|
|
1884
|
+
}
|
|
1885
|
+
const userId = this.$webex.internal.device?.userId;
|
|
1886
|
+
if (!userId) {
|
|
1887
|
+
if (enable && this.isWxBetterTogetherEnabled()) {
|
|
1888
|
+
this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_USERSUB_PUBLISH_FAILED, {
|
|
1889
|
+
enableWxBetterTogether: true,
|
|
1890
|
+
usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
|
|
1891
|
+
skipReason: 'user_id_unavailable',
|
|
1892
|
+
error: 'User ID is unavailable for cross-client publish'
|
|
1893
|
+
}, ['operational', 'behavioral']);
|
|
1894
|
+
}
|
|
1895
|
+
return;
|
|
1896
|
+
}
|
|
1897
|
+
await this.webexCrossClientService.setManageWebexCallingInWxcc(enable, {
|
|
1898
|
+
userId,
|
|
1899
|
+
trackPublishMetrics: true
|
|
1900
|
+
});
|
|
1901
|
+
if (enable) {
|
|
1902
|
+
this.clearWxAppFalsePublishRetryTimer();
|
|
1903
|
+
}
|
|
1904
|
+
}
|
|
1905
|
+
|
|
1173
1906
|
/**
|
|
1174
1907
|
* Initializes event listeners for the Contact Center service
|
|
1175
1908
|
* Sets up handlers for connection state changes and other core events
|
|
@@ -1228,6 +1961,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1228
1961
|
});
|
|
1229
1962
|
try {
|
|
1230
1963
|
const reLoginResponse = await this.services.agent.reload();
|
|
1964
|
+
this.updateWellnessSession(reLoginResponse.data.agentSessionId);
|
|
1231
1965
|
const {
|
|
1232
1966
|
agentId,
|
|
1233
1967
|
lastStateChangeReason,
|
|
@@ -1268,6 +2002,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1268
2002
|
}
|
|
1269
2003
|
this.agentConfig.lastStateAuxCodeId = auxCodeId;
|
|
1270
2004
|
this.agentConfig.isAgentLoggedIn = true;
|
|
2005
|
+
await this.ensureWxAppPostStationLogin();
|
|
1271
2006
|
_loggerProxy.default.log(`Silent relogin process completed successfully with login Option: ${reLoginResponse.data.deviceType} teamId: ${reLoginResponse.data.teamId}`, {
|
|
1272
2007
|
module: _constants.CC_FILE,
|
|
1273
2008
|
method: _constants.METHODS.SILENT_RELOGIN,
|
|
@@ -1884,8 +2619,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1884
2619
|
}
|
|
1885
2620
|
|
|
1886
2621
|
/**
|
|
1887
|
-
* Returns paginated entry points
|
|
1888
|
-
*
|
|
2622
|
+
* Returns paginated entry points using the EntryPoint service defaults.
|
|
2623
|
+
* Existing request parameters can override those defaults.
|
|
1889
2624
|
* @public
|
|
1890
2625
|
*/
|
|
1891
2626
|
async getEntryPoints(params = {}) {
|
|
@@ -1893,8 +2628,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
|
|
|
1893
2628
|
}
|
|
1894
2629
|
|
|
1895
2630
|
/**
|
|
1896
|
-
* Returns paginated contact service queues
|
|
1897
|
-
*
|
|
2631
|
+
* Returns paginated contact service queues using the Queue service defaults.
|
|
2632
|
+
* Existing request parameters can override those defaults.
|
|
1898
2633
|
* @public
|
|
1899
2634
|
*/
|
|
1900
2635
|
async getQueues(params = {}) {
|