Configuration Guide for the Shelf Chatbot Demo with Genesys Cloud
Each of the available options is described in detail below. If you require further assistance, please do not hesitate to contact us at support@shelf.io, via the live chat on the Shelf website or from the in-app chat support within the Shelf platform.
Last Update: 10-Aug 2020
1 Prerequisites
There are a couple of things required in order to start the setup process:
NodeJS should be installed - https://nodejs.org/
Yarn should be installed - https://yarnpkg.com/
Familiarize yourself with our sample repository to build the chat - https://github.com/shelfio/shelf-purecloud-guest-chat-demo
content is created inside Shelf Self-Service Library that is published
If you’re running a Windows, make sure that you install http-server - https://www.npmjs.com/package/http-server via the following command in your command line tool: npm install -g http-server
2 Setup
- Download or clone the Shelf Chatbot sample repository from GitHub to your computer.
- Extract the archive to a location on your computer.
- Navigate to the extracted folder and open your CLI (Command Line Tool).
- Install all the dependencies by running “yarn install” in the CLI.
- From the root of the repo folder open the following file widget-test.html in your code/text editor. Modify the following fields:pureCloudEnvironment - set it to your PureCloud region, it could be “mypurecloud.com” or “mypurecloud.ie” etc.
accountId - set it to your accountId that you’ve received from Shelf
allowedSSPLibraryIds - set comma separated values, in which libraries to find recommendations
You can open the Library page from the context menu on the Library Tree and then select View Library.Then copy the ID from the URL.organizationId - set it to the value you get from Genesys Cloud from the Organization Settings page, see the instructions below.See https://apps.mypurecloud.com/directory/#/admin/organization
deploymentId - set it to the value you get from Genesys Cloud from the Widget page, see the instructions below. If you don’t have a Widget, please create one with the same settings.
See https://apps.mypurecloud.com/directory/#/admin/integrations/widgets
targetAddress - the name of the queue from Genesys Cloud. - Save the changes in the file.
- Run yarn run-widget your command line tool.
- Navigate to the following URL in your browser - http://127.0.0.1:8080/widget-test.html and open the chat by clicking on the chat icon.
- Ask a question related to the content mapped by your intents in the chat..