Added:
- Amazon Connect Global Resiliency implementation. See Documentation-GR.md for details.
Added:
- Screen Sharing
- File transpilation
Added:
- typescript support for onSoftphoneSessionInit
- updated typescript definition for AttributeDictionary, SegmentAttributeDictionary, ReferenceDictionary
- typescript SYSTEM and ERROR types for AgentStateType
- Agent and Contact events subscriptions now return subscription
Added:
- Made change to prevent more than one login popup from appearing when an embedded CCP is opened in two or more tabs.
Added:
- Adding
AWS_WORKSPACE
as an option inVDIPlatform
Updated:
- Fixed
hasAnySearchParameter
in agent-app.js - Disabled request-storage-access by default - this was preventing search params from being passed into initApp
Added:
?visual-refresh=true
is used to access CCPUI's updated UI (aka Cloudscape)- Adding typing for
getChannelContext()
Updated:
- Updating
initApp
to allow customers to call the method with search parameters which originally wasn't a feature. This enables customers with custom workspaces to attach params such as?visual-refresh=true
or any values they wish to pass to this url.
Added:
initCCP
param to set custom ringtone for chat.initCCP
param to disable task ringtone.
Updated:
- Removed local storage check for login popups that was preventing popups from opening if the browser blocked the initial popup for permissions or if the customer closed the popup.
Added:
- Contact termination cleanup logic for embedded CustomViews widgets.
Updated:
- Fixed
connect.core.getFrameMediaDevices
API for iframed customer apps
Updated:
- Minor internal changes
Added:
- Permissions for Clipboard APIs when using embedded apps
getAgentARN
API
Features Introduced:
- Chat Enhanced Monitoring & Barge-In
Added functions:
contact.getActiveConnections
contact.hasTwoActiveParticipants
contact.silentMonitor
contact.bargeIn
chatConnection.isSilentMonitor
chatConnection.isBarge
chatConnection.isSilentMonitorEnabled
chatConnection.isBargeEnabled
chatConnection.getMonitorCapabilities
chatConnection.getMonitorStatus
Added:
- Citrix support
- New request-storage-access customization parameters
Added:
- API support for pausing and resuming tasks.
Updated:
- Linting changes
Bugs Fixed:
- Since version 2.6.2., terminating Streams and re-initializing would not instantiate the event handler, causing events to not be received via event subscriptions. This has been fixed in Version 2.10.0.
Added:
- Typescript support for getMonitorCapabilities and getMonitorStatus.
Updated:
- Refreshing iFrame every ccpLoadTimeout number of seconds while waiting for the user to be authenticated.
- Documentation Updates
Features Introduced:
- Video Calling
- SMS Chat
Updated:
- Renamed Wisdom to Amazon Q Connect
- Added optional param in initCCP for enabling earlyGum
Features Introduced:
- Quick Responses
Added:
- A new parameter to
storageAccess.custom
calledhideCCP
. This param is only applicable when usingmode: "custom"
for the request storage access banner and allows users to specify if CCP should be hidden after granting access whilst being able to customize the banner.
Added:
- Typing for the
onGrant
callback in RequestStorageAccess API
Added:
- Variable declaration for
ECHO_CANCELLATION_CHECK
.
Added:
- Support for the RequestStorageAccess page, which allows customer to consent to Connect's use of an authentication cookie after Chrome deprecates third-party cookies. Read More
Updated:
- request-storage-access url validation to include govcloud domains.
Updated:
- The callback function registered via
contact.onEnded
is no longer invoked when the contact is destroyed. This fix prevents the callback from being invoked twice onENDED
andDESTROYED
events.
Updated:
- Reset RSA access state on
connect.core.terminate
, fixing event subscription.
Added:
- A new parameter to
storageAccess.custom
calledhideCCP
. This param is only applicable when usingmode: "custom"
for the request storage access banner and allows users to specify if CCP should be hidden after granting access whilst being able to customize the banner.
Added:
- Typing for the
onGrant
callback in RequestStorageAccess API
Added:
- Variable declaration for
ECHO_CANCELLATION_CHECK
.
Added:
- Support for the RequestStorageAccess page, which allows customer to consent to Connect's use of an authentication cookie after Chrome deprecates third-party cookies. Read More
Updated:
- request-storage-access url validation to include govcloud domains.
Updated:
- Reverted update to documentation and api regarding
barge
andsilent_monitor
connection state types
Features Introduced:
- Introduced global resiliency APIs.
Updated:
chatConnection.getConnectionToken
to use current contactIdccpAckTimeout
,ccpSynTimeout
,ccpLoadTimeout
, anddisableEchoCancellation
definitions- Build files
Added:
- Adding the ability to disable echoCancellation
- Retries on polling calls for 401 or 403 errors
Updated:
- Improvements to CCP logging
- Ringtone improvements on iFrame refresh
Updated:
- Reset RSA access state on
connect.core.terminate
, fixing event subscription.
Added:
- A new parameter to
storageAccess.custom
calledhideCCP
. This param is only applicable when usingmode: "custom"
for the request storage access banner and allows users to specify if CCP should be hidden after granting access whilst being able to customize the banner.
- Added typing for the
onGrant
callback in RequestStorageAccess API
Important: This patched version is built off of v2.4.0. Added:
- Support for the RequestStorageAccess page, which allows customer to consent to Connect's use of an authentication cookie after Chrome deprecates third-party cookies. Read More
Added:
- Typescript support for monitor and barge functions.
Updated:
- Documentation for CustomViews.
Updated:
- Revert the AgentDataProvider change that was introduced in 2.4.1 and caused a performance degradation.
Updated:
- Minor README update for linked contact support with Step-by-Step guides.
Bugs Fixed:
- Fix an issue in Streams’ Voice ID APIs that may have led to incorrect values being set against the generatedSpeakerID field in the VoiceIdResult segment of Connect Contact Trace Records (CTRs).
Features Introduced:
- This version brings in updates that will provide enhanced monitoring experience to agents and supervisors, allowing to silently monitor multiparty calls, and if needed to barge in the call and take over control, mute agents, or drop them from the call. New APIs introduced with this feature are
isSilentMonitor
,isBarge
,isSilentMonitorEnabled
,isBargeEnabled
,isUnderSupervision
,updateMonitorParticipantState
,getMonitorCapabilities
,getMonitorStatus
,isForcedMute
.
Features Introduced:
- Introduce Amazon Connect Step-by-step guides embedding support via
connect.agentApp.initApp
.
Updated:
- Make StreamsJS compatible with strict mode
- Fix an issue that connect.ValueError and connect.StateError don't print error message properly
Added functions:
contact.getChannelContext
method to get the channel context for the contact. See Documentation.md for more detailsconnect.core.onAuthorizationSuccess
. See Documentation.md for more detailsconnect.core.onAuthorizeRetriesExhausted
andconnect.core.onCTIAuthorizeRetriesExhausted
methods, along with some backoff logic to the retries / page reloads for the CTI and authorize apis. Please see these methods' entries in Documentation.md for more information.
Added support for Task templates APIs.
Added functions:
contact.isMultiPartyConferenceEnabled
method to determine whether this contact is a softphone call and multiparty conference feature is turned on. See Documentation.md for more detailsconnect.core.onAuthorizationSuccess
. See Documentation.md for more detailsconnect.core.onAuthorizeRetriesExhausted
andconnect.core.onCTIAuthorizeRetriesExhausted
methods, along with some backoff logic to the retries / page reloads for the CTI and authorize apis. Please see these methods' entries in Documentation.md for more information.
Removed Functions:
agent.onContactPending
has been removed. Please usecontact.onPending
instead.
New build system:
Make
andgulp
have been removed andWebpack
has been added as the new build system.- Running
npm run release
will continue to produce bothrelease/connect-streams.js
andrelease/connect-streams-min.js
and run tests. npm run build-streams
will now produce the same files without running any tests.npm run test-mocha
will just run tests and relies on the release files.- Every command that runs a
gulp
script has been removed. - See the README for more details
Bugs Fixed:
connect.onError
now triggers. Previously, this api did not work at all. Please be aware that, if you have application logic within this function, its behavior has changed. See its entry in documentation.md for more details.initCCP
will no longer append additional embedded CCPs to the window when called multiple times. Please note that the use-case of initializing multiple CCPs withinitCCP
has never been supported by Streams, and this change has been added to prevent unpredictable behavior arising from such cases.
Features Introduced:
connect.core.onIframeRetriesExhausted
: Streams now performs backoff while attempting to reload the iframed CCP. Previously, it would endlessly retry on each ACK TIMEOUT event (connect.EventType.ACK_TIMEOUT
). Now, there are six retries, performed with exponential backoff. Once these six retries to load the embedded CCP are exhausted, no more retries will be attempted. You can subscribe a callback via the api:connect.core.onIframeRetriesExhausted
to understand when the retries are exhausted, and take some action.
Updated:
- Reset RSA access state on
connect.core.terminate
, fixing event subscription.
Added:
- A new parameter to
storageAccess.custom
calledhideCCP
. This param is only applicable when usingmode: "custom"
for the request storage access banner and allows users to specify if CCP should be hidden after granting access whilst being able to customize the banner.
Added:
- Support for the RequestStorageAccess page, which allows customer to consent to Connect's use of an authentication cookie after Chrome deprecates third-party cookies. Read More
Updated:
- request-storage-access url validation to include govcloud domains.
Updated:
- The callback function registered via
contact.onEnded
is no longer invoked when the contact is destroyed. This fix prevents the callback from being invoked twice onENDED
andDESTROYED
events.
Updated:
- Reset RSA access state on
connect.core.terminate
, fixing event subscription.
Added:
- A new parameter to
storageAccess.custom
calledhideCCP
. This param is only applicable when usingmode: "custom"
for the request storage access banner and allows users to specify if CCP should be hidden after granting access whilst being able to customize the banner.
Updated:
- request-storage-access url validation to include govcloud domain.
Features Introduced:
- A new media channel--tasks--has been added to Connect's offerings, alongside chat and voice. With this release, Streams, in conjunction with TaskJS now supports this feature with relevant apis, etc.
- VoiceId: You can find relevant apis for using the feature in the src/api.js file.
- Agent App features: Connect is expanding its agent-app offering with an agent application container called Agent App. Within agent app you can embed CCP UI, Customer Profiles UI, and Amazon Q Connect UI.
- onConnectionOpened and onConnectionClosed websocket manager apis were introduced.