Documentation:PSAAS:RN:GW:Public

Genesys Widgets

Note: Not all changes listed below may pertain to your deployment.

• June 24, 2019 (9.0.013.06)
• June 7, 2019 (9.0.013.03)
• May 24, 2019 (9.0.013.02)
• May 14, 2019 (9.0.011.01)
• April 17, 2019 (9.0.010.02)
• March 27, 2019 (9.0.009.06)
• March 21, 2019 (9.0.009.04)
• February 4, 2019 (9.0.008.04)
• January 28, 2019 (9.0.007.09)
• January 3, 2019 (9.0.007.08)
• December 20, 2018 (9.0.007.07)
• October 25, 2018 (9.0.006.02)
• September 26, 2018 (9.0.005.00)
• September 5, 2018 (9.0.004.03)
• July 27, 2018 (9.0.003.03)
• Known Issues
• Archive

June 24, 2019 (9.0.013.06)

What's New

WebChat

• Added a new avatar icon for chat bots to WebChat.
• Added support for Markdown text formatting in WebChat.

Resolved Issues

• Localization text is now available for the Wait Time units in the Channel Selector plugin. (CXW-2279)
• When a Chat is ended due to user inactivity, the "idle close" message now displays as expected. (CXW-2295)
• WebChat Widget now supports displaying contentType notification messages as normal text messages. (CXW-2318)
• The input label "When should we call you?" in Callback Widget now displays correctly. Previously, in some scenarios, this label would not display. (CXW-2326)
• Fixed the link to launch Co-browse from the CallUs widget. Now it correctly starts a Co-browse session when the link is clicked. (CXW-2337)
• When using the soft scrollbar in the Async WebChat window, the user scroll is now properly detected. Previously, old messages could not be fetched when scrolling. (CXW-2341)
• The colors of the Warning and Alert icons for the Estimated Wait Time now display correctly in Channel Selector. (CXW-2370)

June 7, 2019 (9.0.013.03)

What's New

Resolved Issues

• Widgets Lazy Load bundles now integrate properly with websites that use Webpack. Previously, in certain instances, errors in the console would appear when using Webpack.

May 24, 2019 (9.0.013.02)

What's New

Invites

• Invites created by the Engage plugin can now be programmatically revoked after they have been presented.

Mobile Devices

• WebChat Widget can now restore in a minimized state during a new page load on mobile devices.

Cookie options

• A new configuration option, cookieOptions, has been added that enables you to modify Widgets cookie options at the global level.

Resolved Issues

• In WebChatService, the AgentConnected and AgentDisconnected events are now always correctly published. (CXW-2303)
• The Callback and ClicktoCall widgets now correctly display the form when maximized. Previously, when maximized to full screen after device re-orientation, the form was not * * In mobile devices, the Callback Widget now correctly shows only the available time slots when hideUnavailableTimeSlots configuration option is enabled. Previously, this configuration option in the Calendar plugin was ignored and the unavailable time slots were still displayed. (CXW-2276)

May 14, 2019 (9.0.011.01)

What's New

Resolved Issues

• The WebChat.submitted event now contains the form metadata object. Previously, the form data was missing in the submitted event. (CXW-2275)

April 17, 2019 (9.0.010.02)

What's New

CDN URLs

• Widgets are now available via new Public Content Delivery Network (CDN) regional URLs. The previous CDN URLs are deprecated and may not be accessible. Customers are encouraged to migrate to new CDN URLs, as the legacy URLs at app.genesys.cloud may be disabled in future, and will not be kept up to date with any later versions.

Engagement

• The new Engagement Widget is now available to support use cases for Proactive Engagements triggered by Altocloud.

Resolved Issues

• Callback Widget now correctly displays one error dialog box at a time. Previously, in some cases, multiple dialog boxes would appear at the same time. (CXW-2224)

March 27, 2019 (9.0.009.06)

What's New

Resolved Issues

