Skip to main content

 

MindTouch Success Center

Install your Touchpoint for Salesforce Service Cloud

This page applies to:MindTouch (current)

This document explains how to create the MindTouch Touchpoint for Salesforce Service Cloud.
 

Prerequisites


  • The Salesforce base package must be installed. 
  • Users who want to publish using this integration must be pro members.
  • Salesforce administrator privileges.
  • Your Salesforce org has to have Service Cloud enabled.
  • Your MindTouch site configured with an SSL.
     

How to set up your Touchpoint for Salesforce Service Cloud


Step 1: Install your Touchpoint package

  1. Install the MindTouch Touchpoint for Salesforce Service Cloud package. The package setup is similar to step 2. Select the users to grant access to and click Install to proceed.
  2. Install the Search/Link to Case tool: Follow the steps starting with Adding Touchpoint tools to your Service Cloud in our Service Cloud setup document. (You have already configured the previous steps.)
  1. On the Package Installation Details page, click Continue.
  2. In the Package Installer, on Step 1, review and approve the object permissions needed to use this integration and click Next.
  3. On Step 2, select the appropriate security setting and click Next.
  4. On Step 3, click Install to install the package.
  5. Upon successful installation, the Package Details page displays a message informing of the completed installation.

Step 2: Configure your MindTouch settings  

Once you have successfully installed your Touchpoint, configure your settings:

  1. Click your name in the upper right.
  2. Select Setup.
  3. Under App Setup, select Develop > Custom Settings.

File:User:coreyg/Install_GeniusLink_in_Salesforce_Service_Cloud/custom_settings.png

  1. In Custom Settings, select Manage next to MindTouch Settings.

mindtouch settings list.png

  1. In MindTouch Settings, click New.

mindtouch settings details.png

  1. In the MindTouch Settings Edit dialog, edit your settings.
Field Meaning Example
Location Case Search Field The field to conduct the search on. Leave this at Subject Subject

 

