@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
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
exports.default = void 0;
|
|
7
|
+
var _loggerProxy = _interopRequireDefault(require("../logger-proxy"));
|
|
8
|
+
var _constants = require("../constants");
|
|
9
|
+
var _types = require("../types");
|
|
10
|
+
var _Utils = require("./core/Utils");
|
|
11
|
+
var _wxAppTelephonyUtils = require("./wxAppTelephonyUtils");
|
|
12
|
+
function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
|
|
13
|
+
const ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';
|
|
14
|
+
const extractWxAppTrackingId = source => {
|
|
15
|
+
const sourceObj = source;
|
|
16
|
+
return sourceObj?.details?.trackingId || sourceObj?.trackingId;
|
|
17
|
+
};
|
|
18
|
+
const extractWxAppHttpStatus = source => {
|
|
19
|
+
const obj = source;
|
|
20
|
+
return obj?.statusCode ?? obj?.status ?? obj?.details?.status;
|
|
21
|
+
};
|
|
22
|
+
const markWxAppTelephonyError = (error, source) => {
|
|
23
|
+
const marked = error;
|
|
24
|
+
marked.isWxAppTelephonyError = true;
|
|
25
|
+
const trackingId = extractWxAppTrackingId(source);
|
|
26
|
+
if (trackingId) {
|
|
27
|
+
marked.trackingId = trackingId;
|
|
28
|
+
}
|
|
29
|
+
const status = extractWxAppHttpStatus(source);
|
|
30
|
+
if (status !== undefined) {
|
|
31
|
+
marked.status = status;
|
|
32
|
+
}
|
|
33
|
+
return marked;
|
|
34
|
+
};
|
|
35
|
+
/**
|
|
36
|
+
* REST telephony client for wxApp thick-client answer (WXCC-6026).
|
|
37
|
+
* Separate from WebCallingService (WebRTC/Mobius).
|
|
38
|
+
*/
|
|
39
|
+
class AnswerCallOnWebexService {
|
|
40
|
+
constructor(webex) {
|
|
41
|
+
this.webex = webex;
|
|
42
|
+
}
|
|
43
|
+
getTelephonyBaseUrl() {
|
|
44
|
+
const services = this.webex.internal.services;
|
|
45
|
+
const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');
|
|
46
|
+
if (!hydraUrl) {
|
|
47
|
+
throw new Error('Telephony base URL is unavailable');
|
|
48
|
+
}
|
|
49
|
+
return `${hydraUrl.replace(/\/$/, '')}/telephony/calls`;
|
|
50
|
+
}
|
|
51
|
+
extractTrackingId(source) {
|
|
52
|
+
return extractWxAppTrackingId(source);
|
|
53
|
+
}
|
|
54
|
+
async telephonyRequest(resource, method, body, logMethod) {
|
|
55
|
+
try {
|
|
56
|
+
const uri = `${this.getTelephonyBaseUrl()}${resource}`;
|
|
57
|
+
_loggerProxy.default.log(`AnswerCallOnWebexService.${logMethod} request`, {
|
|
58
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
59
|
+
method: logMethod,
|
|
60
|
+
data: {
|
|
61
|
+
uri,
|
|
62
|
+
bodyKeys: Object.keys(body)
|
|
63
|
+
}
|
|
64
|
+
});
|
|
65
|
+
const response = await this.webex.request({
|
|
66
|
+
uri,
|
|
67
|
+
method,
|
|
68
|
+
body,
|
|
69
|
+
addAuthHeader: true
|
|
70
|
+
});
|
|
71
|
+
_loggerProxy.default.log(`AnswerCallOnWebexService.${logMethod} success`, {
|
|
72
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
73
|
+
method: logMethod,
|
|
74
|
+
data: {
|
|
75
|
+
statusCode: response.statusCode
|
|
76
|
+
}
|
|
77
|
+
});
|
|
78
|
+
return response;
|
|
79
|
+
} catch (error) {
|
|
80
|
+
const trackingId = this.extractTrackingId(error);
|
|
81
|
+
_loggerProxy.default.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {
|
|
82
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
83
|
+
method: logMethod,
|
|
84
|
+
data: {
|
|
85
|
+
trackingId,
|
|
86
|
+
status: extractWxAppHttpStatus(error)
|
|
87
|
+
}
|
|
88
|
+
});
|
|
89
|
+
const {
|
|
90
|
+
error: detailedError
|
|
91
|
+
} = (0, _Utils.getErrorDetails)(error, logMethod, _constants.CC_FILE);
|
|
92
|
+
throw markWxAppTelephonyError(detailedError, error);
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
answerCall(params) {
|
|
96
|
+
const {
|
|
97
|
+
callId,
|
|
98
|
+
endpointId,
|
|
99
|
+
lineOwnerId
|
|
100
|
+
} = params;
|
|
101
|
+
return this.telephonyRequest('/answer', _types.HTTP_METHODS.POST, {
|
|
102
|
+
callId,
|
|
103
|
+
endpointId,
|
|
104
|
+
...(lineOwnerId ? {
|
|
105
|
+
lineOwnerId
|
|
106
|
+
} : {})
|
|
107
|
+
}, _constants.METHODS.ACCEPT);
|
|
108
|
+
}
|
|
109
|
+
rejectCall(params) {
|
|
110
|
+
const {
|
|
111
|
+
callId,
|
|
112
|
+
lineOwnerId
|
|
113
|
+
} = params;
|
|
114
|
+
return this.telephonyRequest('/reject', _types.HTTP_METHODS.POST, {
|
|
115
|
+
callId,
|
|
116
|
+
...(lineOwnerId ? {
|
|
117
|
+
lineOwnerId
|
|
118
|
+
} : {})
|
|
119
|
+
}, _constants.METHODS.REJECT);
|
|
120
|
+
}
|
|
121
|
+
muteCall(params) {
|
|
122
|
+
const {
|
|
123
|
+
callId,
|
|
124
|
+
lineOwnerId
|
|
125
|
+
} = params;
|
|
126
|
+
return this.telephonyRequest('/mute', _types.HTTP_METHODS.POST, {
|
|
127
|
+
callId,
|
|
128
|
+
...(lineOwnerId ? {
|
|
129
|
+
lineOwnerId
|
|
130
|
+
} : {})
|
|
131
|
+
}, _constants.METHODS.TOGGLE_MUTE);
|
|
132
|
+
}
|
|
133
|
+
unmuteCall(params) {
|
|
134
|
+
const {
|
|
135
|
+
callId,
|
|
136
|
+
lineOwnerId
|
|
137
|
+
} = params;
|
|
138
|
+
return this.telephonyRequest('/unmute', _types.HTTP_METHODS.POST, {
|
|
139
|
+
callId,
|
|
140
|
+
...(lineOwnerId ? {
|
|
141
|
+
lineOwnerId
|
|
142
|
+
} : {})
|
|
143
|
+
}, _constants.METHODS.TOGGLE_MUTE);
|
|
144
|
+
}
|
|
145
|
+
transmitDtmf(params) {
|
|
146
|
+
const {
|
|
147
|
+
callId,
|
|
148
|
+
dtmf,
|
|
149
|
+
lineOwnerId
|
|
150
|
+
} = params;
|
|
151
|
+
return this.telephonyRequest('/transmitDtmf', _types.HTTP_METHODS.POST, {
|
|
152
|
+
callId,
|
|
153
|
+
dtmf,
|
|
154
|
+
...(lineOwnerId ? {
|
|
155
|
+
lineOwnerId
|
|
156
|
+
} : {})
|
|
157
|
+
}, _constants.METHODS.TRANSMIT_DTMF);
|
|
158
|
+
}
|
|
159
|
+
async getCallDetails(params) {
|
|
160
|
+
const {
|
|
161
|
+
callId,
|
|
162
|
+
lineOwnerId
|
|
163
|
+
} = params;
|
|
164
|
+
const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';
|
|
165
|
+
const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;
|
|
166
|
+
try {
|
|
167
|
+
_loggerProxy.default.log('AnswerCallOnWebexService.getCallDetails request', {
|
|
168
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
169
|
+
method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX,
|
|
170
|
+
data: {
|
|
171
|
+
callIdSuffix: callId.length <= 8 ? callId : callId.slice(-8)
|
|
172
|
+
}
|
|
173
|
+
});
|
|
174
|
+
const response = await this.webex.request({
|
|
175
|
+
uri,
|
|
176
|
+
method: _types.HTTP_METHODS.GET,
|
|
177
|
+
addAuthHeader: true
|
|
178
|
+
});
|
|
179
|
+
return response.body ?? {};
|
|
180
|
+
} catch (error) {
|
|
181
|
+
if ((0, _wxAppTelephonyUtils.isWxAppCallNotFoundError)(error)) {
|
|
182
|
+
const err = error instanceof Error ? error : new Error(String(error?.message ?? error));
|
|
183
|
+
throw markWxAppTelephonyError(err, error);
|
|
184
|
+
}
|
|
185
|
+
const trackingId = this.extractTrackingId(error);
|
|
186
|
+
_loggerProxy.default.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {
|
|
187
|
+
module: ANSWER_CALL_ON_WEBEX_FILE,
|
|
188
|
+
method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX,
|
|
189
|
+
data: {
|
|
190
|
+
trackingId,
|
|
191
|
+
status: extractWxAppHttpStatus(error)
|
|
192
|
+
}
|
|
193
|
+
});
|
|
194
|
+
const {
|
|
195
|
+
error: detailedError
|
|
196
|
+
} = (0, _Utils.getErrorDetails)(error, _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX, _constants.CC_FILE);
|
|
197
|
+
throw markWxAppTelephonyError(detailedError, error);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
exports.default = AnswerCallOnWebexService;
|
|
202
|
+
//# sourceMappingURL=AnswerCallOnWebexService.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"names":["_loggerProxy","_interopRequireDefault","require","_constants","_types","_Utils","_wxAppTelephonyUtils","e","__esModule","default","ANSWER_CALL_ON_WEBEX_FILE","extractWxAppTrackingId","source","sourceObj","details","trackingId","extractWxAppHttpStatus","obj","statusCode","status","markWxAppTelephonyError","error","marked","isWxAppTelephonyError","undefined","AnswerCallOnWebexService","constructor","webex","getTelephonyBaseUrl","services","internal","hydraUrl","_serviceUrls","hydra","get","Error","replace","extractTrackingId","telephonyRequest","resource","method","body","logMethod","uri","LoggerProxy","log","module","data","bodyKeys","Object","keys","response","request","addAuthHeader","detailedError","getErrorDetails","CC_FILE","answerCall","params","callId","endpointId","lineOwnerId","HTTP_METHODS","POST","METHODS","ACCEPT","rejectCall","REJECT","muteCall","TOGGLE_MUTE","unmuteCall","transmitDtmf","dtmf","TRANSMIT_DTMF","getCallDetails","lineOwnerIdQuery","encodeURIComponent","GET_CALL_DETAILS_ON_WEBEX","callIdSuffix","length","slice","GET","isWxAppCallNotFoundError","err","String","message","exports"],"sources":["AnswerCallOnWebexService.ts"],"sourcesContent":["import LoggerProxy from '../logger-proxy';\nimport {CC_FILE, METHODS} from '../constants';\nimport {HTTP_METHODS, IHttpResponse, WebexSDK} from '../types';\nimport {getErrorDetails} from './core/Utils';\nimport {isWxAppCallNotFoundError} from './wxAppTelephonyUtils';\n\nconst ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';\n\nexport type WxAppTelephonyError = Error & {\n isWxAppTelephonyError: true;\n trackingId?: string;\n status?: number | string;\n};\n\nconst extractWxAppTrackingId = (source: unknown): string | undefined => {\n const sourceObj = source as {details?: {trackingId?: string}; trackingId?: string};\n\n return sourceObj?.details?.trackingId || sourceObj?.trackingId;\n};\n\nconst extractWxAppHttpStatus = (source: unknown): number | string | undefined => {\n const obj = source as {\n statusCode?: number;\n status?: number | string;\n details?: {status?: number | string};\n };\n\n return obj?.statusCode ?? obj?.status ?? obj?.details?.status;\n};\n\nconst markWxAppTelephonyError = (error: Error, source: unknown): WxAppTelephonyError => {\n const marked = error as WxAppTelephonyError;\n marked.isWxAppTelephonyError = true;\n const trackingId = extractWxAppTrackingId(source);\n if (trackingId) {\n marked.trackingId = trackingId;\n }\n const status = extractWxAppHttpStatus(source);\n if (status !== undefined) {\n marked.status = status;\n }\n\n return marked;\n};\n\nexport type AnswerCallParams = {\n callId: string;\n endpointId: string;\n lineOwnerId?: string;\n};\n\nexport type CallIdParams = {\n callId: string;\n lineOwnerId?: string;\n};\n\nexport type TransmitDtmfParams = CallIdParams & {\n dtmf: string;\n};\n\nexport type CallDetailsResponse = {\n muted?: boolean;\n};\n\n/**\n * REST telephony client for wxApp thick-client answer (WXCC-6026).\n * Separate from WebCallingService (WebRTC/Mobius).\n */\nexport default class AnswerCallOnWebexService {\n private webex: WebexSDK;\n\n constructor(webex: WebexSDK) {\n this.webex = webex;\n }\n\n private getTelephonyBaseUrl(): string {\n const services = this.webex.internal.services;\n const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');\n\n if (!hydraUrl) {\n throw new Error('Telephony base URL is unavailable');\n }\n\n return `${hydraUrl.replace(/\\/$/, '')}/telephony/calls`;\n }\n\n private extractTrackingId(source: unknown): string | undefined {\n return extractWxAppTrackingId(source);\n }\n\n private async telephonyRequest(\n resource: string,\n method: HTTP_METHODS,\n body: Record<string, unknown>,\n logMethod: string\n ): Promise<IHttpResponse> {\n try {\n const uri = `${this.getTelephonyBaseUrl()}${resource}`;\n\n LoggerProxy.log(`AnswerCallOnWebexService.${logMethod} request`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: logMethod,\n data: {uri, bodyKeys: Object.keys(body)},\n });\n\n const response = (await this.webex.request({\n uri,\n method,\n body,\n addAuthHeader: true,\n })) as IHttpResponse;\n\n LoggerProxy.log(`AnswerCallOnWebexService.${logMethod} success`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: logMethod,\n data: {statusCode: response.statusCode},\n });\n\n return response;\n } catch (error) {\n const trackingId = this.extractTrackingId(error);\n LoggerProxy.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: logMethod,\n data: {\n trackingId,\n status: extractWxAppHttpStatus(error),\n },\n });\n const {error: detailedError} = getErrorDetails(error, logMethod, CC_FILE);\n throw markWxAppTelephonyError(detailedError, error);\n }\n }\n\n public answerCall(params: AnswerCallParams): Promise<IHttpResponse> {\n const {callId, endpointId, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/answer',\n HTTP_METHODS.POST,\n {\n callId,\n endpointId,\n ...(lineOwnerId ? {lineOwnerId} : {}),\n },\n METHODS.ACCEPT\n );\n }\n\n public rejectCall(params: CallIdParams): Promise<IHttpResponse> {\n const {callId, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/reject',\n HTTP_METHODS.POST,\n {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n METHODS.REJECT\n );\n }\n\n public muteCall(params: CallIdParams): Promise<IHttpResponse> {\n const {callId, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/mute',\n HTTP_METHODS.POST,\n {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n METHODS.TOGGLE_MUTE\n );\n }\n\n public unmuteCall(params: CallIdParams): Promise<IHttpResponse> {\n const {callId, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/unmute',\n HTTP_METHODS.POST,\n {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n METHODS.TOGGLE_MUTE\n );\n }\n\n public transmitDtmf(params: TransmitDtmfParams): Promise<IHttpResponse> {\n const {callId, dtmf, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/transmitDtmf',\n HTTP_METHODS.POST,\n {callId, dtmf, ...(lineOwnerId ? {lineOwnerId} : {})},\n METHODS.TRANSMIT_DTMF\n );\n }\n\n public async getCallDetails(params: CallIdParams): Promise<CallDetailsResponse> {\n const {callId, lineOwnerId} = params;\n const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';\n const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;\n\n try {\n LoggerProxy.log('AnswerCallOnWebexService.getCallDetails request', {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: METHODS.GET_CALL_DETAILS_ON_WEBEX,\n data: {callIdSuffix: callId.length <= 8 ? callId : callId.slice(-8)},\n });\n\n const response = (await this.webex.request({\n uri,\n method: HTTP_METHODS.GET,\n addAuthHeader: true,\n })) as IHttpResponse;\n\n return (response.body ?? {}) as CallDetailsResponse;\n } catch (error) {\n if (isWxAppCallNotFoundError(error)) {\n const err =\n error instanceof Error\n ? error\n : new Error(String((error as {message?: string})?.message ?? error));\n throw markWxAppTelephonyError(err, error);\n }\n\n const trackingId = this.extractTrackingId(error);\n LoggerProxy.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: METHODS.GET_CALL_DETAILS_ON_WEBEX,\n data: {\n trackingId,\n status: extractWxAppHttpStatus(error),\n },\n });\n const {error: detailedError} = getErrorDetails(\n error,\n METHODS.GET_CALL_DETAILS_ON_WEBEX,\n CC_FILE\n );\n throw markWxAppTelephonyError(detailedError, error);\n }\n }\n}\n"],"mappings":"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","ignoreList":[]}
|
|
@@ -18,8 +18,24 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
|
|
|
18
18
|
* @public
|
|
19
19
|
*/
|
|
20
20
|
class ApiAIAssistant {
|
|
21
|
-
|
|
21
|
+
/** @internal Current AI flags from the agent configuration. */
|
|
22
|
+
|
|
23
|
+
pendingRtdRequests = new Map();
|
|
24
|
+
createWellnessError(reason) {
|
|
25
|
+
const error = new Error(reason);
|
|
26
|
+
error.details = {
|
|
27
|
+
type: 'SDK_VALIDATION_ERROR',
|
|
28
|
+
orgId: this.webex.credentials.getOrgId(),
|
|
29
|
+
trackingId: '',
|
|
30
|
+
data: {
|
|
31
|
+
reason
|
|
32
|
+
}
|
|
33
|
+
};
|
|
34
|
+
return error;
|
|
35
|
+
}
|
|
36
|
+
constructor(webex, wellnessContextProvider) {
|
|
22
37
|
this.webex = webex;
|
|
38
|
+
this.wellnessContextProvider = wellnessContextProvider;
|
|
23
39
|
this.metricsManager = _MetricsManager.default.getInstance({
|
|
24
40
|
webex
|
|
25
41
|
});
|
|
@@ -27,12 +43,126 @@ class ApiAIAssistant {
|
|
|
27
43
|
setAIFeatureFlags(aiFeature) {
|
|
28
44
|
this.aiFeature = aiFeature;
|
|
29
45
|
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Validates a caller-supplied identifier (agentId/interactionId) before it is used to
|
|
49
|
+
* construct a request. Accepts a non-empty alphanumeric identifier that may contain
|
|
50
|
+
* hyphens or underscores.
|
|
51
|
+
* @param value - the identifier to validate
|
|
52
|
+
* @returns {boolean} true when the identifier is a non-empty, well-formed string
|
|
53
|
+
* @private
|
|
54
|
+
*/
|
|
55
|
+
isValidTranscriptIdentifier(value) {
|
|
56
|
+
return typeof value === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(value);
|
|
57
|
+
}
|
|
58
|
+
async sendWellnessBreakAction(action, method) {
|
|
59
|
+
this.metricsManager.timeEvent([_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_ACCEPTED, _constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_FAILED]);
|
|
60
|
+
try {
|
|
61
|
+
const context = this.wellnessContextProvider?.();
|
|
62
|
+
const agentId = context?.agentId?.trim();
|
|
63
|
+
const agentSessionId = context?.agentSessionId?.trim();
|
|
64
|
+
const orgId = this.webex.credentials.getOrgId()?.trim();
|
|
65
|
+
if (context?.isWellnessBreakEnabled !== true) {
|
|
66
|
+
throw this.createWellnessError('WELLNESS_BREAK_NOT_ENABLED');
|
|
67
|
+
}
|
|
68
|
+
if (!orgId) {
|
|
69
|
+
throw this.createWellnessError('WELLNESS_BREAK_ORG_ID_REQUIRED');
|
|
70
|
+
}
|
|
71
|
+
if (!agentId) {
|
|
72
|
+
throw this.createWellnessError('WELLNESS_BREAK_AGENT_ID_REQUIRED');
|
|
73
|
+
}
|
|
74
|
+
if (!agentSessionId) {
|
|
75
|
+
throw this.createWellnessError('WELLNESS_BREAK_AGENT_SESSION_REQUIRED');
|
|
76
|
+
}
|
|
77
|
+
const baseUrl = this.getBaseUrl();
|
|
78
|
+
const response = await this.webex.request({
|
|
79
|
+
uri: `${baseUrl}${_constants3.AI_ASSISTANT_API_URLS.EVENT}`,
|
|
80
|
+
method: _types.HTTP_METHODS.POST,
|
|
81
|
+
addAuthHeader: true,
|
|
82
|
+
body: {
|
|
83
|
+
agentId,
|
|
84
|
+
orgId,
|
|
85
|
+
eventType: _types.AIAssistantEventType.CUSTOM_EVENT,
|
|
86
|
+
eventName: _types.AIAssistantEventName.WELLNESS_BREAK_ACTION,
|
|
87
|
+
eventDetails: {
|
|
88
|
+
data: {
|
|
89
|
+
action,
|
|
90
|
+
agentSessionId,
|
|
91
|
+
actionTimeStamp: Date.now()
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
});
|
|
96
|
+
if (response.statusCode !== 202) {
|
|
97
|
+
throw this.createWellnessError(`WELLNESS_BREAK_ACTION_UNEXPECTED_STATUS_${response.statusCode}`);
|
|
98
|
+
}
|
|
99
|
+
this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_ACCEPTED, {
|
|
100
|
+
action
|
|
101
|
+
}, ['operational']);
|
|
102
|
+
_loggerProxy.default.log('Wellness action accepted by AI Assistant', {
|
|
103
|
+
module: _constants2.CC_FILE,
|
|
104
|
+
method,
|
|
105
|
+
data: {
|
|
106
|
+
action
|
|
107
|
+
}
|
|
108
|
+
});
|
|
109
|
+
} catch (error) {
|
|
110
|
+
this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_FAILED, {
|
|
111
|
+
action,
|
|
112
|
+
error: error instanceof Error ? error.message : String(error)
|
|
113
|
+
}, ['operational']);
|
|
114
|
+
const {
|
|
115
|
+
error: detailedError
|
|
116
|
+
} = (0, _Utils.getErrorDetails)(error, method, _constants2.CC_FILE);
|
|
117
|
+
throw detailedError;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Requests an Agent Wellness Break.
|
|
123
|
+
* The promise resolves when the HTTP request is accepted with status 202; the later
|
|
124
|
+
* approval or denial is delivered independently through a wellness notification.
|
|
125
|
+
* @returns A promise that resolves with no value after HTTP acceptance
|
|
126
|
+
* @throws Structured Contact Center error when disabled, stale, invalid, or delivery fails
|
|
127
|
+
* @example
|
|
128
|
+
* await webex.cc.apiAIAssistant.requestWellnessBreak();
|
|
129
|
+
* @public
|
|
130
|
+
*/
|
|
131
|
+
async requestWellnessBreak() {
|
|
132
|
+
return this.sendWellnessBreakAction(_types.WELLNESS_BREAK_USER_ACTIONS.REQUESTED, _constants2.METHODS.REQUEST_WELLNESS_BREAK);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Responds to a backend-provided Agent Wellness Break offer.
|
|
137
|
+
* The promise resolves when the HTTP request is accepted with status 202 and does not
|
|
138
|
+
* wait for a WebSocket completion event.
|
|
139
|
+
* @param params - ACCEPTED, REJECTED, or NO_RESPONSE
|
|
140
|
+
* @returns A promise that resolves with no value after HTTP acceptance
|
|
141
|
+
* @throws Structured Contact Center error when disabled, stale, invalid, or delivery fails
|
|
142
|
+
* @example
|
|
143
|
+
* await webex.cc.apiAIAssistant.respondToWellnessBreak({
|
|
144
|
+
* action: WELLNESS_BREAK_USER_ACTIONS.ACCEPTED,
|
|
145
|
+
* });
|
|
146
|
+
* @public
|
|
147
|
+
*/
|
|
148
|
+
async respondToWellnessBreak(params) {
|
|
149
|
+
const {
|
|
150
|
+
action
|
|
151
|
+
} = params;
|
|
152
|
+
if (![_types.WELLNESS_BREAK_USER_ACTIONS.ACCEPTED, _types.WELLNESS_BREAK_USER_ACTIONS.REJECTED, _types.WELLNESS_BREAK_USER_ACTIONS.NO_RESPONSE].includes(action)) {
|
|
153
|
+
const {
|
|
154
|
+
error
|
|
155
|
+
} = (0, _Utils.getErrorDetails)(this.createWellnessError('WELLNESS_BREAK_ACTION_INVALID'), _constants2.METHODS.RESPOND_TO_WELLNESS_BREAK, _constants2.CC_FILE);
|
|
156
|
+
throw error;
|
|
157
|
+
}
|
|
158
|
+
return this.sendWellnessBreakAction(action, _constants2.METHODS.RESPOND_TO_WELLNESS_BREAK);
|
|
159
|
+
}
|
|
30
160
|
getBaseUrl() {
|
|
31
161
|
const wccApiGatewayUrl = this.webex.internal.services.get(_constants3.WCC_API_GATEWAY) || '';
|
|
32
162
|
if (!wccApiGatewayUrl) {
|
|
33
163
|
const {
|
|
34
164
|
error: detailedError
|
|
35
|
-
} = (0, _Utils.getErrorDetails)(new Error(
|
|
165
|
+
} = (0, _Utils.getErrorDetails)(new Error(_constants2.AI_SUMMARY_ERROR_CODES.AI_ASSISTANT_BASE_URL_NOT_AVAILABLE), _constants2.METHODS.GET_BASE_URL, _constants2.CC_FILE);
|
|
36
166
|
throw detailedError;
|
|
37
167
|
}
|
|
38
168
|
let hostname = '';
|
|
@@ -45,11 +175,78 @@ class ApiAIAssistant {
|
|
|
45
175
|
if (!resolvedEnv) {
|
|
46
176
|
const {
|
|
47
177
|
error: detailedError
|
|
48
|
-
} = (0, _Utils.getErrorDetails)(new Error(
|
|
178
|
+
} = (0, _Utils.getErrorDetails)(new Error(_constants2.AI_SUMMARY_ERROR_CODES.AI_ASSISTANT_BASE_URL_NOT_AVAILABLE), _constants2.METHODS.GET_BASE_URL, _constants2.CC_FILE);
|
|
49
179
|
throw detailedError;
|
|
50
180
|
}
|
|
51
181
|
return _constants3.AI_ASSISTANT_BASE_URL_TEMPLATE.replace('%s', resolvedEnv);
|
|
52
182
|
}
|
|
183
|
+
static getRtdRequestKey(rtdEventType, correlationId) {
|
|
184
|
+
return JSON.stringify([rtdEventType, correlationId]);
|
|
185
|
+
}
|
|
186
|
+
removeRtdRequest(rtdEventType, correlationId, settle) {
|
|
187
|
+
const key = ApiAIAssistant.getRtdRequestKey(rtdEventType, correlationId);
|
|
188
|
+
const request = this.pendingRtdRequests.get(key);
|
|
189
|
+
if (!request) {
|
|
190
|
+
return undefined;
|
|
191
|
+
}
|
|
192
|
+
if (request.timeoutId) {
|
|
193
|
+
clearTimeout(request.timeoutId);
|
|
194
|
+
}
|
|
195
|
+
settle?.(request);
|
|
196
|
+
this.pendingRtdRequests.delete(key);
|
|
197
|
+
return request;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/** Sends an AI event and waits for its matching RTD response. @internal */
|
|
201
|
+
async requestAndWaitForRtd(options) {
|
|
202
|
+
const key = ApiAIAssistant.getRtdRequestKey(options.rtdEventType, options.correlationId);
|
|
203
|
+
let resolveResult = () => undefined;
|
|
204
|
+
let rejectResult = () => undefined;
|
|
205
|
+
const result = new Promise((resolve, reject) => {
|
|
206
|
+
resolveResult = resolve;
|
|
207
|
+
rejectResult = reject;
|
|
208
|
+
});
|
|
209
|
+
const previousRequest = this.pendingRtdRequests.get(key);
|
|
210
|
+
if (previousRequest?.timeoutId) {
|
|
211
|
+
clearTimeout(previousRequest.timeoutId);
|
|
212
|
+
}
|
|
213
|
+
const request = {
|
|
214
|
+
correlationId: options.correlationId,
|
|
215
|
+
rtdEventType: options.rtdEventType,
|
|
216
|
+
resolve: resolveResult,
|
|
217
|
+
reject: rejectResult
|
|
218
|
+
};
|
|
219
|
+
request.timeoutId = setTimeout(() => {
|
|
220
|
+
this.removeRtdRequest(options.rtdEventType, options.correlationId, currentRequest => {
|
|
221
|
+
currentRequest.reject(options.createTimeoutError());
|
|
222
|
+
});
|
|
223
|
+
}, options.timeoutMs);
|
|
224
|
+
this.pendingRtdRequests.set(key, request);
|
|
225
|
+
const publishTimestamp = options.publishTimestamp ?? Date.now();
|
|
226
|
+
const acknowledgement = Promise.resolve().then(() => this.sendEvent(options.agentId, options.interactionId, options.eventType, options.eventName, options.eventMetaData, undefined, undefined, publishTimestamp, options.timeout)).catch(error => {
|
|
227
|
+
this.removeRtdRequest(options.rtdEventType, options.correlationId);
|
|
228
|
+
throw error;
|
|
229
|
+
});
|
|
230
|
+
const [payload] = await Promise.all([result, acknowledgement]);
|
|
231
|
+
return payload;
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
/** Resolves a pending request from a parsed RTD event. @internal */
|
|
235
|
+
resolveFromRtdEvent(rtdEventType, correlationId, payload) {
|
|
236
|
+
const request = this.removeRtdRequest(rtdEventType, correlationId, currentRequest => {
|
|
237
|
+
currentRequest.resolve(payload);
|
|
238
|
+
});
|
|
239
|
+
return request ? 'resolved' : 'not-found';
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/** Clears pending RTD requests when the RTD lifecycle ends. @internal */
|
|
243
|
+
clearAllRtdRequests() {
|
|
244
|
+
Array.from(this.pendingRtdRequests.values()).forEach(request => {
|
|
245
|
+
this.removeRtdRequest(request.rtdEventType, request.correlationId, currentRequest => {
|
|
246
|
+
currentRequest.reject(new Error('RTD request cleared'));
|
|
247
|
+
});
|
|
248
|
+
});
|
|
249
|
+
}
|
|
53
250
|
|
|
54
251
|
/**
|
|
55
252
|
* Sends an event to the AI Assistant service.
|
|
@@ -61,7 +258,7 @@ class ApiAIAssistant {
|
|
|
61
258
|
* @param languageCode - language code within eventDetails.data
|
|
62
259
|
* @param trackingId - tracking identifier within eventDetails.data
|
|
63
260
|
*/
|
|
64
|
-
async sendEvent(agentId, interactionId, eventType, eventName, eventMetaData, languageCode, trackingId) {
|
|
261
|
+
async sendEvent(agentId, interactionId, eventType, eventName, eventMetaData, languageCode, trackingId, publishTimestamp, timeout) {
|
|
65
262
|
_loggerProxy.default.info('Sending event', {
|
|
66
263
|
module: _constants2.CC_FILE,
|
|
67
264
|
method: _constants2.METHODS.SEND_EVENT,
|
|
@@ -76,23 +273,30 @@ class ApiAIAssistant {
|
|
|
76
273
|
try {
|
|
77
274
|
const baseUrl = this.getBaseUrl();
|
|
78
275
|
const orgId = this.webex.credentials.getOrgId();
|
|
276
|
+
const data = {
|
|
277
|
+
...eventMetaData,
|
|
278
|
+
interactionId,
|
|
279
|
+
actionTimeStamp: String(Date.now()),
|
|
280
|
+
languageCode,
|
|
281
|
+
trackingId
|
|
282
|
+
};
|
|
79
283
|
const response = await this.webex.request({
|
|
80
284
|
uri: `${baseUrl}${_constants3.AI_ASSISTANT_API_URLS.EVENT}`,
|
|
81
285
|
method: _types.HTTP_METHODS.POST,
|
|
82
286
|
addAuthHeader: true,
|
|
287
|
+
...(timeout !== undefined ? {
|
|
288
|
+
timeout
|
|
289
|
+
} : {}),
|
|
83
290
|
body: {
|
|
84
291
|
agentId,
|
|
85
292
|
orgId,
|
|
86
293
|
eventType,
|
|
87
294
|
eventName,
|
|
295
|
+
...(publishTimestamp !== undefined ? {
|
|
296
|
+
publishTimestamp
|
|
297
|
+
} : {}),
|
|
88
298
|
eventDetails: {
|
|
89
|
-
data
|
|
90
|
-
...eventMetaData,
|
|
91
|
-
interactionId,
|
|
92
|
-
actionTimeStamp: String(Date.now()),
|
|
93
|
-
languageCode,
|
|
94
|
-
trackingId
|
|
95
|
-
}
|
|
299
|
+
data
|
|
96
300
|
}
|
|
97
301
|
}
|
|
98
302
|
});
|
|
@@ -279,6 +483,12 @@ class ApiAIAssistant {
|
|
|
279
483
|
} = (0, _Utils.getErrorDetails)(new Error('REAL_TIME_TRANSCRIPTION_NOT_ENABLED'), _constants2.METHODS.FETCH_HISTORIC_TRANSCRIPTS, _constants2.CC_FILE);
|
|
280
484
|
throw detailedError;
|
|
281
485
|
}
|
|
486
|
+
if (!this.isValidTranscriptIdentifier(agentId) || !this.isValidTranscriptIdentifier(interactionId)) {
|
|
487
|
+
const {
|
|
488
|
+
error: detailedError
|
|
489
|
+
} = (0, _Utils.getErrorDetails)(new Error('INVALID_AGENT_ID_OR_INTERACTION_ID'), _constants2.METHODS.FETCH_HISTORIC_TRANSCRIPTS, _constants2.CC_FILE);
|
|
490
|
+
throw detailedError;
|
|
491
|
+
}
|
|
282
492
|
try {
|
|
283
493
|
const baseUrl = this.getBaseUrl();
|
|
284
494
|
const orgId = this.webex.credentials.getOrgId();
|