• Localization strings are now correctly applied to the chat invite triggered by the command WebChat.invite. (CXW-2182)
• The Chat Widget no longer auto-zooms in the iOS mobile Safari browser when a user taps on any input field. (CXW-2158)

March 21, 2019 (9.0.009.04)

What's New

Offers Widget

• Offers Widget is updated with new features, layouts, and improvements.

Dynamic polling

• WebChat's GMS REST mode now utilizes dynamic polling instead of a fixed 3-second poll rate. The poll rate increases when the user sends messages and decreases over time as they become idle. This increases responsiveness for the user without overburdening the server. (CXW-2167)

Resolved Issues

• Chat arrow bubbles and messages now display correctly in the WebChat Widget during an active chat session. Previously, in some scenarios, they appeared misaligned. (CXW-2162)

February 4, 2019 (9.0.008.04)

What's New

PureEngage Cloud v3 API

• WebChat Widget now supports PureEngage Cloud v3 API via the WebChat transport configuration option.

Resolved Issues

• Fixed an issue where Quick Replies would not appear due to a JavaScript error. Previously, the error "SCRIPT438: Object doesn't support property or method 'toLowerCase'" would appear when attempting to generate quick replies. (CXW-2077)
• WebChat bubble arrows are now displaying correctly by properly pointing to either the Agent or the Customer in the active Chat transcript window. Previously, the bubble arrows were slightly misaligned. (CXW-2071)

January 28, 2019 (9.0.007.09)

What's New

Resolved Issues

• Callback Calendar time slots now display correctly based on the availability. Previously, when choosing between days, some of the available time slots were shown as disabled. (CXW-2124)

January 3, 2019 (9.0.007.08)

What's New

Resolved Issues

• Widgets now displays the WebChat Widget correctly when it receives the appropriate Genesys Web Engagement notifications. Previously, for some Web Engagement notification events, the WebChat Widget would not be displayed. (CXW-2075)

December 20, 2018 (9.0.007.07)

What's New

Public CDN URLs

• Widgets are now accessible via Public CDN URLs. This includes both All-in-one and Lazy loading bundles.

Resolved Issues

• WebChat Widget now correctly listens to the inactivity timeout event from the Chat Server and ends the chat session. Previously, the chat session could not be ended at the right time when the inactivity timeout had occurred. (CXW-1920)

• The custom form in WebChat Widget now opens correctly in the Lazy Load mode. Previously, when opening the WebChat for the first time, it would not display the configured custom form. (CXW-1947)

October 25, 2018 (9.0.006.02)

What's New

Deployment IDs

• Genesys Widgets now supports Deployment IDs. This allows you to specify multiple configurations, each with a unique deployment ID that prevents cookies and other session data from carrying over to a page with a different deployment ID. For example, you can use one deployment ID for your public site and one deployment ID for users who are logged in, to prevent an authenticated chat from restoring after the user logs out.

Resolved Issues

• Callback Widget now correctly shows the selected country code for the phone number field. Previously, deleting a phone number from the callback entry would also remove the country code and it could not be re-added. (CXW-1828)

• The originalMessage sub-property now contains the original, unaltered message data from the server. Previously, the event WebChat.messageReceived returned the wrong value for the sub-property. (CXW-1907)

• Cross-browser compatibility has now been optimized for Callback Widget. (CXW-1889)

September 26, 2018 (9.0.005.00)

What's New

API compatibility

• Widgets is now compatible with PureEngage Cloud Engagement / Estimated-wait-time API (/engagement/v3/estimated-wait-time), for accessing Estimated Wait Time in PureEngage Cloud.
• Widgets is now compatible with PureEngage Cloud Engagement / Callbacks API (/engagement/v3) for requesting and booking of Callback requests.

Resolved Issues

• Offers Widget now functions correctly according to its configuration documentation. (CXW-1815)

September 5, 2018 (9.0.004.03)

