Difference between revisions of "WID/HIW"

From Genesys Documentation
Jump to: navigation, search
m (Reverted edits by Ed.jamer@genesys.com (talk) to last revision by Chrissyforrest)
(Tag: Rollback)
(Published)
Line 1: Line 1:
 
{{HIW
 
{{HIW
|DisplayName=How Widgets works
+
|product=Draft:WID
 +
|Standalone=Yes
 +
|DisplayName=How Genesys Widgets works
 
|TocName=How Widgets works
 
|TocName=How Widgets works
|Context=Learn how Genesys Widgets works.
+
|Context=Genesys Widgets relies on certain technologies in order to function. This article describes the requirements for widget implementation.
 
|ComingSoon=No
 
|ComingSoon=No
 
|Platform=GenesysEngage-cloud
 
|Platform=GenesysEngage-cloud
Line 12: Line 14:
 
Genesys Widgets is a set of APIs that provides specific types of user interface elements—normally referred to as ''widgets''—and the services to drive them, enabling you to enhance your website with chat or callback, or your own customized contact center functionality.
 
Genesys Widgets is a set of APIs that provides specific types of user interface elements—normally referred to as ''widgets''—and the services to drive them, enabling you to enhance your website with chat or callback, or your own customized contact center functionality.
  
[[File:Webchat main new.jpg|750x750px]]
+
[[File:Webchat main new.jpg|750x750px|link=https://all.docs.genesys.com/File:Webchat_main_new.jpg]]
|featureoverview=Genesys Widgets is built on top of the {{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=GWCBusAPIOverview|display text=CXBus}} messaging bus. CXBus uses the {{#Widget:ExtLink|link=https://en.wikipedia.org/wiki/Publish%E2%80%93subscribe_pattern|displaytext=publish–subscribe pattern}} to facilitate communication between the Widgets components, all of which are ''plugins'' that can both ''publish'' events on the bus and ''subscribe'' to the events they are interested in.
+
|featureoverview=Genesys Widgets is built on top of the {{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=GWCBusAPIOverview|display text=CXBus}} messaging bus. CXBus uses the [https://en.wikipedia.org/wiki/Publish%E2%80%93subscribe_pattern publish–subscribe pattern] to facilitate communication between the Widgets components, all of which are ''plugins'' that can both ''publish'' events on the bus and ''subscribe'' to the events they are interested in.
  
With the help of the Widgets-Core plugins, CXBus makes it possible to combine the logic implemented by user interface plugins, service plugins, and utility plugins into cohesive products that can provide chat sessions, schedule callbacks, and so on.
+
With the help of the Widgets-Core plugins, CXBus makes it possible to combine the logic implemented by user interface plugins, service plugins, and utility plugins into cohesive products that can provide chat sessions, schedule callbacks, and so on.[[File:Widgets-architecture.png|center|600x600px|link=https://all.docs.genesys.com/File:Widgets-architecture.png]]
[[File:Widgets-architecture.png|center|600x600px]]
+
|HIWSection={{HIWSection
<br />
+
|HIWSectionHeading=Widgets behavior
===CXBus===
+
|HIWSectionAlignment=Vertical
This messaging bus allows you to create your own plugins with a namespaced API consisting of commands, events, and a data model. CXBus also loads your plugins and resources—either manually or automatically. Every other component in Genesys Widgets is a CXBus plugin. In addition to creating your own plugins for use on the bus, you can use CXBus to manually call plugin commands, subscribe to events, or read data.
+
|HIWSectionGif=No
===Widgets-Core===
+
|HIWSectionAnchor=behavior
These plugins make up the Widgets framework. All of the other plugins depend on them:
+
|HIWSectionText====How widgets behave when jumping from page to page===
 +
Genesys Widgets loads on every page if it is registered on that domain. If there is an active chat session, that session will be restored on the screen shortly after the page loads, as long as the current page is on the same domain that the chat was started. When moving across subdomains, the chat session will be restored normally, but if moving to an entirely different domain, the session will not be restored.
  
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=App-combined|display text=App}} (main parent controller for Genesys Widgets)
+
===How session recovery works after closing and opening the browser within the same domain===
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=Common|display text=Common}}
+
Genesys Widgets uses session cookies, which persist until you completely exit your browser application. When viewing an active chat session, closing the current window will not eliminate the session cookie, unless the action taken also exited the browser completely.
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=Overlay-combined|display text=Overlay}}
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=Toaster-combined|display text=Toaster}}
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=WindowManager-combined|display text=WindowManager}}
 
  
===Service plugins===
+
If you close the browser window or tab running the chat session, but you do not exit the browser completely, returning to that domain in another window or tab will restore the chat session.
These handle the network connections to Genesys channels. UI plugins use their services to communicate with the server indirectly. They can also be used independently to develop your own UI plugins.
 
  
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=CallbackService-combined|display text=CallbackService}}
+
===What happens when multiple browser windows are open===
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=StatsService-combined|display text=StatsService}}
+
When running multiple tabs from the same domain, the chat session will attempt to restore on each one. Closing one tab will not end the session. All tabs must be closed and the browser exited completely for the session cookies to be eliminated.
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=WebChatService-combined|display text=WebChatService}}
+
}}{{HIWSection
 
 
===UI plugins===
 
Also known as ''Widgets'':
 
 
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=Calendar-combined|display text=Calendar}}
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=Callback-combined|display text=Callback}}
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=CallUs-combined|display text=CallUs}}
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=ChannelSelector-combined|display text=ChannelSelector}}
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=Console-combined|display text=Console}}
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=SideBar-combined|display text=SideBar}}
 
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=WebChat-combined|display text=WebChat}}
 
 
 
