@microsoft/omnichannel-chat-sdk 1.0.1-main.85b823d → 1.0.1-main.9e71fa6

package/CHANGELOG.md

@@ -4,12 +4,29 @@ All notable changes to this project will be documented in this file.
 ## [Unreleased]
 
 ### Added
-- Add Post Chat Survey Support
-- Add `getPostChatSurveyContext` & `initializePostChatRenderer` and `renderPostChatSurvey` API methods
-- Add `GetPostChatSurveyContext`, `RenderPostChatSurvey`, and `InitializePostChatRenderer` telemetry events
+- Add `getPostChatSurveyContext` API method
+- Add `GetPostChatSurveyContext` telemetry event
+- Add `widgetId` & `clientMessageId` as metadata on sending message
+- Update `ChatConfig` interface with `LiveChatVersion`, `allowedFileExtensions` & `maxUploadFileSize` properties
+- Add ability to automatically detect locale from chat config
+- Add `runtimeId` attribute in `OmnichannelChatSDK` & `ChatSDKRuntimeId` field in telemetry
+- Add ability to automatically pass locale from chat config on calling `ChatSDK.emailLiveChatTranscript()`
+- Bubble up `WidgetUseOutsideOperatingHour` exception
+- Add `acs_webchat-chat-adapter` middleware to add default `channelData.tags` & `channelData.metadata`
+- Update `ChatConfig` interface with `msdyn_enablemarkdown` property
+
+### Fix
+- Add `acs_webchat-chat-adapter` middlewares to format `channelData.tags`
+- Skip `session init` call on existing conversation
+- Fix `chat reconnect` not ending the conversation on calling `ChatSDK.endChat()`
+- Fix on messaging client not sending heartbeat on new conversations subsequent to the first conversation
+- Fix `ChatSDK.getConversationDetails()` not passing `authenticatedUserToken`
+- Fix `IC3Client.dispose()` called when `IC3Client` is `undefined`
 
 ### Changed
 - README: added examples on usages of the post chat APIs.
+- Uptake [@azure/communication-chat@1.1.1](https://www.npmjs.com/package/@azure/communication-chat/v/1.1.1)
+- 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)
 
 ## [1.0.0] - 2021-10-08
 ### Added

package/README.md