What's New

Estimated wait time

• Genesys Widgets now supports fetching estimated wait time (EWT) for a single virtual-queue or for a group of virtual-queues.

Cookies

• A fully qualified domain name (FQDN) is no longer required for cookies to persist across page refreshes. Test environments like localhost or direct IP addresses are now compatible with our cookies. Previously, cookie-based features like WebChat restore would not function on a site without a FQDN.

Resolved Issues

• The Authorization header is now passed correctly when lazy-loading Genesys Widgets. (CXW-1793)

July 27, 2018 (9.0.003.03)

What's New

Lazy-load plugins

• Genesys Widgets can now automatically lazy-load plugins from separate files, instead of loading one large file containing all plugins.

Usability

• Improved scrollbar usability across platforms.

Before method

• A new "before()" method in CXBus plugins allows you to trigger actions before a chosen command executes, manipulate options passed to the command, or block execution of the command.

Toaster plugin

• The Toaster plugin has a new event, Toaster.opened, that is published when a toast is opened.

Resolved Issues

• The SendMessage widget now correctly displays the OK button in alert dialogs. Previously, this button might have displayed as EmailOk. (CXW-1735)

• JavsScript use strict mode no longer triggers an error when using a dropdown in a custom form. (CXW-1734)

• This release disables the plugins configuration array in _genesys.widgets.main. Previously, using this array might have caused unexpected JavaScript errors. (CXW-1731)

• Dropdowns and textareas no longer reset to text inputs when using the custom form feature. (CXW-1710)

• Genesys Widgets now correctly collects and transmits user agent details for Microsoft Internet Explorer 10/11 and Edge browsers. This allows chat sessions to receive more accurate user agent details for these browsers. (CXW-1697)

Known Issues

There are currently no known issues.

Archive

[+] Click to show archived release notes

June 26, 2018 (9.0.002.06)

What's New

Interaction Lifecycle Event

• Each widget now publishes a new Interaction Lifecycle Event (“submitted”) whenever a form is submitted by a visitor. This event includes standard lifecycle metadata including the Form Registration data submitted by a visitor when starting a new interaction (WebChat and Callback). This can be used for more accurate client-side JavaScript logic alongside other Interaction Lifecycle Events published by Widgets.

May 11, 2018 (9.0.001.04)

What's New

Resolved Issues

• The Offers Widget now provides an option to use client-side localization. (CXW-1354)

• Fixed an issue in custom forms where the check box input type was not sending the appropriate selected value. Previously, even though the Send transcript check box was deselected, Widgets would still send the user data. (CXW-1391)

• Fixed an issue where localization override was not happening as expected. Previously, the default localization strings were absent for Webchat and Callback resulting in an App.setLanguage error in the browser console.(CXW-1394)

• The Callback Widget is now redesigned to appear as docked in the bottom-right of the web page for desktop browsers. Additionally, you can customize labels and input fields in the registration form so they can be propagated as Key Value Pairs (KVP) to the Callback API. (CXW-1404)

• Fixed URL messages displayed in WebChat. Previously, in certain instances, WebChat was truncating part of the URL text. (CXW-1514)

March 28, 2018 (9.0.000.10)

What's New

Resolved Issues

• The ChannelSelector Widget now properly hides the unavailable channels in mobile mode. Previously, in mobile mode, when the Estimated Waiting Time for a channel was set to a value greater than its maximum threshold value configured, ChannelSelector would not hide the channel. (CXW-1353)

• The Callback Widget now properly displays the available time slots in mobile mode. Previously, clicking Today would not correctly display the available time slots for that day. (CXW-1341)

March 7, 2018 (9.0.000.08)

What's New

New design

• The new design of the Chat Widget provides improved usability:
  • New input area and Send button to submit new messages
  • Easier access to in-app Chat features like Emojis
  • New Chat avatars and Chat bubbles layout
  • Improved Inactivity Timeout handling
  • New character counter which highlights when 10 or fewer characters remain
