1 | # Changelog
|
2 |
|
3 | All notable changes to this project will be documented in this file.
|
4 |
|
5 | ## [Unreleased]
|
6 |
|
7 | ## [1.8.0] - 2024-03-29
|
8 |
|
9 | ### Changed
|
10 |
|
11 | - Updated `OCClient.getSurveyInviteLink` request payload to support Copilot Survey
|
12 |
|
13 | ## [1.7.2] - 2024-03-20
|
14 |
|
15 | ### Fixed
|
16 |
|
17 | - Remove override block for follow-redirect, which was causing conflicts with ACS libs in LCW
|
18 |
|
19 | ## [1.7.1] - 2024-03-18
|
20 |
|
21 | ### Changed
|
22 |
|
23 | - Fix ChatSDK.getPostConversationContext() to reject promise when conversation is not found
|
24 |
|
25 | ## [1.7.0] - 2024-03-07
|
26 |
|
27 | ### Added
|
28 |
|
29 | - Add ability to use `ChatSDK.emailLiveChatTranscript()` to email live chat transcript from `liveChatContext`
|
30 | - Handling the lifecycle of `sessionId` if it exists
|
31 |
|
32 | ### Changed
|
33 |
|
34 | - Throw exception when `ChatSDK.startChat()` fails with `ChatSDKConfig.getAuthToken()` failures
|
35 | - Uptake [@microsoft/ocsdk@0.4.3](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.4.3)
|
36 |
|
37 | ## [1.6.3] - 2024-01-30
|
38 |
|
39 | ### Changed
|
40 |
|
41 | - Reduce number of `config` calls on loading `Escalation to Voice & Video` library by retrieving the config from runtime cache
|
42 |
|
43 | ## [1.6.2] - 2023-12-12
|
44 |
|
45 | ### Fixed
|
46 |
|
47 | - Add `supportedImagesMimeTypes` to support `MIME` types `image/heic` & `image/webp` as images
|
48 |
|
49 | ## [1.6.1] - 2023-12-07
|
50 |
|
51 | ### Added
|
52 |
|
53 | - Exported `ChatSDKErrorName` and `ChatSDKError` for downstream component to use
|
54 |
|
55 | ### Fixed
|
56 |
|
57 | - Subscribe to `chatMessageEdited` events within `onNewMessage()` for queue position message updates
|
58 |
|
59 | ### Changed
|
60 |
|
61 | - Uptake [@microsoft/ocsdk@0.4.2](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.4.2)
|
62 |
|
63 | ## [1.6.0] - 2023-12-04
|
64 |
|
65 | ### Changed
|
66 |
|
67 | - Added "httpResponseStatusCode" attribute in the error object thrown
|
68 |
|
69 | ## [1.5.7] - 2023-11-20
|
70 |
|
71 | ### Changed
|
72 |
|
73 | - Uptake [@microsoft/omnichannel-amsclient@0.1.6](https://www.npmjs.com/package/@microsoft/omnichannel-amsclient/v/0.1.6)
|
74 |
|
75 | ## [1.5.6] - 2023-11-13
|
76 |
|
77 | ### Added
|
78 |
|
79 | - Add `RequestPayload`, `RequestPath`, `RequestMethod`, `ResponseStatusCode` telemetry base property to `OCSDKContract`
|
80 | - Update Jest configuration and tests to support new libraries
|
81 |
|
82 | ### Security
|
83 |
|
84 | - Uptake [@microsoft/omnichannel-ic3core@0.1.3](https://www.npmjs.com/package/@microsoft/omnichannel-ic3core/v/0.1.3)
|
85 | - Uptake [@microsoft/ocsdk@0.4.1](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.4.1)
|
86 |
|
87 | ### Changed
|
88 |
|
89 | - Use `parseLowerCaseString()` on chat config properties to protect text case change
|
90 |
|
91 | ## [1.5.5] - 2023-10-31
|
92 |
|
93 | ### Added
|
94 |
|
95 | - Add ability to pass custom `ariaCollectorUri`
|
96 |
|
97 | ### Fixed
|
98 |
|
99 | - Add missing `PACS` URL for `EUDomainNames`
|
100 | - Fixed an issue where startChat failed due to optionalParam being null
|
101 |
|
102 | ## [1.5.4] - 2023-10-20
|
103 |
|
104 | ### Fixed
|
105 |
|
106 | - Fix `AriaTelemetry._configuration` not being passed to `AriaTelemetry._logger`
|
107 |
|
108 | ## [1.5.3] - 2023-10-18
|
109 |
|
110 | ### Fixed
|
111 |
|
112 | - Fix `ChatSDK.emailLiveChatTranscript()` calling `OCClient.emailTranscript()` without waiting until its completion
|
113 | - Fix `EU` orgs telemetry to flow to the proper `EU` location
|
114 |
|
115 | ## [1.5.2] - 2023-10-14
|
116 |
|
117 | ### Changed
|
118 |
|
119 | - Disable `tokenRefresher` temporarily
|
120 |
|
121 | ## [1.5.1] - 2023-10-11
|
122 |
|
123 | ### Fixed
|
124 |
|
125 | - Modify `getChatReconnectContext` to return redirection URL when reconnection ID is not longer Valid for Auth Chats.
|
126 |
|
127 | ## [1.5.0] - 2023-09-29
|
128 |
|
129 | ### Added
|
130 |
|
131 | - Add `Attachment File Scan` to `ChatSDK.createChatAdapter()`
|
132 |
|
133 | ## [1.4.7] - 2023-09-13
|
134 |
|
135 | ### Changed
|
136 |
|
137 | - Supporting getAgentAvailable SDK method for unauthenticated chat widget
|
138 |
|
139 | ## [1.4.6] - 2023-08-15
|
140 |
|
141 | ### Fixed
|
142 |
|
143 | - Fix `tokenRefresher` to update `chatToken` properly on expiry through reinitialization of AMSClient
|
144 |
|
145 | ## [1.4.5] - 2023-08-02
|
146 |
|
147 | ### Changed
|
148 |
|
149 | - Upgraded ACSAdapter to version beta.20
|
150 |
|
151 | ## [1.4.4] - 2023-07-19
|
152 |
|
153 | ### Added
|
154 |
|
155 | - Add `tokenRefresher` mechanism to retrieve chat token on expiry
|
156 |
|
157 | ### Changed
|
158 |
|
159 | - Add `ocSDKConfiguration` to reduce `chatToken` retries to 2
|
160 | - Uptake [@microsoft/ocsdk@0.4.0](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.4.0)
|
161 | - Remove redundant call to create of `participantsMapping`
|
162 |
|
163 | ### Fixed
|
164 |
|
165 | - Set `enableSenderDisplayNameInTypingNotification` to true to include display name on sending typing notification
|
166 | - Add `async` to `ChatSDK.getLiveChatTranscript()` internal call
|
167 |
|
168 | ## [1.4.3] - 2023-06-15
|
169 |
|
170 | ### Fixed
|
171 |
|
172 | - [Perf] Make sessionInit, AcsClientInit/Ic3ClientInit and AmsClientInit calls in parallel
|
173 |
|
174 | ## [1.4.2] - 2023-05-19
|
175 |
|
176 | ### Fixed
|
177 |
|
178 | - Fixed null check on startChat failure
|
179 |
|
180 | ## [1.4.1] - 2023-05-05
|
181 |
|
182 | ### Fixed
|
183 |
|
184 | - Skipped empty string or null context variables (parity with v1)
|
185 |
|
186 | ## [1.4.0] - 2023-05-02
|
187 |
|
188 | ### Added
|
189 |
|
190 | - Add ability to use `ChatSDK.getLiveChatTranscript()` to fetch live chat transcript from `liveChatContext`
|
191 | - Add ability to use `ChatSDK.getConversationDetails()` to fetch conversation details from `liveChatContext`
|
192 | - Add `AuthContactIdNotFoundFailure` to `ExceptionThrower`
|
193 |
|
194 | ### Changed
|
195 |
|
196 | - Update `ChatSDKErrors` to include standard ChatSDK errors to be more predictable
|
197 |
|
198 | ## [1.3.0] - 2023-04-05
|
199 |
|
200 | ### Added
|
201 |
|
202 | - Add ability to use `ChatSDK.createChatAdapter()` for `DirectLine` protocol
|
203 | - Add `CreateACSAdapter` telemetry event
|
204 | - Improve `ChatSDK.createChatAdapter()` with retries using exponential backoff & additional details on failures
|
205 | - Add `GetAgentAvailability` SDK method for auth chat
|
206 | - Pass `logger` to AMSClient
|
207 | - Add `portalContactId` in `StartChatOptionalParams` and `GetAgentAvailabilityOptionalParams`
|
208 | - Added exception on initialization failure
|
209 | - Upgraded ACSAdapter to version beta.17
|
210 | - Added `botSurveyInviteLink` and `botFormsProLocale` the `getPostChatSurveyContext()` response
|
211 |
|
212 | ### Fixed
|
213 |
|
214 | - Fix `ChatAdapterOptionalParams.ACSAdapter.options.egressMiddleware` being used as `ingressMiddleware`
|
215 | - Fix `ChatSDK.onTypingEvent()` being triggered on current user typing
|
216 | - Update `ChatSDK.liveChatVersion` to be `V2` by default
|
217 |
|
218 | ### Changed
|
219 |
|
220 | - Uptake [@microsoft/omnichannel-amsclient@0.1.4](https://www.npmjs.com/package/@microsoft/omnichannel-amsclient/v/0.1.4)
|
221 | - Uptake [acs_webchat-chat-adapter@0.0.35-beta.17](https://unpkg.com/acs_webchat-chat-adapter@0.0.35-beta.17/dist/chat-adapter.js)
|
222 | - Uptake [@microsoft/ocsdk@0.3.4](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.3.4)
|
223 |
|
224 | ## [1.2.0] - 2022-11-11
|
225 |
|
226 | ### Added
|
227 |
|
228 | - Add `sendDefaultInitContext` optional parameter to `ChatSDK.startChat()` to automatically populate `browser`, `device`, `originurl` & `os` as default init context on web
|
229 | - Add `sendCacheHeaders` as optional paramater to `ChatSDK.initialize()` and `ChatSDK.getLiveChatConfig()`
|
230 | - Add `validateAuthChatRecord` call on `ChatSDK.startChat()` with `liveChatContext` for all authenticated chat scenarios
|
231 | - Pass `ChatClient` during `ACSAdapter` initialization
|
232 | - Pass `multiClient` to `AMSClient` on initialization to support `ChatSDK` multi-client
|
233 |
|
234 | ### Fixed
|
235 |
|
236 | - Prevent `AMSFileManager.getFileIds()` & `AMSFileManager.getFileMetadata()` to be triggered on all activities with null checks
|
237 | - Add `LiveChatVersion` check on `ChatSDK.updateChatToken()`
|
238 | - Use `amsreferences` property instead of `amsReferences` by default
|
239 | - Fix attachment download to use MIME types instead of file extensions
|
240 | - Remove `fileMetadata` property on messages not containing any attachment
|
241 |
|
242 | ### Changed
|
243 |
|
244 | - Uptake [@microsoft/ocsdk@0.3.1](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.3.1)
|
245 | - Uptake [acs_webchat-chat-adapter@0.0.35-beta.8](https://unpkg.com/acs_webchat-chat-adapter@0.0.35-beta.8/dist/chat-adapter.js)
|
246 | - Uptake [acs_webchat-chat-adapter@0.0.35-beta.9](https://unpkg.com/acs_webchat-chat-adapter@0.0.35-beta.9/dist/chat-adapter.js)
|
247 | - Uptake [acs_webchat-chat-adapter@0.0.35-beta.12](https://unpkg.com/acs_webchat-chat-adapter@0.0.35-beta.12/dist/chat-adapter.js)
|
248 | - Uptake [@microsoft/omnichannel-amsclient@0.1.2](https://www.npmjs.com/package/@microsoft/omnichannel-amsclient/v/0.1.2)
|
249 | - Uptake [@microsoft/ocsdk@0.3.2](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.3.2)
|
250 |
|
251 | ## [1.1.0] - 2022-04-15
|
252 |
|
253 | ### Added
|
254 |
|
255 | - Add `getPostChatSurveyContext` API method
|
256 | - Add `GetPostChatSurveyContext` telemetry event
|
257 | - Add `widgetId` & `clientMessageId` as metadata on sending message
|
258 | - Update `ChatConfig` interface with `LiveChatVersion`, `allowedFileExtensions` & `maxUploadFileSize` properties
|
259 | - Add ability to automatically detect locale from chat config
|
260 | - Add `runtimeId` attribute in `OmnichannelChatSDK` & `ChatSDKRuntimeId` field in telemetry
|
261 | - Add ability to automatically pass locale from chat config on calling `ChatSDK.emailLiveChatTranscript()`
|
262 | - Bubble up `WidgetUseOutsideOperatingHour` exception
|
263 | - Add `acs_webchat-chat-adapter` middleware to add default `channelData.tags` & `channelData.metadata`
|
264 | - Update `ChatConfig` interface with `msdyn_enablemarkdown` property
|
265 | - Throw exception on `ChatSDK.getVoiceVideoCalling()` if feature is disabled or platform is not supported
|
266 | - Add `participantType` & `canRenderPostChat` as response of getConversationDetails() API
|
267 | - Add support for separate bot post chat survey feature
|
268 | - Pass `logger` to `acs_webchat-chat-adapter`
|
269 |
|
270 | ### Fixed
|
271 |
|
272 | - Add `acs_webchat-chat-adapter` middlewares to format `channelData.tags`
|
273 | - Skip `session init` call on existing conversation
|
274 | - Fix `chat reconnect` not ending the conversation on calling `ChatSDK.endChat()`
|
275 | - Fix on messaging client not sending heartbeat on new conversations subsequent to the first conversation
|
276 | - Fix `ChatSDK.getConversationDetails()` not passing `authenticatedUserToken`
|
277 | - Fix `IC3Client.dispose()` called when `IC3Client` is `undefined`
|
278 |
|
279 | ### Changed
|
280 |
|
281 | - README: added examples on usages of the post chat APIs.
|
282 | - Uptake [@azure/communication-chat@1.1.1](https://www.npmjs.com/package/@azure/communication-chat/v/1.1.1)
|
283 | - Uptake [acs_webchat-chat-adapter@0.0.35-beta.2](https://unpkg.com/acs_webchat-chat-adapter@0.0.35-beta.2/dist/chat-adapter.js)
|
284 | - Update `locale` property in `ChatTranscriptBody` interface to be optional
|
285 | - Uptake [acs_webchat-chat-adapter@0.0.35-beta.4](https://unpkg.com/acs_webchat-chat-adapter@0.0.35-beta.4/dist/chat-adapter.js)
|
286 |
|
287 | ## [1.0.0] - 2021-10-08
|
288 |
|
289 | ### Added
|
290 |
|
291 | - Add `GetAuthToken` & `GetPreChatSurvey` telemetry events
|
292 | - Add `Domain` telemetry base property
|
293 | - Add `GetCurrentLiveChatContext`, `GetMessages`, `SendMessages`, `OnNewMessage` & `OnTypingEvent` telemetry events
|
294 | - Live Chat V2 Support
|
295 | - Add `PlatformDetails` telemetry event
|
296 |
|
297 | ### Changed
|
298 |
|
299 | - Uptake [@microsoft/ocsdk@0.3.0](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.3.0)
|
300 | - Uptake [@microsoft/omnichannel-ic3core@0.1.2](https://www.npmjs.com/package/@microsoft/omnichannel-ic3core/v/0.1.2)
|
301 |
|
302 | ### Fixed
|
303 |
|
304 | - `onNewMessage` with `rehydrate` flag set to `true` crashing when `getMessages` returns `undefined`
|
305 | - Fix `AriaTelemetry` unable to read property `logEvent` of undefined on `React Native`
|
306 | - Fix `Escalation to Voice & Video` library not being imported properly
|
307 |
|
308 | ## [0.3.0] - 2021-09-03
|
309 |
|
310 | ### Added
|
311 |
|
312 | - Persistent Chat Support
|
313 | - Chat Reconnect Support
|
314 | - Operating Hours Documentation
|
315 |
|
316 | ### Changed
|
317 |
|
318 | - Uptake [@microsoft/ocsdk@0.2.0](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.2.0)
|
319 | - Add `getCallingToken`
|
320 | - Send `ChannelId-lcw` message tag
|
321 | - Uptake [IC3Client@2021.08.14.1](https://comms.omnichannelengagementhub.com/release/2021.08.14.1/Scripts/SDK/SDK.min.js)
|
322 | - Uptake [botframework-webchat-adapter-ic3@0.1.0-master.2dba07b](https://www.npmjs.com/package/botframework-webchat-adapter-ic3/v/0.1.0-master.2dba07b)
|
323 | - Uptake [jest@27.1.0](https://www.npmjs.com/package/jest/v/27.1.0)
|
324 | - Update [@types/jest@27.0.1](https://www.npmjs.com/package/@types/jest/v/27.0.1)
|
325 | - Uptake [ts-jest@27.0.5](https://www.npmjs.com/package/ts-jest/v/27.0.5)
|
326 |
|
327 | ### Fixed
|
328 |
|
329 | - `msdyn_enablechatreconnect` not being parsed properly
|
330 | - Fix unable to start multiple conversations with same instance due to chat client being disposed
|
331 | - Pass logger to adapter
|
332 |
|
333 | ## [0.2.0] - 2021-04-30
|
334 |
|
335 | ### Added
|
336 |
|
337 | - React Native sample app using Omnichannel Chat SDK with [react-native-gifted-chat](https://github.com/FaridSafi/react-native-gifted-chat)
|
338 | - Escalation to Voice & Video support (Web Only)
|
339 | - React sample app using Omnichannel Chat SDK with [BotFramework-WebChat](https://github.com/microsoft/BotFramework-WebChat)
|
340 | - Expose `sessiontInit`'s `initContext` on `startChat`'s optional paramaters
|
341 | - Add ability to use custom `ic3Config` & `chatAdapterConfig`
|
342 | - Add telemetry
|
343 | - Add `rehydrate` flag for `onNewMessage` to rehydrate all messages of existing conversation
|
344 | - Add `getConversationDetails`
|
345 | - Add ability to pass custom `ariaTelemetryKey`
|
346 |
|
347 | ### Changed
|
348 |
|
349 | - Uptake [@microsoft/ocsdk@0.1.1](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.1.1)
|
350 | - Uptake [@microsoft/omnichannel-ic3core@0.1.1](https://www.npmjs.com/package/@microsoft/omnichannel-ic3core/v/0.1.1)
|
351 | - Uptake [jest@26.6.3](https://www.npmjs.com/package/jest/v/26.6.3)
|
352 | - Uptake [ts-jest@26.5.1](https://www.npmjs.com/package/ts-jest/v/26.5.1)
|
353 | - Uptake [IC3Client@2021.03.02.1](https://comms.omnichannelengagementhub.com/release/2021.03.02.1/Scripts/SDK/SDK.min.js)
|
354 | - Uptake [botframework-webchat-adapter-ic3@0.1.0-master.f4dfd7d](https://www.npmjs.com/package/botframework-webchat-adapter-ic3/v/0.1.0-master.f4dfd7d)
|
355 |
|
356 | ### Fixed
|
357 |
|
358 | - onAgentEndSession triggered on accept voice & video call
|
359 | - Fix multiple instances of IC3Client initialized
|
360 | - `uploadFileAttachment` failing on Web
|
361 |
|
362 | ### Security
|
363 |
|
364 | - Fix eslint errors
|
365 |
|
366 | ## [0.1.0] - 2020-10-26
|
367 |
|
368 | ### Added
|
369 |
|
370 | - Initial release of Omnichannel Chat SDK v0.1.0
|