Getting Started with the Playground Application
The fastest way to get started with Genesys Web Engagement is to use the Playground application, which is included in the Genesys Web Engagement installation package. After you install GWE, you can find the GWE application in the GWE_installation_directory\apps\playground folder. This application contains all necessary resources to work with the Playground site. The site itself is found in the GWE_installation_directory\tools\playground folder.
All you need to do is start GWE Server(s), deploy the playground GWE application by using the command GWE_installation_directory\deploy.bat (or deploy.sh on Linux) and start the playground site by using the command GWE_installation_directory\tools\playground\playground.bat (or playground.sh on Linux). Now you are ready to work with the features of Genesys Web Engagement.
Keep reading to learn more about the application, or go directly to "Installing Genesys Web Engagement" for details about installing and running the Playground application.
Installing Genesys Web Engagement
In order to use the Playground application, you must first install and configure Genesys Web Engagement and its related components, start Web Engagement Server and then deploy the Playground Application.
For details, see the steps below:
- Review the prerequisites and make sure your Genesys environment meets the requirements.
- Install the Genesys Web Engagement Servers. These procedures describe how to install and configure the Web Engagement Server cluster and nodes.
- Make sure you have properly configured agents and add agent shortcuts to the Web Engagement Chat agent group: In Genesys Administrator, navigate to Provisioning > Accounts > Agent Group, and select Web Engagement Chat. Go to the agent tab and click Add to add the agent to the group.
- Install the Plug-in for Workspace Desktop Edition. You can install this plug-in if you want to enable chat engagement features so you can see Web Engagement from the agent's perspective when you test the Playground Application.
- Go to the tools\playground\static\html\ folder and open the instrumentation.html file in an editor. Modify the following lines to replace demosrv.genesyslab.com with the fully qualified domain name of your host:
- var serverDefault = 'http://demosrv.genesyslab.com:9081';
- var serverSecure = 'http://demosrv.genesyslab.com:9081';
- Save your changes and close the file.
- Deploy an Application. To complete these procedures, make sure you use the application name playground.
- Make sure the components in your Genesys environment are running:
- Start the Web Engagement Servers.
- Start the playground site using the command playground.bat (playground.sh on Linux) located in the folder GWE_installation_directory\tools\playground\.
- Log in any agents from the Web Engagement Chat agent group.
Congratulations! You are ready to run the Playground application.
Running the Playground Application
You can now run the application in any web browser or the InTools application — a GWE tool that allows you to work with the DSL and view events.
To launch InTools, navigate to GWE_installation_directory/tools/intools/. Take the intools.crx file and drop it into the Extensions page of your Google Chrome or Chromium browser. Click the Genesys Web Engagement bookmark in the toolbar and select Playground to launch the Playground application.
IMPORTANT: If your web browser blocks the installation of extensions, you can try the steps described in InTools installation for Chrome (Windows).
The Playground is an external application located at GWE_installation_directory/tools/playground/. You can configure it in the application.properties. For example, to change the port configuration, you would modify the value of the server.port parameter (default is 8081).
To open the Playground application from the GWE_installation_directory/tools/playground/ folder, run the playground.bat file.
To open the Playground application from a web browser, navigate to http://playground_host_name:playground_port/playground/PG.html.
- playground_host_name — The name or IP address of the host where the Playground application is running.
- playground_port — The default port of the Playground application (can be configured in application.properties).
For example, http://127.0.0.1:8081/playground/PG.html
Example: Web Chat End-to-End
Complete the steps below for an example of an end-to-end scenario for proactive chat.
- Make sure the Playground application is open and you have a logged in and ready agent in the Web Engagement Chat agent group.
- Click Engage! next to the Singleton business rule.
- The chat pop-up appears. Click Chat.
- Fill out the registration form and click Start Chat.
- On the agent side, accept the chat. You just walked through your first proactive engagement!