Skip to content

Commit

Permalink
V5.24 (#214)
Browse files Browse the repository at this point in the history
* Adds v5.24 release notes (#141)

* Adds v5.24 release notes

* Removes extra line

* Adds AWS Workspace to medialess VDI documentation, fixes typo in v4->v5 announcement

* Adds hyperlinks to AWS Workspaces VDI in release notes

* Fixes typo in VDI documentation

* Pluralize VDI header

* Update wording in release notes for migrating CTI Flows

* Adds PM changes

* Update pdfs
  • Loading branch information
sderacy authored Aug 22, 2024
1 parent b9e11f4 commit b2fb542
Show file tree
Hide file tree
Showing 12 changed files with 67 additions and 19 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -314,7 +314,11 @@ listed (ex. v5.21.1), it will be grouped with with its major version unless othe
<th>CTI Adapter Version</th>
<th>Lambda Version</th>
</tr>
<tr>
<tr>
<td>v5.24</td>
<td>v5.22</td>
</tr>
<tr>
<td>v5.23.3</td>
<td>v5.22</td>
</tr>
Expand Down
15 changes: 12 additions & 3 deletions docs/classic/03-cti-adapter/15-medialess.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,17 @@ The Amazon Connect CTI Adapter enables the operation of a cloud contact center i

6. Ensure that the `Active` checkbox is checked, then hit Save.

### Set Up for CITRIX VDI Platform
### Setting Up Audio Optimized Virtual Desktop Infrastructures (VDI)

CTI Adapter enables agents to leverage Citrix remote desktop applications to offload audio processing to their local device and to automatically redirect audio to CTI Aadpter opened in remote application. In order to know about audio improvement in CCP using VDI, refer to [Amazon Connect audio optimization for Citrix cloud desktops](https://docs.aws.amazon.com/connect/latest/adminguide/using-ccp-vdi-citrix-step-by-step.html). Additionally, refer to [System Requirements](https://docs.aws.amazon.com/connect/latest/adminguide/using-ccp-vdi-citrix-step-by-step.html#using-ccp-vdi-citrix-step-by-step-requirements) for using the Citrix Unitied Communications SDK with Amazon Connect
The CTI Adapter enables agents to leverage Citrix and Amazon Workspaces remote desktop applications to offload audio processing to their local device and to automatically redirect audio to CTI Adapter opened in remote application.

#### Audio Optimization

- In order to know about audio improvement in CCP using Citrix VDI, refer to [Amazon Connect audio optimization for Citrix cloud desktops](https://docs.aws.amazon.com/connect/latest/adminguide/using-ccp-vdi-citrix-step-by-step.html). Additionally, refer to [System Requirements](https://docs.aws.amazon.com/connect/latest/adminguide/using-ccp-vdi-citrix-step-by-step.html#using-ccp-vdi-citrix-step-by-step-requirements) for using the Citrix United Communications SDK with Amazon Connect

- To learn more about how to optimize audio in Amazon Workspaces, refer to [AWS WorkSpace audio optimization support](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon_connect_support.html). Note that currently we only support integration with WSP Windows workspaces. Read [here](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html) to learn more.

#### CTI Adapter Configuration for VDI

Once the Citrix Workspace is ready to use, make the below changes in CTI Adapter which can be used in the workspace.

Expand All @@ -39,14 +46,16 @@ Once the Citrix Workspace is ready to use, make the below changes in CTI Adapter

5. Set the `AC Feature Name` to be VDIPlatform

6. Set the `Value` to be `Name:CITRIX`
6. Set the `Value` to be `Name:CITRIX` or `Name:AWS_WORKSPACE`.

a. Ensure that the `Active` checkbox is checked, then hit __Save__.

8. Refresh the browser tab and launch the SoftPhone to log in to CCP.

9. Verify the configuration by initiating a Voice contact.

#### Important Notes for Citrix Users

<div class="grey-box"> Note that once this feature is active in CTI Adapter, the CCP can be only used in a CITRIX environment, otherwise it will show an error as shown below.

<img src={useBaseUrl('/img/lightning/ccp-in-vdi-in-local.png')} />
Expand Down
2 changes: 1 addition & 1 deletion docs/classic/notices.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<img src={useBaseUrl("/img/lightning/image1.png")} />
</p>

<h3 align="center">July, 2024</h3>
<h3 align="center">August, 2024</h3>

*© Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: CC-BY-SA-4.0*

Expand Down
19 changes: 14 additions & 5 deletions docs/classic/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The CTI Adapter v5.21 now provides support for third party cookies (see [Amazon
2. When agents choose **Grant access**, the browser displays a prompt to authorize the use of third-party cookies.
3. Agents must select **Allow** on this second pop-up, and then proceed to log in.

**Note**: If the agent does not follow steps above, please see [our documentation](https://docs.aws.amazon.com/connect/latest/adminguide/admin-3pcookies.html#upgrade3p-agent-exp) on how to resolve.
**Note**: If the agent does not follow steps above, please see [our documentation](https://docs.aws.amazon.com/connect/latest/adminguide/admin-3pcookies.html#upgrade3p-agent-exp) on how to resolve.

#### Summer '23 Release
The Salesforce summer release '23 blocks Username-Password Flow by default (see more details [here](https://help.salesforce.com/s/articleView?id=release-notes.rn_security_username-password_flow_blocked_by_default.htm&release=244&type=5)). If your org uses this version of Salesforce, please unblock the flow by following [these](/docs/classic/installation/02-guided-setup#allowing-the-api-user-to-authenticate-using-password) instructions.
Expand All @@ -27,19 +27,28 @@ The Salesforce Spring '22 release introduces a change that will likely cause an
The Plan-B deprecation should not affect any current users of the CTI Adapter, as we utilize the embedded CCP and do not build in connect-rtc-js seperately.

#### Installing as Admin
Please **confirm that the application was installed for admins only** (see [installation](/docs/classic/installation/01-installation) for more details). If you did this by accident, then you will have to [manually edit the profiles](/docs/classic/installation/06-cti-adapter-installation-troubleshooting#how-to-remove-permissions-to-visualforce-pages-apex-classes-for-a-desired-profile) to remove the permissions to the objects and pages created by the app. If you are updating the package, please verify that all users have the proper AC permission set.
Please **confirm that the application was installed for admins only** (see [installation](/docs/classic/installation/01-installation) for more details). If you did this by accident, then you will have to [manually edit the profiles](/docs/classic/installation/06-cti-adapter-installation-troubleshooting#how-to-remove-permissions-to-visualforce-pages-apex-classes-for-a-desired-profile) to remove the permissions to the objects and pages created by the app. If you are updating the package, please verify that all users have the proper AC permission set. We strongly recommend when installing or upgrading to a new version of the CTI Adapter, customers thoroughly test the new version in a staging or test environment before deploying it to production to ensure compatibility and stability.

**Important:** when upgrading the CTI Adapter, please make sure that the Salesforce Lambdas are also updated to the newest version.
**Important:** When upgrading the CTI Adapter, please make sure that the Salesforce Lambdas are a [compatible version](/docs/classic/installation/04-salesforce-lambdas-manual-setup#compatibility-table). Also review the [CTI Adapter Installation Troubleshooting and Common Issues](/docs/classic/installation/06-cti-adapter-installation-troubleshooting) section for known issues and troubleshooting.

#### Migrating CTI Flows to CTI Adapter 5.0+
CTI Flows in v5.0+ replaces Lightning CTI Extensions in version v4.x allowing you to build your agent interface for both Lightning and Classic using a drag-and-drop UI. Many of the CTI blocks in CTI Flows correspond to the API calls in the previous Lightning CTI Extensions, making it easy to map them. However, your existing Lightning CTI Extension scripts will not be automatically migrated to CTI Flows. During the upgrade, you’ll have the option to download your existing scripts for reference as you rebuild them in CTI Flows. We highly recommend testing this version in a staging/non-production environment to ensure new CTI Flows match the functionality of your previous scripts. If you need additional functionality from your current scripts, please open a support ticket.

## 5.24 August 2024
- **Feature:** Amazon Workspaces Support: CTI Adapter now provides audio optimization for Amazon Workspaces. [See Documentation](/docs/classic/cti-adapter/15-medialess#setting-up-audio-optimized-virtual-desktop-infrastructure-vdi).
- **Bug Fix:** Fixed an issue where our Contact Channel Analytics Records would display an error prompt when viewed in the Lightning App Builder.
- **Bug Fix:** Fixed an issue where our Contact Channel interaction duration data would show erroneous values for missed calls.

## 5.23.3 July 2024
- **Enhancement:** A new value for Initiation method of a contact 'EXTERNAL_OUTBOUND` added as an item in the picklist for Contact Trace Records ([Link to AWS Documentaton](https://docs.aws.amazon.com/connect/latest/adminguide/ctr-data-model.html)).
- **Enhancement:** A new value for Initiation method of a contact 'EXTERNAL_OUTBOUND` added as an item in the picklist for Contact Trace Records ([Link to AWS Documentaton](https://docs.aws.amazon.com/connect/latest/adminguide/ctr-data-model.html)).
- **Enhancement:** Recording Controls: Resolved an issue where the recording controls feature would use the default named credential regardless of what was passed.
- **Bug Fix:** Fixed the issue of Call Recordings not being rendered on Tasks and Cases pages.
- **Bug Fix:** Fixed infinite buffering of Contact Lens Data on the Contact Channel Analytics page.

## 5.22 February 2024
- **Known Issue in v5.22 - Playback of Connect call recordings on Classic Task or Case:** If you are utilizing the CTI Adapter's functionality for enabling call recording streaming and playback on the Classic Task or Case page, we recommend not upgrading to CTI Adapter version 5.22 as we have discovered an issue where the playback of the call recording does not work as expected. The release v5.23.3 has the fix for this issue, and hence we advise customers to pause upgrading to v5.22.
- **Note:** If you wish to use the v5.22 lambdas, you will need to upgrade your CTI Adapter to v5.22. Consult the [compatibility chart](/docs/classic/installation/04-salesforce-lambdas-manual-setup#compatibility-table).
- **Feature:** Citrix Support: Enabled native VDI support for Citrix. [See Documentation](/docs/lightning/cti-adapter/14-medialess#set-up-for-citrix-vdi-platform).
- **Feature:** Citrix Support: Enabled native VDI support for Citrix. [See Documentation](/docs/classic/cti-adapter/15-medialess#setting-up-audio-optimized-virtual-desktop-infrastructure-vdi).
- **Feature:** Early Get User Media(GUM): Enabled support for the CCP feature EarlyGUM. [See Documentation](/docs/lightning/cti-adapter/01-cti-adapter-configuration#update-the-cti-adapter-details)
- **Feature:** Trigger multi-contact chat events: CTI Adapter enables users to trigger events on selected contact while handling multiple chats simultaneously. [See Documentation](cti-adapter/12-chat-widget-integration#trigger-multi-contact-chat-events).
- **Enhancement:** Amazon Q: Amazon Q has undergone a change and goes by a new name. As such, it has been reflected in our documentation. Here is the documentation for [Amazon Q](https://aws.amazon.com/q/)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -394,6 +394,10 @@ listed (ex. v5.21.1), it will be grouped with with its major version unless othe
<th>CTI Adapter Version</th>
<th>Lambda Version</th>
</tr>
<tr>
<td>v5.24</td>
<td>v5.22</td>
</tr>
<tr>
<td>v5.23.3</td>
<td>v5.22</td>
Expand Down
18 changes: 15 additions & 3 deletions docs/lightning/03-cti-adapter/14-medialess.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,19 @@ The Amazon Connect CTI Adapter enables the operation of a cloud contact center i

6. Ensure that the `Active` checkbox is checked, then hit Save.

### Set Up for CITRIX VDI Platform
### Setting Up Audio Optimized Virtual Desktop Infrastructures (VDI)

CTI Adapter enables agents to leverage Citrix remote desktop applications to offload audio processing to their local device and to automatically redirect audio to CTI Aadpter opened in remote application. In order to know about audio improvement in CCP using VDI, refer to [Amazon Connect audio optimization for Citrix cloud desktops](https://docs.aws.amazon.com/connect/latest/adminguide/using-ccp-vdi-citrix-step-by-step.html). Additionally, refer to [System Requirements](https://docs.aws.amazon.com/connect/latest/adminguide/using-ccp-vdi-citrix-step-by-step.html#using-ccp-vdi-citrix-step-by-step-requirements) for using the Citrix Unitied Communications SDK with Amazon Connect
The CTI Adapter enables agents to leverage Citrix and Amazon Workspaces remote desktop applications to offload audio processing to their local device and to automatically redirect audio to CTI Adapter opened in remote application.

#### Audio Optimization

- In order to know about audio improvement in CCP using Citrix VDI, refer to [Amazon Connect audio optimization for Citrix cloud desktops](https://docs.aws.amazon.com/connect/latest/adminguide/using-ccp-vdi-citrix-step-by-step.html). Additionally, refer to [System Requirements](https://docs.aws.amazon.com/connect/latest/adminguide/using-ccp-vdi-citrix-step-by-step.html#using-ccp-vdi-citrix-step-by-step-requirements) for using the Citrix United Communications SDK with Amazon Connect

- To learn more about how to optimize audio in Amazon Workspaces, refer to [AWS WorkSpace audio optimization support](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon_connect_support.html). Note that currently we only support integration with WSP Windows workspaces. Read [here](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html) to learn more.

#### CTI Adapter Configuration for VDI

Once the Citrix Workspace is ready to use, make the below changes in CTI Adapter which can be used in the workspace.

1. Log in to Salesforce instance

Expand All @@ -36,14 +46,16 @@ CTI Adapter enables agents to leverage Citrix remote desktop applications to off

5. Set the `AC Feature Name` to be VDIPlatform

6. Set the `Value` to be `Name:CITRIX`
6. Set the `Value` to be `Name:CITRIX` or `Name:AWS_WORKSPACE`.

a. Ensure that the `Active` checkbox is checked, then hit __Save__.

8. Refresh the browser tab and launch the SoftPhone to log in to CCP.

9. Verify the configuration by initiating a Voice contact.

#### Important Notes for Citrix Users

<div class="grey-box"> Note that once this feature is active in CTI Adapter, the CCP can be only used in a CITRIX environment, otherwise it will show an error as shown below.

<img src={useBaseUrl('/img/lightning/ccp-in-vdi-in-local.png')} />
Expand Down
2 changes: 1 addition & 1 deletion docs/lightning/notices.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
<img src={useBaseUrl('/img/lightning/image1.png')} />
</p>

<h3 align="center">July, 2024</h3>
<h3 align="center">August, 2024</h3>

*© Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: CC-BY-SA-4.0*

Expand Down
Loading

0 comments on commit b2fb542

Please sign in to comment.