Jump to: navigation, search
(Automated save: adding PEC_Migrated template.)
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
= Configuring Genesys Widgets=
 
= Configuring Genesys Widgets=
__NOTOC__
 
Genesys Widgets supports multiple widgets including Webchat. You can configure all widgets and services in the same configuration object. When you add new Genesys products and services, you must update your Genesys Widgets configuration to enable those widgets.
 
  
After you [[GWCDeployment|deploy the Genesys Widgets]] on your website, configure the CX Widget by defining the '''global window._genesys''' Javascript object.
+
{{Template:PEC_Migrated}}
  
To include the JavaScript script, you can choose one of the following options:
 
 
*Place the script inline on your website; or
 
*Place it in a separate JavaScript file, and then include the file on your page.
 
 
The following example is a basic view of the global Genesys Widgets configuration object:
 
 
<source lang="javascript">
 
<script>
 
 
        if(!window._genesys)window._genesys = {};
 
        if(!window._gt)window._gt = [];
 
 
        window._genesys.widgets = {
 
 
                main: {},
 
                webchat: {},
 
        };
 
 
</script>
 
</source>
 
 
 
The following example is a populated Widget configuration that includes configuration options for Webchat:
 
<!--
 
{{NoteFormat|Note that Co-browse is optional.|2}}-->
 
 
<source lang="javascript">
 
<script>
 
 
        if(!window._genesys)window._genesys = {};
 
        if(!window._gt)window._gt = [];
 
 
        window._genesys.widgets = {
 
                main: {
 
 
                        theme: "dark",
 
                        lang: "en",
 
                        i18n: "http://HOST:PORT/path/to/languages/file.json",
 
                        customStylesheetID: "<ANY_ID_NAME>",
 
                        plugins: [
 
                                "cx-webchat",
 
                                "cx-webchat-service",
 
                                ],
 
                        mobileMode: 'auto',
 
                        mobileModeBreakpoint: 600
 
                        },
 
                webchat: {
 
 
                        apikey: "0123456789", // Used for Apigee service only
 
                        dataURL: "http://HOST:PORT/path/to/chat/service",
 
                        userData: {},
 
                        proactive: {
 
 
                                enabled: true,
 
                                idleTimer: 5,
 
                                cancelTimer: 30
 
                        },
 
                        chatButton: {
 
 
                                enabled: true,
 
                                template: false,
 
                                openDelay: 1000,
 
                                effectDuration: 300,
 
                                hideDuringInvite: true
 
                        }
 
                },
 
        };
 
 
        (function(o){
 
var f = function(){
 
var d = o.location;
 
o.aTags = o.aTags || [];
 
for(var i=0;i<o.aTags.length;i++){
 
var oTag = o.aTags[i];
 
var fs = d.getElementsByTagName(oTag.type)[0], e;
 
if(d.getElementById(oTag.id)) return; e = d.createElement(oTag.type); e.id = oTag.id;
 
if(oTag.type == "script"){e.src = oTag.path;}
 
                        else{e.type = 'text/css';e.rel = 'stylesheet';e.href = oTag.path;}
 
if(fs){fs.parentNode.insertBefore(e, fs);}else{d.head.appendChild(e);}
 
}},ol = window.onload;
 
if(o.onload){typeof window.onload != "function"?window.onload=f:window.onload=function(){ol();f();}}else f();
 
})({location: document,
 
    onload: false,
 
    aTags: [{type:"script", id:"genesys-cx-widget-script", path:"http://www.yourhost.com/path/to/widgets.min.js"},
 
{type:"link", id:"genesys-cx-widget-styles", path:"http://www.yourhost.com/path/to/widgets.min.css"}]});
 
 
</script>
 
</source>
 
==Main Configuration==
 
 
Genesys Widgets is a hub for multiple Genesys products and services. Some configuration options are set globally and therefore apply to all products and services running on the CX Widget platform. In the main application configuration you can configure options such as visual theme, language, and mobile support.
 
 
For detailed information on configuration options, see [[AppConfiguration|App Configuration Options]].
 
 
==Widget Configuration Options==
 
 
*[[WebChatConfiguration|WebChat Configuration]]
 
*[[WebChatServiceConfiguration|WebChatService Configuration]]
 
*[[ChannelSelector|Channel Selector Configuration]]
 
 
For a complete list of Widget configuration options, please see [[GWCWelcome|Genesys Widgets Reference]].
 
 
==Launcher==
 
Launcher is a sample page which shows how widgets display on any host website.
 
 
Using a sample page has the following advantages:
 
<ul>
 
<li>Viewing Genesys Widgets with your own configuration.
 
<li>Copying Configuration Script. Using the details you entered on the form, the configuration script is generated in the '''Need Configuration Script''' box. You can copy this script and use it on your website to launch widgets.
 
</ul>
 
 
===How to use Launcher===
 
'''Webchat'''<br>
 
Click the checkbox next to '''Webchat''' to enable it. Enter the mandatory field URL (marked with an asterisk) and click on the '''Launch''' button. Other values are optional and self explanatory.
 
 
'''CallUs'''<br>
 
Select the check box next to “Call Us” and provide the configuration data. Here, the '''Edit/Use Sample Config''' option is also provided and you can use this to prefill with the sample configuration and edit it for your own details. Ideally, call us is shown in the Live Assist widget or it can also be launched with bus command "CallUs.open".
 
 
'''ChannelSelector'''<br>
 
Select the checkbox next to “Enable Sidebar with Live Assist (EWT)” to include ChannelSelector plugin. Enter the Stats URL field followed by Chat and CallUs Vitual Queue names to fetching Stats service Estimated Wait Time details. For the Live Assist widget to show Chat, SendMessage and CallUs channels, please make sure you select those plugins as well.
 
 
{{NoteFormat| Sidebar is not an officially released plugin; it is being used here here for the purpose of the launcher tool. Ideally, it should be launched with bus command "ChannelSelector.open".}}
 
 
[[File:LauncherIteration5.png|thumbnail|center|Launcher tool (click to enlarge)]]
 
  
 +
{{NoteFormat|Documentation for this software has moved to a new home. Please update links and bookmarks to content hosted at https://all.docs.genesys.com/WID/Current/Developer/GWCConfig.}}
 
[[Category:V:PSAAS:Public]]
 
[[Category:V:PSAAS:Public]]

Latest revision as of 22:54, June 21, 2020

Configuring Genesys Widgets

Important
This content may not be the latest Genesys Engage cloud content. To find the latest content, go to Genesys Engage cloud for Administrators.


Important
Documentation for this software has moved to a new home. Please update links and bookmarks to content hosted at https://all.docs.genesys.com/WID/Current/Developer/GWCConfig.
This page was last edited on June 21, 2020, at 22:54.
Comments or questions about this documentation? Contact us for support!