BMC Helix Remedyforce can now support integration with BMC Helix Chatbot within Remedyforce Self Service. The chatbot can be used by Self Service clients to perform following tasks:

• Create and view service requests
• View knowledge articles and provide feedback on them
• View the 5 latest service requests that got created.

To identify that an incident is created through a chatbot, you can configure the Incident Source picklist. For more information about configuring the picklist, see Recording incident source.

How to integrate BMC Helix Remedyforce with BMC Helix Chatbot

BMCHelix Remedyforce can be integrated with BMC Helix Chatbot based on the following steps:

For more information about the integration steps, refer the following sections:

• Set up My Domain in Remedyforce
• Provide Self Service 3.0 URL domain
• Provide your preferred tenant/domain name
• Purchase BMC Helix Chatbot
• Create an Integration User
• Create a Connected App
• Configure Remedyforce in Innovation Suite
• Configure BMC Helix Chatbot settings
• Mapping SRD inputs in Watson flows using JSON files
• Sync users between Remedyforce and Innovation Suite

To set up My Domain

If you have already enabled My Domain, you can skip the following steps.

1. Navigate to Setup >  Domain Management  > My Domain.
2. Enter your Domain Name. You can choose something like your company name or department.
3. Click Check Availability to check if the domain is available. If not, then you will need to come up with a derivative of the domain.
4. If the domain is available, click Register Domain.
5. You will receive an email in around 30 minutes when your domain is ready for testing.
6. Once the domain is ready, go back to My Domain and click Log in to test the new domain.
7. Once the log in is successful, click Deploy to Users.

There are advantages to enabling My Domain. As part of Service Assurance from Salesforce, they often move organizations. By enabling My Domain, you will be more insulated from those changes. Note that by enabling My Domain, you might have Email Communication Templates that will need updating to account for the new URL.

For more information about setting up My Domain, see  Salesforce Help .

Provide Self Service 3.0 URL domain

As part of the BMC Helix Platform for Remedyforce activation, you will need to provide your Self Service 3.0 URL domain. This URL will be used within both RSSO and Innovation Suite to assist with authentication as well as iFrame security. Note that currently Salesforce Lightning is not supported.

To obtain the URL, from Salesforce Classic launch Self Service 3.0 is a new tab. Copy everything from "https://"  to "visualforce.com" as shown in the following image.

Provide your preferred tenant/domain name

As part of the BMC Helix Platform for Remedyforce activation, you will need to provide a tenant/domain name.

This tenant/domain will be used to create a unique URL (for example, “calbro” which will result in a URL of calbro.onbmc.com). The tenant/domain name should not contain special characters and should be your company or system name. It is recommended that you have the tenant/domain name as close to the domain that you use in Salesforce for your usernames.

Purchase BMC Helix Chatbot

Reach out to your Business Relationship Manager or BMC Account Manager to discuss pricing for BMC Helix Chatbot.  

At the time of purchase, you will be required to provide the URL of all Self Service sites where you want to enable chatbot. 

Once BMC completes the chatbot configurations, you will be provided the following information:

• Remedy Single-Sign On URL: Required for chatbot configuration settings in Remedyforce.
• Innovation Suite URL: Required for Chatbot settings configuration in Remedyforce.
• issuer: Required for Chatbot settings configuration in Remedyforce.
• Tenant Admin credentials: Required to configure Remedyforce settings in IS.
• Private key: Required for Chatbot settings configuration in Remedyforce.
• Watson credentials: These are credentials for a ready-to-use workspace that is provided to you for building out the Watson Intents, Entities, and Dialog. 

Create an Integration User

Create an Integration User who will exclusively perform the integration activities. At the minimum, the Integration User should have the permissions equivalent to that of a Staff user. Also, ensure that the API enabled check box is selected for this user.

For more information about creating a user, see Adding or editing users.

Access to Apex classes

Ensure that the Integration User has access to the following Apex classes:

• BMCServiceDesk.REST_MyIT_KnowledgeArticle
• BMCServiceDesk.REST_MyIT_KnowledgeSearch
• BMCServiceDesk.REST_MyIT_ServiceRequest
• BMCServiceDesk.REST_ServiceRequestList
• BMCServiceDesk.REST_submitKnowledgeArticleFeedback

