@webex/contact-center 3.12.0-webex-services-ready.4 → 3.13.0-next.1
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 +21 -3
- package/ai-docs/SECURITY.md +1 -1
- package/ai-docs/SERVICE_STATE.md +4 -0
- package/ai-docs/contact-center-spec.md +53 -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 +816 -26
- package/dist/cc.js.map +1 -1
- package/dist/config.js +7 -0
- package/dist/config.js.map +1 -1
- package/dist/constants.js +29 -2
- package/dist/constants.js.map +1 -1
- package/dist/index.js +66 -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 +287 -37
- 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 +55 -35
- 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 +127 -9
- package/dist/types/config.d.ts +7 -0
- package/dist/types/constants.d.ts +23 -0
- package/dist/types/index.d.ts +38 -17
- 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 +150 -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 +125 -13
- package/dist/types/utils/PageCache.d.ts +20 -3
- package/dist/types.js +90 -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 +1047 -48
- package/src/config.ts +7 -0
- package/src/constants.ts +36 -0
- package/src/index.ts +49 -11
- 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 +362 -40
- 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 +11 -11
- 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 +145 -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 +159 -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 +3595 -120
- package/test/unit/spec/index.ts +891 -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 +483 -54
- 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
|
@@ -313,6 +313,104 @@ const eventTaxonomyMap: Record<string, BehavioralEventTaxonomy> = {
|
|
|
313
313
|
target: 'task_outdial',
|
|
314
314
|
verb: 'fail',
|
|
315
315
|
},
|
|
316
|
+
[METRIC_EVENT_NAMES.WXAPP_TASK_MUTE_SUCCESS]: {
|
|
317
|
+
product,
|
|
318
|
+
agent: 'user',
|
|
319
|
+
target: 'task_mute_webex_together',
|
|
320
|
+
verb: 'complete',
|
|
321
|
+
},
|
|
322
|
+
[METRIC_EVENT_NAMES.WXAPP_TASK_MUTE_FAILED]: {
|
|
323
|
+
product,
|
|
324
|
+
agent: 'user',
|
|
325
|
+
target: 'task_mute_webex_together',
|
|
326
|
+
verb: 'fail',
|
|
327
|
+
},
|
|
328
|
+
[METRIC_EVENT_NAMES.WXAPP_TASK_DTMF_SUCCESS]: {
|
|
329
|
+
product,
|
|
330
|
+
agent: 'user',
|
|
331
|
+
target: 'task_dtmf_webex_together',
|
|
332
|
+
verb: 'complete',
|
|
333
|
+
},
|
|
334
|
+
[METRIC_EVENT_NAMES.WXAPP_TASK_DTMF_FAILED]: {
|
|
335
|
+
product,
|
|
336
|
+
agent: 'user',
|
|
337
|
+
target: 'task_dtmf_webex_together',
|
|
338
|
+
verb: 'fail',
|
|
339
|
+
},
|
|
340
|
+
|
|
341
|
+
// Webex Together (wxApp)
|
|
342
|
+
[METRIC_EVENT_NAMES.WXAPP_TASK_ACCEPT_SUCCESS]: {
|
|
343
|
+
product,
|
|
344
|
+
agent: 'user',
|
|
345
|
+
target: 'task_accept_webex_together',
|
|
346
|
+
verb: 'complete',
|
|
347
|
+
},
|
|
348
|
+
[METRIC_EVENT_NAMES.WXAPP_TASK_ACCEPT_FAILED]: {
|
|
349
|
+
product,
|
|
350
|
+
agent: 'user',
|
|
351
|
+
target: 'task_accept_webex_together',
|
|
352
|
+
verb: 'fail',
|
|
353
|
+
},
|
|
354
|
+
[METRIC_EVENT_NAMES.WXAPP_TASK_DECLINE_SUCCESS]: {
|
|
355
|
+
product,
|
|
356
|
+
agent: 'user',
|
|
357
|
+
target: 'task_reject_webex_together',
|
|
358
|
+
verb: 'complete',
|
|
359
|
+
},
|
|
360
|
+
[METRIC_EVENT_NAMES.WXAPP_TASK_DECLINE_FAILED]: {
|
|
361
|
+
product,
|
|
362
|
+
agent: 'user',
|
|
363
|
+
target: 'task_reject_webex_together',
|
|
364
|
+
verb: 'fail',
|
|
365
|
+
},
|
|
366
|
+
[METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_SUCCESS]: {
|
|
367
|
+
product,
|
|
368
|
+
agent: 'user',
|
|
369
|
+
target: 'webex_together_session_init',
|
|
370
|
+
verb: 'complete',
|
|
371
|
+
},
|
|
372
|
+
[METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED]: {
|
|
373
|
+
product,
|
|
374
|
+
agent: 'user',
|
|
375
|
+
target: 'webex_together_session_init',
|
|
376
|
+
verb: 'fail',
|
|
377
|
+
},
|
|
378
|
+
[METRIC_EVENT_NAMES.WXAPP_SESSION_SKIPPED]: {
|
|
379
|
+
product,
|
|
380
|
+
agent: 'user',
|
|
381
|
+
target: 'webex_together_session_init',
|
|
382
|
+
verb: 'ignore',
|
|
383
|
+
},
|
|
384
|
+
[METRIC_EVENT_NAMES.WXAPP_USERSUB_PUBLISH_SUCCESS]: {
|
|
385
|
+
product,
|
|
386
|
+
agent: 'user',
|
|
387
|
+
target: 'webex_together_usersub_publish',
|
|
388
|
+
verb: 'complete',
|
|
389
|
+
},
|
|
390
|
+
[METRIC_EVENT_NAMES.WXAPP_USERSUB_PUBLISH_FAILED]: {
|
|
391
|
+
product,
|
|
392
|
+
agent: 'user',
|
|
393
|
+
target: 'webex_together_usersub_publish',
|
|
394
|
+
verb: 'fail',
|
|
395
|
+
},
|
|
396
|
+
[METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_SUCCESS]: {
|
|
397
|
+
product,
|
|
398
|
+
agent: 'user',
|
|
399
|
+
target: 'webex_together_mercury_subscribe',
|
|
400
|
+
verb: 'complete',
|
|
401
|
+
},
|
|
402
|
+
[METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED]: {
|
|
403
|
+
product,
|
|
404
|
+
agent: 'user',
|
|
405
|
+
target: 'webex_together_mercury_subscribe',
|
|
406
|
+
verb: 'fail',
|
|
407
|
+
},
|
|
408
|
+
[METRIC_EVENT_NAMES.WXAPP_OFFER_PARTICIPANT_FIELDS_MISSING]: {
|
|
409
|
+
product,
|
|
410
|
+
agent: 'user',
|
|
411
|
+
target: 'webex_together_offer_participant_fields',
|
|
412
|
+
verb: 'fail',
|
|
413
|
+
},
|
|
316
414
|
|
|
317
415
|
// Conference Tasks
|
|
318
416
|
[METRIC_EVENT_NAMES.TASK_CONFERENCE_START_SUCCESS]: {
|
|
@@ -366,6 +464,20 @@ const eventTaxonomyMap: Record<string, BehavioralEventTaxonomy> = {
|
|
|
366
464
|
verb: 'fail',
|
|
367
465
|
},
|
|
368
466
|
|
|
467
|
+
// Conference Participant Drop
|
|
468
|
+
[METRIC_EVENT_NAMES.TASK_CONFERENCE_PARTICIPANT_DROP_SUCCESS]: {
|
|
469
|
+
product,
|
|
470
|
+
agent: 'user',
|
|
471
|
+
target: 'task_conference_participant_drop',
|
|
472
|
+
verb: 'complete',
|
|
473
|
+
},
|
|
474
|
+
[METRIC_EVENT_NAMES.TASK_CONFERENCE_PARTICIPANT_DROP_FAILED]: {
|
|
475
|
+
product,
|
|
476
|
+
agent: 'user',
|
|
477
|
+
target: 'task_conference_participant_drop',
|
|
478
|
+
verb: 'fail',
|
|
479
|
+
},
|
|
480
|
+
|
|
369
481
|
// Switch Call
|
|
370
482
|
[METRIC_EVENT_NAMES.TASK_SWITCH_CALL_SUCCESS]: {
|
|
371
483
|
product,
|
package/src/metrics/constants.ts
CHANGED
|
@@ -131,12 +131,33 @@ export const METRIC_EVENT_NAMES = {
|
|
|
131
131
|
TASK_CONFERENCE_TRANSFER_FAILED: 'Task Conference Transfer Failed',
|
|
132
132
|
TASK_CONFERENCE_EXIT_SUCCESS: 'Task Conference Exit Success',
|
|
133
133
|
TASK_CONFERENCE_EXIT_FAILED: 'Task Conference Exit Failed',
|
|
134
|
+
TASK_CONFERENCE_PARTICIPANT_DROP_SUCCESS: 'Task Conference Participant Drop Success',
|
|
135
|
+
TASK_CONFERENCE_PARTICIPANT_DROP_FAILED: 'Task Conference Participant Drop Failed',
|
|
134
136
|
TASK_SWITCH_CALL_SUCCESS: 'Task Switch Call Success',
|
|
135
137
|
TASK_SWITCH_CALL_FAILED: 'Task Switch Call Failed',
|
|
136
138
|
|
|
137
139
|
TASK_OUTDIAL_SUCCESS: 'Task Outdial Success',
|
|
138
140
|
TASK_OUTDIAL_FAILED: 'Task Outdial Failed',
|
|
139
141
|
|
|
142
|
+
WXAPP_TASK_MUTE_SUCCESS: 'WxApp Task Mute Success',
|
|
143
|
+
WXAPP_TASK_MUTE_FAILED: 'WxApp Task Mute Failed',
|
|
144
|
+
WXAPP_TASK_DTMF_SUCCESS: 'WxApp Task Dtmf Success',
|
|
145
|
+
WXAPP_TASK_DTMF_FAILED: 'WxApp Task Dtmf Failed',
|
|
146
|
+
|
|
147
|
+
// WxApp Better Together
|
|
148
|
+
WXAPP_TASK_ACCEPT_SUCCESS: 'WxApp Task Accept Success',
|
|
149
|
+
WXAPP_TASK_ACCEPT_FAILED: 'WxApp Task Accept Failed',
|
|
150
|
+
WXAPP_TASK_DECLINE_SUCCESS: 'WxApp Task Decline Success',
|
|
151
|
+
WXAPP_TASK_DECLINE_FAILED: 'WxApp Task Decline Failed',
|
|
152
|
+
WXAPP_SESSION_INIT_SUCCESS: 'WxApp Session Init Success',
|
|
153
|
+
WXAPP_SESSION_INIT_FAILED: 'WxApp Session Init Failed',
|
|
154
|
+
WXAPP_SESSION_SKIPPED: 'WxApp Session Skipped',
|
|
155
|
+
WXAPP_USERSUB_PUBLISH_SUCCESS: 'WxApp Usersub Publish Success',
|
|
156
|
+
WXAPP_USERSUB_PUBLISH_FAILED: 'WxApp Usersub Publish Failed',
|
|
157
|
+
WXAPP_MERCURY_SUBSCRIBE_SUCCESS: 'WxApp Mercury Subscribe Success',
|
|
158
|
+
WXAPP_MERCURY_SUBSCRIBE_FAILED: 'WxApp Mercury Subscribe Failed',
|
|
159
|
+
WXAPP_OFFER_PARTICIPANT_FIELDS_MISSING: 'WxApp Offer Participant Fields Missing',
|
|
160
|
+
|
|
140
161
|
UPLOAD_LOGS_SUCCESS: 'Upload Logs Success',
|
|
141
162
|
UPLOAD_LOGS_FAILED: 'Upload Logs Failed',
|
|
142
163
|
WEBSOCKET_DEREGISTER_SUCCESS: 'Websocket Deregister Success',
|
|
@@ -183,6 +204,21 @@ export const METRIC_EVENT_NAMES = {
|
|
|
183
204
|
AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_SUCCESS:
|
|
184
205
|
'AI Assistant Fetch Historic Transcripts Success',
|
|
185
206
|
AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_FAILED: 'AI Assistant Fetch Historic Transcripts Failed',
|
|
207
|
+
AI_ASSISTANT_WELLNESS_ACTION_ACCEPTED: 'AI Assistant Wellness Action Accepted',
|
|
208
|
+
AI_ASSISTANT_WELLNESS_ACTION_FAILED: 'AI Assistant Wellness Action Failed',
|
|
209
|
+
AI_ASSISTANT_WELLNESS_EVENT_INVALID: 'AI Assistant Wellness Event Invalid',
|
|
210
|
+
WELLBEING_BREAK_IDLE_CODE_FETCH_SUCCESS: 'Wellbeing Break Idle Code Fetch Success',
|
|
211
|
+
WELLBEING_BREAK_IDLE_CODE_FETCH_FAILED: 'Wellbeing Break Idle Code Fetch Failed',
|
|
212
|
+
|
|
213
|
+
// AI summary events
|
|
214
|
+
AI_SUMMARY_GET_POST_CALL_SUCCESS: 'Post Call Summary Get Success',
|
|
215
|
+
AI_SUMMARY_GET_POST_CALL_FAILED: 'Post Call Summary Get Failed',
|
|
216
|
+
AI_SUMMARY_GET_MID_CALL_SUCCESS: 'Mid Call Summary Get Success',
|
|
217
|
+
AI_SUMMARY_GET_MID_CALL_FAILED: 'Mid Call Summary Get Failed',
|
|
218
|
+
AI_SUMMARY_POST_CALL_RESPONSE_SUCCESS: 'Post Call Summary Response Success',
|
|
219
|
+
AI_SUMMARY_POST_CALL_RESPONSE_FAILED: 'Post Call Summary Response Failed',
|
|
220
|
+
AI_SUMMARY_MID_CALL_RESPONSE_SUCCESS: 'Mid Call Summary Response Success',
|
|
221
|
+
AI_SUMMARY_MID_CALL_RESPONSE_FAILED: 'Mid Call Summary Response Failed',
|
|
186
222
|
|
|
187
223
|
// User Preference API Events
|
|
188
224
|
USER_PREFERENCE_GET_SUCCESS: 'User Preference Get Success',
|
|
@@ -74,7 +74,8 @@ export class AddressBook {
|
|
|
74
74
|
|
|
75
75
|
/**
|
|
76
76
|
* Fetches address book entries for a specific address book using the entry API
|
|
77
|
-
* @param {AddressBookEntrySearchParams} [params] - Search and
|
|
77
|
+
* @param {AddressBookEntrySearchParams} [params] - Search, pagination, and optional sort parameters
|
|
78
|
+
* including addressBookId. Sorting defaults to name ascending.
|
|
78
79
|
* @returns {Promise<AddressBookEntriesResponse>} Promise resolving to address book entries
|
|
79
80
|
* @throws {Error} If the API call fails
|
|
80
81
|
* @public
|
|
@@ -102,12 +103,21 @@ export class AddressBook {
|
|
|
102
103
|
search,
|
|
103
104
|
filter,
|
|
104
105
|
attributes,
|
|
106
|
+
sortBy = 'name',
|
|
107
|
+
sortOrder = 'asc',
|
|
105
108
|
} = params;
|
|
106
109
|
|
|
107
110
|
// Use provided addressBookId or fall back to agent's address book
|
|
108
111
|
const bookId = addressBookId || this.getAddressBookId();
|
|
109
112
|
const orgId = this.webex.credentials.getOrgId();
|
|
110
|
-
const
|
|
113
|
+
const hasCustomSort = sortBy !== 'name' || sortOrder !== 'asc';
|
|
114
|
+
const isSearchRequest = !!(search || filter || attributes || hasCustomSort);
|
|
115
|
+
const canUseCache = this.pageCache.canUseCache({
|
|
116
|
+
search,
|
|
117
|
+
filter,
|
|
118
|
+
attributes,
|
|
119
|
+
sortBy: hasCustomSort ? sortBy : undefined,
|
|
120
|
+
});
|
|
111
121
|
|
|
112
122
|
LoggerProxy.info('Fetching address book entries', {
|
|
113
123
|
module: 'AddressBook',
|
|
@@ -121,8 +131,8 @@ export class AddressBook {
|
|
|
121
131
|
},
|
|
122
132
|
});
|
|
123
133
|
|
|
124
|
-
//
|
|
125
|
-
if (
|
|
134
|
+
// Default name-ascending pagination is cache-compatible; result-changing overrides are not.
|
|
135
|
+
if (canUseCache) {
|
|
126
136
|
const cacheKey = this.pageCache.buildCacheKey(bookId, page, pageSize);
|
|
127
137
|
const cachedPage = this.pageCache.getCachedPage(cacheKey);
|
|
128
138
|
|
|
@@ -190,6 +200,7 @@ export class AddressBook {
|
|
|
190
200
|
if (filter) queryParams.append('filter', filter);
|
|
191
201
|
if (attributes) queryParams.append('attributes', attributes);
|
|
192
202
|
if (search) queryParams.append('search', search);
|
|
203
|
+
if (sortBy) queryParams.append('sort', `${sortBy},${sortOrder.toUpperCase()}`);
|
|
193
204
|
|
|
194
205
|
const resource = endPointMap.addressBookEntries(orgId, bookId, queryParams.toString());
|
|
195
206
|
|
|
@@ -244,8 +255,8 @@ export class AddressBook {
|
|
|
244
255
|
);
|
|
245
256
|
}
|
|
246
257
|
|
|
247
|
-
// Cache the
|
|
248
|
-
if (
|
|
258
|
+
// Cache only the invariant default-order pagination shape.
|
|
259
|
+
if (canUseCache && response.body?.data) {
|
|
249
260
|
const cacheKey = this.pageCache.buildCacheKey(bookId, page, pageSize);
|
|
250
261
|
this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);
|
|
251
262
|
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import LoggerProxy from '../logger-proxy';
|
|
2
|
+
import {CC_FILE, METHODS} from '../constants';
|
|
3
|
+
import {HTTP_METHODS, IHttpResponse, WebexSDK} from '../types';
|
|
4
|
+
import {getErrorDetails} from './core/Utils';
|
|
5
|
+
import {isWxAppCallNotFoundError} from './wxAppTelephonyUtils';
|
|
6
|
+
|
|
7
|
+
const ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';
|
|
8
|
+
|
|
9
|
+
export type WxAppTelephonyError = Error & {
|
|
10
|
+
isWxAppTelephonyError: true;
|
|
11
|
+
trackingId?: string;
|
|
12
|
+
status?: number | string;
|
|
13
|
+
};
|
|
14
|
+
|
|
15
|
+
const extractWxAppTrackingId = (source: unknown): string | undefined => {
|
|
16
|
+
const sourceObj = source as {details?: {trackingId?: string}; trackingId?: string};
|
|
17
|
+
|
|
18
|
+
return sourceObj?.details?.trackingId || sourceObj?.trackingId;
|
|
19
|
+
};
|
|
20
|
+
|
|
21
|
+
const extractWxAppHttpStatus = (source: unknown): number | string | undefined => {
|
|
22
|
+
const obj = source as {
|
|
23
|
+
statusCode?: number;
|
|
24
|
+
status?: number | string;
|
|
25
|
+
details?: {status?: number | string};
|
|
26
|
+
};
|
|
27
|
+
|
|
28
|
+
return obj?.statusCode ?? obj?.status ?? obj?.details?.status;
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
const markWxAppTelephonyError = (error: Error, source: unknown): WxAppTelephonyError => {
|
|
32
|
+
const marked = error as WxAppTelephonyError;
|
|
33
|
+
marked.isWxAppTelephonyError = true;
|
|
34
|
+
const trackingId = extractWxAppTrackingId(source);
|
|
35
|
+
if (trackingId) {
|
|
36
|
+
marked.trackingId = trackingId;
|
|
37
|
+
}
|
|
38
|
+
const status = extractWxAppHttpStatus(source);
|
|
39
|
+
if (status !== undefined) {
|
|
40
|
+
marked.status = status;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
return marked;
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
export type AnswerCallParams = {
|
|
47
|
+
callId: string;
|
|
48
|
+
endpointId: string;
|
|
49
|
+
lineOwnerId?: string;
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
export type CallIdParams = {
|
|
53
|
+
callId: string;
|
|
54
|
+
lineOwnerId?: string;
|
|
55
|
+
};
|
|
56
|
+
|
|
57
|
+
export type TransmitDtmfParams = CallIdParams & {
|
|
58
|
+
dtmf: string;
|
|
59
|
+
};
|
|
60
|
+
|
|
61
|
+
export type CallDetailsResponse = {
|
|
62
|
+
muted?: boolean;
|
|
63
|
+
};
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* REST telephony client for wxApp thick-client answer (WXCC-6026).
|
|
67
|
+
* Separate from WebCallingService (WebRTC/Mobius).
|
|
68
|
+
*/
|
|
69
|
+
export default class AnswerCallOnWebexService {
|
|
70
|
+
private webex: WebexSDK;
|
|
71
|
+
|
|
72
|
+
constructor(webex: WebexSDK) {
|
|
73
|
+
this.webex = webex;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
private getTelephonyBaseUrl(): string {
|
|
77
|
+
const services = this.webex.internal.services;
|
|
78
|
+
const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');
|
|
79
|
+
|
|
80
|
+
if (!hydraUrl) {
|
|
81
|
+
throw new Error('Telephony base URL is unavailable');
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
return `${hydraUrl.replace(/\/$/, '')}/telephony/calls`;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
private extractTrackingId(source: unknown): string | undefined {
|
|
88
|
+
return extractWxAppTrackingId(source);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
private async telephonyRequest(
|
|
92
|
+
resource: string,
|
|
93
|
+
method: HTTP_METHODS,
|
|
94
|
+
body: Record<string, unknown>,
|
|
95
|
+
logMethod: string
|
|
96
|
+
): Promise<IHttpResponse> {
|
|
97
|
+
try {
|
|
98
|
+
const uri = `${this.getTelephonyBaseUrl()}${resource}`;
|
|
99
|
+
|
|
100
|
+
LoggerProxy.log(`AnswerCallOnWebexService.${logMethod} request`, {
|
|
101
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
102
|
+
method: logMethod,
|
|
103
|
+
data: {uri, bodyKeys: Object.keys(body)},
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
const response = (await this.webex.request({
|
|
107
|
+
uri,
|
|
108
|
+
method,
|
|
109
|
+
body,
|
|
110
|
+
addAuthHeader: true,
|
|
111
|
+
})) as IHttpResponse;
|
|
112
|
+
|
|
113
|
+
LoggerProxy.log(`AnswerCallOnWebexService.${logMethod} success`, {
|
|
114
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
115
|
+
method: logMethod,
|
|
116
|
+
data: {statusCode: response.statusCode},
|
|
117
|
+
});
|
|
118
|
+
|
|
119
|
+
return response;
|
|
120
|
+
} catch (error) {
|
|
121
|
+
const trackingId = this.extractTrackingId(error);
|
|
122
|
+
LoggerProxy.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {
|
|
123
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
124
|
+
method: logMethod,
|
|
125
|
+
data: {
|
|
126
|
+
trackingId,
|
|
127
|
+
status: extractWxAppHttpStatus(error),
|
|
128
|
+
},
|
|
129
|
+
});
|
|
130
|
+
const {error: detailedError} = getErrorDetails(error, logMethod, CC_FILE);
|
|
131
|
+
throw markWxAppTelephonyError(detailedError, error);
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
public answerCall(params: AnswerCallParams): Promise<IHttpResponse> {
|
|
136
|
+
const {callId, endpointId, lineOwnerId} = params;
|
|
137
|
+
|
|
138
|
+
return this.telephonyRequest(
|
|
139
|
+
'/answer',
|
|
140
|
+
HTTP_METHODS.POST,
|
|
141
|
+
{
|
|
142
|
+
callId,
|
|
143
|
+
endpointId,
|
|
144
|
+
...(lineOwnerId ? {lineOwnerId} : {}),
|
|
145
|
+
},
|
|
146
|
+
METHODS.ACCEPT
|
|
147
|
+
);
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
public rejectCall(params: CallIdParams): Promise<IHttpResponse> {
|
|
151
|
+
const {callId, lineOwnerId} = params;
|
|
152
|
+
|
|
153
|
+
return this.telephonyRequest(
|
|
154
|
+
'/reject',
|
|
155
|
+
HTTP_METHODS.POST,
|
|
156
|
+
{callId, ...(lineOwnerId ? {lineOwnerId} : {})},
|
|
157
|
+
METHODS.REJECT
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
public muteCall(params: CallIdParams): Promise<IHttpResponse> {
|
|
162
|
+
const {callId, lineOwnerId} = params;
|
|
163
|
+
|
|
164
|
+
return this.telephonyRequest(
|
|
165
|
+
'/mute',
|
|
166
|
+
HTTP_METHODS.POST,
|
|
167
|
+
{callId, ...(lineOwnerId ? {lineOwnerId} : {})},
|
|
168
|
+
METHODS.TOGGLE_MUTE
|
|
169
|
+
);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
public unmuteCall(params: CallIdParams): Promise<IHttpResponse> {
|
|
173
|
+
const {callId, lineOwnerId} = params;
|
|
174
|
+
|
|
175
|
+
return this.telephonyRequest(
|
|
176
|
+
'/unmute',
|
|
177
|
+
HTTP_METHODS.POST,
|
|
178
|
+
{callId, ...(lineOwnerId ? {lineOwnerId} : {})},
|
|
179
|
+
METHODS.TOGGLE_MUTE
|
|
180
|
+
);
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
public transmitDtmf(params: TransmitDtmfParams): Promise<IHttpResponse> {
|
|
184
|
+
const {callId, dtmf, lineOwnerId} = params;
|
|
185
|
+
|
|
186
|
+
return this.telephonyRequest(
|
|
187
|
+
'/transmitDtmf',
|
|
188
|
+
HTTP_METHODS.POST,
|
|
189
|
+
{callId, dtmf, ...(lineOwnerId ? {lineOwnerId} : {})},
|
|
190
|
+
METHODS.TRANSMIT_DTMF
|
|
191
|
+
);
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
public async getCallDetails(params: CallIdParams): Promise<CallDetailsResponse> {
|
|
195
|
+
const {callId, lineOwnerId} = params;
|
|
196
|
+
const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';
|
|
197
|
+
const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;
|
|
198
|
+
|
|
199
|
+
try {
|
|
200
|
+
LoggerProxy.log('AnswerCallOnWebexService.getCallDetails request', {
|
|
201
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
202
|
+
method: METHODS.GET_CALL_DETAILS_ON_WEBEX,
|
|
203
|
+
data: {callIdSuffix: callId.length <= 8 ? callId : callId.slice(-8)},
|
|
204
|
+
});
|
|
205
|
+
|
|
206
|
+
const response = (await this.webex.request({
|
|
207
|
+
uri,
|
|
208
|
+
method: HTTP_METHODS.GET,
|
|
209
|
+
addAuthHeader: true,
|
|
210
|
+
})) as IHttpResponse;
|
|
211
|
+
|
|
212
|
+
return (response.body ?? {}) as CallDetailsResponse;
|
|
213
|
+
} catch (error) {
|
|
214
|
+
if (isWxAppCallNotFoundError(error)) {
|
|
215
|
+
const err =
|
|
216
|
+
error instanceof Error
|
|
217
|
+
? error
|
|
218
|
+
: new Error(String((error as {message?: string})?.message ?? error));
|
|
219
|
+
throw markWxAppTelephonyError(err, error);
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
const trackingId = this.extractTrackingId(error);
|
|
223
|
+
LoggerProxy.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {
|
|
224
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
225
|
+
method: METHODS.GET_CALL_DETAILS_ON_WEBEX,
|
|
226
|
+
data: {
|
|
227
|
+
trackingId,
|
|
228
|
+
status: extractWxAppHttpStatus(error),
|
|
229
|
+
},
|
|
230
|
+
});
|
|
231
|
+
const {error: detailedError} = getErrorDetails(
|
|
232
|
+
error,
|
|
233
|
+
METHODS.GET_CALL_DETAILS_ON_WEBEX,
|
|
234
|
+
CC_FILE
|
|
235
|
+
);
|
|
236
|
+
throw markWxAppTelephonyError(detailedError, error);
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
}
|