• Widgets is updated with new, improved Agent icon.

Offers Widget

• The new Offers Widget is now available to offer advertising or marketing content to site visitors, and redirect to the appropriate URL. Multiple content layouts are available, including the capability to show text, images, and embed video from external sources such as YouTube and Vimeo.

Resolved Issues

• Improved ESC key accessibility in the Callback Widget. Previously, in certain instances, the Widgets UI would disappear after pressing the ESC key. (CXW-1302)

• Corrected the display of the Emoji menu after restoring chat. Previously, in certain instances, the use of emjois was enabled when reconnecting after a connection was lost, even though this feature was not enabled in the configuration. (CXW-1257)

• Improved error messages in the Callback Widget. Previously, in certain instances, the Callback Widget was not displaying the error dialog box. (CXW-1306)

• Optimized callback scheduling in the Callback Widget. Previously, in the Callback widget, when "As soon as possible" was selected, the variable _desired_time was wrongly sent to the server in the network request. (CXW-1283)

January 2, 2018 (8.5.009.03)

What's New

Icon dimensions

• Optimized icon dimensions throughout Genesys Widgets.

Resolved Issues

• Resolved an issue in WebChat where using arrow keys were ineffective in the message input. Previously, navigation with the arrow keys was not possible in the chat registration form. (CXW-1197)
• Resolved an issue where new messages received while WebChat is in a minimized state may not be visible after expanding WebChat. Previously, iscroll was not updated after the agent ended the chat while the chat was minimized. (CXW-1221)
• Resolved issue where the typing notification notice could be sent repeatedly under certain circumstances. Previously, the Widget would continue to send "typing off" notices even after the chat session had ended. (CXW-1215)
• Updated Genesys Widget's internal jQuery instance to the next stable version, which includes security patches. (CXW-1156)

November 14, 2017 (8.5.008.08)

What's New

WebChat registration forms

• You can now build customized WebChat registration forms.

Sidebar widget

• A new Sidebar widget is available for mobile and desktop browsers, enabling users to trigger any widget from a customizable list of Widgets icons.

Browser Support

• Microsoft Edge

October 10, 2017 (8.5.007.03)

What's New

• WebChat widget now exposes new parameter maxMessageLength to limit the length of messages sent during a chat session.

August 18, 2017 (8.5.006.07)

What's New

Re-branding

• Redesigned Genesys Widgets with new icons and Genesys logo to align with new Genesys branding.

Country Code flag icons

• Removed country code flag icons used by Callback Widget in the phone number field to reduce Cascading Style Sheet (CSS) download size.

Classnames

• Prefixed CSS classnames with "cx-" to avoid conflicting classnames on host site.

Optimized CSS

• Optimized CSS throughout to reduce download size.

July 28, 2017 (8.5.005.30)

What's New

New widgets

• Widgets exposed to PureEngage Cloud Customers now include:

  Callback capability - this enables Customers to request an Immediate or Scheduled Callback to their phone number. Two new widgets are provided: Callback and CallbackService.

  Calendar capability - this widget enables customization of the Calendar UI.

• WebChat and ChannelSelector widgets provide improved behavior on desktop browsers, as the scrollbar can now be used to scroll the widget's content accordingly.

April 17, 2017 (8.5.005.08)

What's New

Resolved Issues

• The webchat submit buttons no longer overlap into the footer area when viewing webchat in landscape mode on small mobile device screens. (CXW-631)

• WebChat's confirm before closing dialog prompt (which is enabled by default) now only appears while the user is filling out the registration form and only if information has been entered into some of the fields. (CXW-755)

February 15, 2017 (8.5.004.26)

What's New

Co-browsing assist

• Customers who are on a phone call will now be able to request co-browsing assistance from the agent via the Channel Selector widget. Customers on chat can continue to start co-browse directly from the Chat Widget.