Access to Permission Set

Ensure that the Integration User has access to the ServiceDesk Client Permission Set.

Permissions for objects

The Integration User must have the following permissions:

To create a Connected App

1. Go to Salesforce > Setup.
2. In the Search box type “Apps”.
3. Based on whether you are on Salesforce Classic or Salesforce Lightning, perform the following action.
   • For Salesforce Classic, from the search result, click Build > Create > Apps > Connected Apps > New.
   • For Salesforce Lightning, from the search result, click Apps > App Manager > New Connected App.

4. On the New Connected App page, enter the required values as shown in the following example. For more information about the parameters, see Connected App parameters.

   Parameter	Value
   Connected App Name	Helix Chatbot
   API Name	This is automatically completed for you
   Contact Email	the email address of the Remedyforce/Salesforce administrator
   API (Enable OAuth Settings) > Enable OAuth Settings	Select the check box.
   Callback URL	https://login.salesforce.com
   Selected OAuth Scopes	Full access (full)
   Require Secret for Web Server Flow	Select this checkbox

5. Click Save

6. Click Continue. You will be redirected to your Connected App page.

7. Note your consumer secret in the Consumer Secret field by clicking Click to reveal.

8. Note your consumer key in the Consumer Key field.

Connected App parameters  

The following table lists the fields that you need to configure for creating the Connected App. For more information about the fields, see  Salesforce Help .

To configure Remedyforce in Innovation Suite

1. Log in to BMC Helix Innovation Studio as a tenant admin, and navigate to the Administration tab.
2. Select Chatbot Configuration > Remedyforce.
   

3. Provide the following information on the Remedyforce Configuration page:

   Parameter	Description
   Environment Type	The environment for the chatbot. This will either be the Sandbox or the Production environment.
   Client ID	The consumer key that you obtained from the connected app you created in Salesforce.
   User Name	The user name of the Integration user you created in Salesforce.
   Password	The password of the Integration user you created in Salesforce. Remember you may need to also provide this user’s Security Token and append it to the end of the user’s password.
   Client Secret	The consumer secret that you obtained from the connected app you created in Salesforce.

4. Click Save.

Configure BMC Helix Chatbot settings

Before you begin

Ensure that the BMC Helix Chatbot Configuration tab is enabled for the administrator who will configure the chatbot settings.

To configure BMC Helix Chatbot settings

Perform the following steps to configure the BMC Helix Chatbot settings in Remedyforce:

1. Navigate to Salesforce tabs by either clicking on the plus sing in Classic or navigate to App Launcher in Lightning. 
2. Click BMC Helix Chatbot Configuration.
   
3. Enter the details. For more information about the parameters, see Chatbot settings parameters.
4. Click Save.

Chatbot settings parameters

Mapping SRD inputs in Watson flows using JSON files 

To map input fields of an SRD in a Watson flow, you have to download the respective JSON for an SRD and use it to update the Watson flow. The JSON file includes details required for the SRD input fields. To map the SRD input fields with the user entered values, the content of the JSON must be copied in the confirmation part of the respective SRD in IBM Watson Workspace. Note that the option to download JSON is available for SRDs only if the administrator has configured and saved the chatbot configuration settings. 

The following image shows a sample JSON file.

For each input field, the mapping in the JSON is as follows:

• Key: 18 digits Salesforce ID of the input field.
• Value: Context variable defined by using field's "Input/Prompt" value and replacing spaces with underscore ( _ ). For example, $First_and_Middle_Name.

IBM Watson users who will be writing the dialogs can change the context variable name that is used in their dialogs or can use the auto generated ones and set them while writing the dialogs.

Fields not supported

The following fields are not included in the JSON file content. 

• HeaderSection
• Lookup

Also, for a picklist that has an option to select multiple values, users can select only single value from the chatbot.

To download JSONs

1. Go to the Remedyforce application.
2. Navigate to Remedyforce Administration > Configure Application > Request Definitions.
3. Click the Request Definitions tab.
4. Click the SRD for which you want to download the JSON.
5. Click Download JSON.
6. Open the JSON in an editor.
7. Select the entire content.
8. Go to IBM Watson Workspace.
9. In the Dialog tab, select the corresponding SRD.
10. Go to the last node and open the JSON editor.
11. Replace the content with the copied content.
12. Repeat from Step 2 to Step 11 for all the required SRDs that you want to configure in IBM Watson. 