Site Name The name of your MindTouch site, this will be displayed at the top of the widget. Success Center
MindTouch URL The URL of your MindTouch site. https://success.mindtouch.com
Publish Article Path The parent page that all new articles will be published under. /Private_Articles
Constraint A set of search parameters to constrain how search results are populated. +namespace:main AND type:wiki AND -path:Private_Articles/* AND -path:Private_Articles

Salesforce custom settings.png

  1. Click Save.
  2. Once you have successfully saved the settings, you will be redirected to the MindTouch Settings Detail screen.

Step 3: Configure search constraints

The search constraint parameter defaults to the following, which ensures that only MindTouch articles are returned (omits templates and file attachments):

+namespace:main type:wiki

If you'd like to further omit a specific section of your site, you could use the following; this example additionally omits search results for content under the section /Private_Articles:

+namespace:main AND type:wiki AND -path:Private_Articles/* AND -path:Private_Articles

Step 4: Add your site to approved remote sites

In order to take full advantage of your Touchpoint integration, you need to add your MindTouch site as an approved site in Salesforce. If you skip this step, you can still use the Touchpoint search tool, but you cannot relate articles to cases. 

  1. In theSetup screen, on the left sidebar and under Administration Setup, select Security Controls,  then select Remote Site Settings.

File:User:coreyg/Install_GeniusLink_in_Salesforce_Service_Cloud/remote_site_settings.png

  1. In the All Remote Sites screen click on the New Remote Site button.
  2. Fill out the fields with the corresponding values:
Field Meaning
Remote Site Name Name of your MindTouch Site (no spaces)
Remote Site URL The (https) URL of your MindTouch Site.
MindTouch URL The (https) URL of your MindTouch site.
Disable Protocol Security Disable site protocol security. (This may have security implications if value is disabled). Leave Unchecked
Description Description of the Remote Site (optional)
Active Is the remote site connection Active

File:User:coreyg/Install_GeniusLink_in_Salesforce_Service_Cloud/remote_site_edit.png

  1. Click Save

Step 4: Add customer insights tool to your Service Cloud

In Salesforce, edit the Case Layout and click Custom Console Components. On the sidebar, include the VisualForce page for MindTouch Insights as a tab.

Select the Customer Activity ID field for cases

The Touchpoint insights tool works by pulling in history for a specific customer. This is driven by a Customer Activity ID, which can be:

  • A user activity token (requires a case submission form inside MindTouch to pass this token)
  • MindTouch Username (often an email address of the customer, usually part of single sign-on integration)

The field used is set in the Custom Settings object:

Use MindTouch Usernames

If you are using a MindTouch Username as the Customer Activity ID field, set the API name for that field in the settings above.

  • Use the FieldName if it's a Case Standard Field
  • Use the API Name if it's a customer field

If you utilize Salesforce as your Identity Provider (IdP) for single sign-on (SSO), you will need to create a custom Salesforce field to derive the Salesforce persistent ID.

Verify the Insights tool appears in the sidebar for a case, populated with the customer history. 

Step 5: Add a related articles list to your case page

  1. Go to Setup.
  2. Under App Setup, select Customize, Cases, then page layouts.
  3. In the Case Page Layout screen, select Edit next to Case Feed Layout.

case page layouts.png

  1. You will then be taken to the Case Layout Editor. In the Case Layout Editor tools in the upper portion of the screen, select Related Lists, then Click on MindTouch Related Articles.

mindtouch related articles.png

  1. Click, then drag the MindTouch Related Articles list to any place on the case layout below, preferably under Related List. Then click on the wrench icon to edit the properties.

related list drag.png

  1. When the Related List Properties of the MindTouch Related Articles list shows up, select the fields you want to display in the Related Articles list. Once you are satisfied with the fields, click OK.

related list properties.png

  1. Click on Save in the Case Layout Editor tools,  then head to the Cases in your Service Cloud console and verify the MindTouch Related Articles list.

case view.png

Step 6: Add search to your Service Cloud

To add the search tool to the right sidebar, perform the following:

  1. Go to Setup.
  2. In the left side window, under App Setup, select Customize, Cases then page layouts. 
  3. In the Case Page layout screen, select Edit next to Case Feed Layout under Case Page Layouts.

case page layouts.png

  1. You will then be redirected to the Case layout view, where you can modify the layout of a case. In the top of the page, select Custom Console Components.

cusom console component.png

  1. Once in the Custom console Components screen, we will add the MindTouch Touchpoint tool as a Subtab component in the right sidebar. To do this under Subtab Components, in the Right Sidebar, set the following options:
Style Tabs
Width Px 300
Type  Visualforce Page
Component MindTouch_Search (to do this click on the magnifying glass icon and select it from the list).
Label Don't add a label as there is already a label (Site Name) for the actual integration

  1. Click Save. 
  2.  Click Save again to save your console component page.
  3. Go to your Service Cloud console.
  4. Select a case and validate that MindTouch Touchpoint appear in the right sidebar:

Step 7: Adding a global search integration to Service Cloud

After successfully installing the package and configuring the MindTouch settings, you can add a global integration to your Service Cloud:

Add a global integration

  1. Go to Setup. 
  2. In the left sidebar under App Setup, select  Create.
  3.  Click Apps.

File:User:coreyg/Install_GeniusLink_in_Salesforce_Service_Cloud/create_apps.png

  1. In the Apps screen, locate your Salesforce Service Cloud console name (titled "sample console" in the screenshot below) and click Edit.
  2. Scroll down to the Choose Console Components section and add MindTouch_Search to the selected items list.

Screen Shot 2014-08-11 at 2.41.33 PM.png

  1. Click Save.

Verify the global integration

  1. Navigate to your case console.
  2. In any portion of the case console, you should see the MindTouch integration at the bottom.

Screen Shot 2014-08-11 at 2.46.52 PM.png

Troubleshooting


Common installation errors include:

  • No Customer Activity ID for the current case. Ensure the customer activity field is visible on the case and configured in settings. The value of this field should show activity for the customer when viewing customer history on your MindTouch site.
  • User does not have permission to view history. Contact MindTouch Support and ensure the users/groups in question have access to view customer history.