Technical Note. PegaCHAT 6.2 SP3. Installing and Configuring OpenFire

Transcription

1 Technical Note PegaCHAT 6.2 SP3 Installing and Configuring OpenFire

2 Copyright 2011 Pegasystems Inc., Cambridge, MA All rights reserved. This document describes products and services of Pegasystems Inc. It may contain trade secrets and proprietary information. The document and product are protected by copyright and distributed under licenses restricting their use, copying distribution, or transmittal in any form without prior written authorization of Pegasystems Inc. This document is current as of the date of publication only. Changes in the document may be made from time to time at the discretion of Pegasystems. This document remains the property of Pegasystems and must be returned to it upon request. This document does not imply any commitment to offer or deliver the products or services described. This document may include references to Pegasystems product features that have not been licensed by your company. If you have questions about whether a particular capability is included in your installation, please consult your Pegasystems service consultant. For Pegasystems trademarks and registered trademarks, all rights reserved. Other brand or product names are trademarks of their respective holders. Although Pegasystems Inc. strives for accuracy in its publications, any publication may contain inaccuracies or typographical errors. This document or Help System could contain technical inaccuracies or typographical errors. Changes are periodically added to the information herein. Pegasystems Inc. may make improvements and/or changes in the information described herein at any time. This document is the property of: Pegasystems Inc. 101 Main Street Cambridge, MA Phone: (617) Fax: (617) Document: Technical Note for Installing and Configuring OpenFire Software Version: PegaCHAT 6.2 SP3 Updated: September,

3 Contents Overview Installing & Configuring OpenFire and FastPath to Work with PegaCHAT... 5 Install OpenFire and FastPath Components... 5 Configure an OpenFire User... 7 Configure a FastPath Queue... 8 Configure the Workgroup Launch Page... 9 Install and Configure the FastPath WebChat Client on Server Test Your Configuration

4 Overview This document describes the process of installing the OpenFire components necessary to use the PegaCHAT feature with CPM 6.2 SP3. This sample implementation depends on several open source components to function: OpenFire Chat Server an open source application that acts as the chat server for Expert Chat. OpenFire is an XMPP compatible chat server. FastPath Service Plug-in provides support for managed queued chat requests. FastPath WebChat provide a way for users to beginning chatting with support agents. It works both as a server plug-in and a standard web application file that can be deployed into any application server. Smack API Smack is an Open Source XMPP (Jabber) client library for instant messaging and presence Spark or any IM client compatible with the OpenFire chat server. 4

5 Installing & Configuring OpenFire and FastPath to Work with PegaCHAT The following steps are meant as a general guide for configuring OpenFire to work with PegaCHAT and are not intended to provide detailed installation or configuration instruction of the OpenFire environment. Refer to the OpenFire and FastPath documentation available from the developer community for more information installing and configuring this component. Install OpenFire and FastPath Components 1. Download the following components from the OpenFire development community web site ( OpenFire Chat Server V FastPath Service Plug-in V FastPath WebChat V Smack Client Library V Install the OpenFire server in your environment according to the instructions provided with the download package. 3. Deploy the FastPath plug-in to your OpenFire server environment according to the developer s instructions. 5

6 4. Install the Smack API jar files. Access the PRPC System ( and login using the operator (password = install). Click on the Pega button and then select the Import option from the Application > Import & Export menu. Follow the on-screen instructions to upload and import the smack.jar and smackx.jar files downloaded from into the Customer codeset. 5. Restart your web server. 6

7 Configure an OpenFire User 1. Login to OpenFire as an administrator using the admin username and password created during the installation. 2. Navigate to Users/Groups, select Create a New User, fill in the form and select Create User. Repeat this for any users that will need access to PegaCHAT. 7

8 Configure a FastPath Queue 1. From the OpenFire admin portal, navigate to the Fastpath tab and select Create New Workgroup. 2. Name the workgroup and add members to it and select Create Workgroup. 3. The workgroup name should now show up in the list of workgroups when you click the FastPath tab as shown. 8

9 Configure the Workgroup Launch Page You can create a custom launch page that customers will see when they click the workgroup icon on a web page. The launch page is used to collect information from the customer and pass it to PegaCHAT and the CSR. Note: At a minimum, you must configure at least one field with a variable name of username. The CPM sample application (MyCoCA) will recognize the following variable names and display them in the screen pop as well as use them to skip the interaction account search, contact search and verification flow actions: - Account - ContactId - Verified - ProblemType To configure the launch page UI: 1. Select the workgroup by selecting its name from Workgroup Summary that displays when the FastPath tab is selected. 2. Select Form UI from the options. The current UI elements are displayed. 3. Select the Add Field button to add new fields 9

10 4. Complete the form and select Update. 5. When you are done creating UI fields, select Save Changes. You may need to restart OpenFire before the changes take effect. 10

11 Install and Configure the FastPath WebChat Client on Server Deploy FastPath WebChat to the web application server from which customers will need to access it according to the developer s directions. Note: For initial testing purposes, you can deploy this to your PRPC server in the webapps directory (..webapps/webchat/) Once WebChat is installed and at least one Workgroup has been configured in FastPath, deploy the link to your workgroup by inserting the HTML Snippet from the Text options page in the Workgroup Settings. If you deployed WebChat to your PRPC server for testing purposes (as described above), navigate to the WebChat link by entering the following URL into your browser: You should see the default icon for the workgroup you created. 11

12 Test Your Configuration Test the OpenFire/FastPath and FastPath Webchat configuration before proceeding to PegaCHAT configuration steps. 1. Login to OpenFire as one of the created users with a compatible desktop client. For testing purposes, it is recommended that you download and install the Spark client (V2.5.8) and use that for testing purposes. 2. If you are using Spark, you should see a FastPath tab on your client. 3. Select it and login to the workgroup you created earlier by selecting it from the dropdown and clicking Join. 4. Now, navigate to the Fast Path WebChat client location configured in Step Select the icon for the workgroup. If it is working correctly, you should see the launch page configured for the workgroup. 6. Fill in the launch page fields and click Start Chat. The chat request should be routed to the Spark client session and the user should see a pop-up alert. If the user accepts the chat session, the FastPath WebChat customer and Spark user can carry on a chat session. If this is successful, proceed to configuring PegaCHAT, otherwise, recheck your steps. 12