Sync users between Remedyforce and Innovation Suite

For clients who want to use BMC Helix Chatbot from within Remedyforce Self Service, they need to be replicated within Innovation Studio. This section describes how to use Pentaho (an open source ETL tool) and our package, RemedyforceToInnovationStudio, to sync up the two respective environments.

Identifying BMC Helix Chatbot Users

We have added a custom check box field, BMC Helix Chatbot User, to the User object. This field can be added to the User Page Layout. You can select which users are part of your pilot or beta as you begin evaluating and setting up BMC Helix Chatbot. Ensure that the BMC Helix Chatbot User check box is selected on the user's record in Salesforce.

The RemedyforceToInnovationStudio Pentaho package is designed to copy Remedyforce users that have the BMC Helix Chatbot User check box as selected. 

Note that anytime when the package is rerun, only the following users are copied to Innovation Suite:

• New users with the BMC Helix Chatbot User check box as selected.
• Existing users whose BMC Helix Chatbot User check box was selected after the last run of Pentaho package.

Prerequisites

• Ensure that you have downloaded Pentaho. For more information about downloading Pentaho, see sections Registering at the BMC Communities website, Installing the JRE, and Downloading the Pentaho Data Integration tool in Prerequisites for importing data to BMC Helix Remedyforce.
• Download the RemedyforceToInnovationStudio Pentaho package from the BMC Communities website.
• You must be running Pentaho Kettle 8.1 or 8.2; otherwise, the running of the package will fail.
• Before running the Pentaho tool, make the following update: 

1. 1. Open the link  Commons HttpClient
   2. Download the commons-httpclient-3.1.zip file from the binary folder.
   3. Unzip the downloaded zipped file.
   4. Go to directory <PENTAHO_INSTALL_FOLDER>\data-integration and create a folder by the name libext.
   5. From the extracted zipped file, copy the commons-httpclient-3.1.jar file in the libext folder.
   6. Go to directory <PENTAHO_INSTALL_FOLDER>\data-integration\launcher and edit the file launcher.properties as follows:
   7. Append the text “:../libext” to libraries and classpath key values. The new values will be as follows:
       libraries=../test:../lib:../libswt:../libext
      classpath=../classes:../:../ui:../ui/images:../lib:../libext
   8. Launch the Pentaho Data Integration tool by performing the following actions:

      1. Navigate to the location where you downloaded and unzipped the Pentaho Data Integration tool.

      2. Navigate to the data-integration folder and double-click the Spoon.bat.

To copy the users

1. Launch the Pentaho Data Integration tool.
2. In Pentaho Spoon, select File > Open, navigate to the folder where you downloaded the Pentaho packages, and open the RemedyforceToInnovationStudio.kjb file.
3. In Pentaho, click Edit > Settings and click on the Parameters tab.  Set the following parameters in the Default Value column:
   • ISLOGIN: User name of the Tenant Admin for Innovation Studio. Ensure that the user name contains the domain identifier. For example, <username>@<domainidentfier>.
   • ISPASSWORD: The password of Tenant Admin for Innovation Studio.
   • ISPATH : The Base URL for Innovation Suite. For example : https://rf-tenant2-is.cloudsolqa.bmc.com
   • SF_PASSWORD: The password for the Salesforce administrator.
   • SF_USERNAME: The user name for Salesforce administrator.
   • SF_WEBSERVICE_URL: The Web Service URL for Salesforce. 
             Note: Typically this will be https://login.salesforce.com/services/Soap/u/41.0. However, if you are setting this up in a Sandbox first, the URL changes to https://test.salesforce.com/services/Soap/u/41.0
4. Click OK then go to File | Save in Pentaho to save the changes to the parameters.
5. Click Run.
   Note: The first time, we suggest setting the Log Level to be “Debug" to capture details of the log in case the package doesn’t work and troubleshooting needs to be done. You can set the Log Level from Log Level option in Action > Run. You can later use something like Windows Scheduler to have the package run on a more recurring basis.

Launching the chatbot window

Recording incident source