===Bridge plugins===
 
The {{Link-AnywhereElse|product=WID|version=Current|manual=SDK|topic=Engagement-combined|display text=Engage}} plugin interfaces Genesys Widgets with other products.
 
 
 
===Modules===
 
These are standalone bits of code or data that can be loaded-into plugins directly. WebChatService has both a version 1 and a version 2 controller. The proper controller module is loaded at runtime, based on your configuration options.
 
|HIWSection={{HIWSection
 
 
|HIWSectionHeading=Related stuff
 
|HIWSectionHeading=Related stuff
 
|HIWSectionAlignment=Vertical
 
|HIWSectionAlignment=Vertical
 
|HIWSectionGif=No
 
|HIWSectionGif=No
|HIWSectionText=*{{Link-AnywhereElse|product=WID|version=Current|manual=Developer|display text=Widgets Developer's Guide}}
+
|HIWSectionAnchor=related
*{{Link-AnywhereElse|product=WID|version=Current|manual=SDK|display text=Widgets API Reference}}
+
|HIWSectionText=Widgets-specific documentation:
 +
 
 +
* {{Link-AnywhereElse|product=WID|version=Current|manual=Developer|display text=Widgets Developer's Guide}}
 +
* {{Link-AnywhereElse|product=WID|version=Current|manual=SDK|display text=Widgets API Reference}}
 
*{{#Widget:ExtLink|link=https://docs.genesys.com/Documentation/PSAAS/Public/RN/GW|displaytext=Genesys Widgets Release Notes}}
 
*{{#Widget:ExtLink|link=https://docs.genesys.com/Documentation/PSAAS/Public/RN/GW|displaytext=Genesys Widgets Release Notes}}
 +
 +
Related apps and features:
 +
 +
*[[PEC-CAB|Callback]]
 +
*[[PEC-COB|Co-Browse]]
 +
*[[PEC-Chat|Chat]]
 +
*[[PEC-AD|Agent Desktop]]
 
}}{{HIWSection
 
}}{{HIWSection
 
|HIWSectionHeading=How to use Genesys Widgets
 
|HIWSectionHeading=How to use Genesys Widgets
 
|HIWSectionAlignment=Vertical
 
|HIWSectionAlignment=Vertical
 
|HIWSectionGif=No
 
|HIWSectionGif=No
|HIWSectionText=Read the {{Link-AnywhereElse|product=WID|version=Current|manual=Developer|topic=GWCDeployment|display text=Get started}} article.
+
|HIWSectionAnchor=howto
 +
|HIWSectionText=Check out the {{Link-AnywhereElse|product=WID|version=Current|manual=Developer|topic=GWCDeployment|display text=Genesys Widgets deployment guide}}.
 
}}
 
}}
|advanced=No
 
 
}}
 
}}

Revision as of 17:23, May 10, 2021

Genesys Widgets relies on certain technologies in order to function. This article describes the requirements for widget implementation.

What Widgets does[edit source]

Modern contact centers need more than voice channels to keep up with their customers. Whether it's a chat session or screen sharing—or even if it's just a matter of scheduling a callback—digital channels and other modern customer support functions are a necessity for providing a unified customer journey.

Genesys Widgets is a set of APIs that provides specific types of user interface elements—normally referred to as widgets—and the services to drive them, enabling you to enhance your website with chat or callback, or your own customized contact center functionality.

Webchat main new.jpg

How Widgets works[edit source]

Genesys Widgets is built on top of the CXBus messaging bus. CXBus uses the publish–subscribe pattern to facilitate communication between the Widgets components, all of which are plugins that can both publish events on the bus and subscribe to the events they are interested in.

With the help of the Widgets-Core plugins, CXBus makes it possible to combine the logic implemented by user interface plugins, service plugins, and utility plugins into cohesive products that can provide chat sessions, schedule callbacks, and so on.

Widgets-architecture.png

Widgets behavior

How widgets behave when jumping from page to page

Genesys Widgets loads on every page if it is registered on that domain. If there is an active chat session, that session will be restored on the screen shortly after the page loads, as long as the current page is on the same domain that the chat was started. When moving across subdomains, the chat session will be restored normally, but if moving to an entirely different domain, the session will not be restored.

How session recovery works after closing and opening the browser within the same domain

Genesys Widgets uses session cookies, which persist until you completely exit your browser application. When viewing an active chat session, closing the current window will not eliminate the session cookie, unless the action taken also exited the browser completely.

If you close the browser window or tab running the chat session, but you do not exit the browser completely, returning to that domain in another window or tab will restore the chat session.

What happens when multiple browser windows are open

When running multiple tabs from the same domain, the chat session will attempt to restore on each one. Closing one tab will not end the session. All tabs must be closed and the browser exited completely for the session cookies to be eliminated.

Related stuff

How to use Genesys Widgets

Retrieved from "https://all.docs.genesys.com/WID/HIW (2024-11-09 12:30:11)"
Comments or questions about this documentation? Contact us for support!