@@ -14,7 +14,7 @@ Please make sure you have a chat widget configured before using this package or
 - [Installation on React Native](#installation-on-react-native)
 - [API Reference](#api-reference)
 - [API Examples](#api-examples)
-- [Sample Apps](samples/)
+- [Sample Apps](https://github.com/microsoft/omnichannel-chat-sdk-samples)
 - [Common Scenarios](#common-scenarios)
 - [Feature Comparisons](#feature-comparisons)
 - [Telemetry](#telemetry)
@@ -35,14 +35,12 @@ Omnichannel offers an live chat widget (LCW) by default. You can use the Chat SD
 | Bring Your Own Widget | ❌ | ✔ | |
 | Web Support | ✔ | ✔ |
 | React Native Support | ❌ | ✔ |
-| Escalation to Voice & Video | ✔ | Web Only |
-| Co-browse | ✔ | Web Only |
-| Screen Sharing | ✔ | Web Only |
+| Escalation to Voice & Video | ✔ | ✔ | Only supported on Web |
+| Co-browse | ✔ | 3rd party add-on | Only supported on Web |
+| Screen Sharing | ✔ | 3rd party add-on | Only supported on Web |
 | Authenticated Chat | ✔ | ✔ |
 | Pre-chat Survey | ✔ | ✔ |
-| Post-chat Survey | ✔ | Web Only for In-line Render |
-| Queue Position | ✔ | ✔ |
-| Average Wait Time | ✔ | ✔ |
+| Post-chat Survey | ✔ | ✔ |
 | Download Transcript | ✔ | ✔ |
 | Email Transcript | ✔ | ✔ |
 | Data Masking | ✔ | ✔ |
@@ -52,6 +50,8 @@ Omnichannel offers an live chat widget (LCW) by default. You can use the Chat SD
 | Persistent Chat | ✔ | ✔ |
 | Chat Reconnect | ✔ | ✔ |
 | Operating Hours | ✔ | ✔ |
+| Queue Position | ✔ | ✔ | No SDK method. Handled as *system message* |
+| Average Wait Time | ✔ | ✔ | No SDK method. Handled as *system message* |
 
 **\*** BYOI: Bring Your Own Implementation
 
@@ -65,7 +65,26 @@ Omnichannel offers an live chat widget (LCW) by default. You can use the Chat SD
 
 The following steps will be required to run Omnichannel Chat SDK on React Native:
 
-1. Run `npm install node-libs-react-native --save-dev`
+1. Install `node-libs-react-native`
+    ```
+    npm install node-libs-react-native --save-dev
+    ```
+
+1. Install `react-native-randomBytes`
+    ```
+    npm install react-native-randombytes --save-dev
+    ```
+
+1. Install `react-native-get-random-values`
+    ```
+    npm install react-native-get-random-values --save-dev
+    ```
+
+1. Install `react-native-url-polyfill`
+    ```
+    npm install react-native-url-polyfill --save-dev
+    ```
+
 1. Update *metro.config.js* to use React Native compatible Node Core modules
     ```ts
     module.exports = {
@@ -80,24 +99,11 @@ The following steps will be required to run Omnichannel Chat SDK on React Native
     };
     ```
 
-1. Import 'node-libs-react-native/globals' on top of your entry point file
+1. Add following *import* on top of your entry point file
     ```ts
     import 'node-libs-react-native/globals';
-    ```
-
-1. Install `react-native-randomBytes`
-    ```
-    npm install react-native-randombytes --save-dev
-    ```
-
-1. Install `react-native-get-random-values`
-    ```
-    npm install react-native-get-random-values --save-dev
-    ```
-
-1. Import `react-native-get-random-values` on top of your entry point file
-    ```ts
     import 'react-native-get-random-values';
+    import 'react-native-url-polyfill';
     ```
 
 ## API Reference
@@ -125,12 +131,9 @@ The following steps will be required to run Omnichannel Chat SDK on React Native
 | OmnichannelChatSDK.getLiveChatTranscript() | Get transcript data (JSON) | |
 | OmnichannelChatSDK.uploadFileAttachment() | Send file attachment | |
 | OmnichannelChatSDK.downloadFileAttachment() | Download file attachment | |
-| OmnichannelChatSDK.createChatAdapter() | Get IC3Adapter | **Web only** |
+| OmnichannelChatSDK.createChatAdapter() | Get Chat Adapter | **Web only** |
 | OmnichannelChatSDK.getVoiceVideoCalling() | Get VoiceVideoCall SDK for Escalation to Voice & Video | **Web only** |
-| OmnichannelChatSDK.getPostChatSurveyContext() | Get post chat survey link and locale | |
-| OmnichannelChatSDK.initializePostChatRenderer() | Load necessary scripts and styles to render the FormsPro survey | **Web only** |
-| OmnichannelChatSDK.renderPostChatSurvey() | Render the FormsPro survey | **Web only** |
-
+| OmnichannelChatSDK.getPostChatSurveyContext() | Get post chat survey link, survey locale, and whether an agent has joined the survey | |
 
 ## API examples
 
@@ -208,31 +211,18 @@ The following steps will be required to run Omnichannel Chat SDK on React Native
     const preChatSurvey = await getPreChatSurvey(parseToJSON); // Adaptive Cards payload data as string
 ```
 
-### Show PostChat Survey
-`Option 1: Directly use the survey link`
+### Get PostChat Survey
 ```ts
     try {
         const context = await chatSDK.getPostChatSurveyContext();
-        if (context?.participantJoined) { // participantJoined will be true if an agent has joined the conversation, or a bot has joined the conversation and the bot survey flag has been turned on on the admin side.
-            const linkToSend = context.surveyInviteLink + "&lang=" + context.formsProLocale;
-            // This link is accessible and will redirect to the survey in another tab. Use it as you see fit.
+        if (context.participantJoined) { // participantJoined will be true if an agent has joined the conversation, or a bot has joined the conversation and the bot survey flag has been turned on on the admin side.
+            // formsProLocale is the default language you have set on the CustomerVoice portal. You can override this url parameter with any locale that CustomerVoice supports.
+            // If "&lang=" is not set on the url, the locale will be English.
+            const linkToSend = context.surveyInviteLink + "&lang=" + context.formsProLocale; 
+            // This link is accessible and will redirect to the survey page. Use it as you see fit.
         }
     } catch (ex) {
-        // If the post chat should not show by any reason (e.g. post chat is not enabled), promise will be rejected.
-    }
-```
-
-`Option 2: Render the FormsPro Survey in a specified container`
-```ts
-    await chatSDK.initializePostChatRenderer(); // This method is needed to embed FormsPro survey in the widget. It can be called anytime before actually rendering the survey for best performance of you page.
-
-    try {
-        const context = await chatSDK.getPostChatSurveyContext();
-        if (context?.participantJoined) {
-            await chatSDK?.renderPostChatSurvey('containerId', context); // The survey will be embedded in the element with Id "containerId"
-        }
-    } catch (ex) {
-
+        // If the post chat should not be shown by any reason (e.g. post chat is not enabled), promise will be rejected.
     }
 ```
 
@@ -345,8 +335,7 @@ The following steps will be required to run Omnichannel Chat SDK on React Native
 ```ts
     const body = {
         emailAddress: 'contoso@microsoft.com',
-        attachmentMessage: 'Attachment Message',
-        locale: 'en-us'
+        attachmentMessage: 'Attachment Message'
     };
     await chatSDK.emailLiveChatTranscript(body);
 ```

package/lib/OmnichannelChatSDK.d.ts

@@ -1,5 +1,6 @@
 import ACSClient from "./core/messaging/ACSClient";
 import { ParticipantsRemovedEvent } from '@azure/communication-signaling';
+import ChatAdapterOptionalParams from "./core/messaging/ChatAdapterOptionalParams";
 import ChatConfig from "./core/ChatConfig";
 import ChatReconnectContext from "./core/ChatReconnectContext";
 import ChatReconnectOptionalParams from "./core/ChatReconnectOptionalParams";
@@ -20,10 +21,10 @@ import LiveWorkItemDetails from "./core/LiveWorkItemDetails";
 import OmnichannelConfig from "./core/OmnichannelConfig";
 import OmnichannelMessage from "./core/messaging/OmnichannelMessage";
 import OnNewMessageOptionalParams from "./core/messaging/OnNewMessageOptionalParams";
-import PostChatContext from "./core/PostChatContext";
 import StartChatOptionalParams from "./core/StartChatOptionalParams";
 declare class OmnichannelChatSDK {
     private debug;
+    runtimeId: string;
     OCSDKProvider: unknown;
     IC3SDKProvider: unknown;
     OCClient: any;
@@ -33,6 +34,7 @@ declare class OmnichannelChatSDK {
     omnichannelConfig: OmnichannelConfig;
     chatSDKConfig: ChatSDKConfig;
     isInitialized: boolean;
+    localeId: string;
     requestId: string;
     private chatToken;
     private liveChatConfig;
@@ -80,15 +82,14 @@ declare class OmnichannelChatSDK {
     downloadFileAttachment(fileMetadata: FileMetadata | IFileMetadata): Promise<Blob>;
     emailLiveChatTranscript(body: ChatTranscriptBody): Promise<any>;
     getLiveChatTranscript(): Promise<any>;
-    createChatAdapter(protocol?: string | null): Promise<unknown>;
+    createChatAdapter(optionalParams?: ChatAdapterOptionalParams): Promise<unknown>;
     getVoiceVideoCalling(params?: any): Promise<any>;
     getPostChatSurveyContext(): Promise<any>;
-    initializePostChatRenderer(): Promise<void>;
-    renderPostChatSurvey(containerId: string, postChatContext: PostChatContext): Promise<void>;
     private getIC3Client;
     private getChatConfig;
     private resolveIC3ClientUrl;
     private resolveChatAdapterUrl;
     private updateChatToken;
+    private setAuthTokenProvider;
 }
 export default OmnichannelChatSDK;