Skip to main content

Install GeniusLink in Salesforce Service Cloud

This page applies to:MindTouch Responsive

This document explains how to integrate MindTouch GeniusLink in your Salesforce Service Cloud.


  • The Salesforce Base Package must be installed. 
  • Users who want to publish using this integration must be pro members.
  • Your Salesforce admin needs to install this integration in Salesforce.
  • Your Salesforce org has to have Service Cloud enabled.
  • Your MindTouch site will need to be configured with an SSL.

Set up Salesforce Service Cloud 

  1. Install the package: MindTouch GeniusLink for Service Cloud. 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 Widget:Follow the steps starting with "Adding Related Articles List to the Case Layout" in our Service Cloud Setup document. You have already configured the previous steps.

From there, you will be presented with the following:

package installation details.png

Click on Continue to proceed.


You will be prompted with an approval screen, which displays the objects and the permissions need to use this widget. Click on Next to proceed.

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


You will be prompted with an access screen, which displays which Salesforce users will have access to the widget.

Screen Shot 2014-08-11 at 1.51.11 PM.png
For the purpose of this demo we will only make it available to Salesforce admins only. We do this by selecting "Grant access to admins only", and clicking Next.

Installation confirmation 

Upon clicking next, you will be presented with a final Installation confirmation screen. Click on Install to install the package.


Upon successful installation, you will be redirected to the package details, with a message indicating successful installation.


Edit GeniusLink settings

Once you have successfully installed your MindTouch GeniusLink widget, you will need to set up the integration settings. To do this, goto setup (you can go to set up by clicking your name in the upper right).

Once in the setup screen, in the left side bar, Select Develop, then click on Custom Settings


Once in the custom settings list, select Manage next to MindTouch Settings.

mindtouch settings list.png

Once in the MindTouch Settings details, click on the New button at the top.

mindtouch settings details.png

In that screen, edit your MindTouch settings

Field Meaning Example
Location Case Search Field The field to coduct 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.
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

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

Configure search constraints

The search constraint parameter defaults to the following, which ensures that only MindTouch articles are returned; this 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

Add your site to approved remote sites

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

In the setup screen, on the left side bar and under Administration Setup, select Security Controls,  then select Remote Site Settings.


In the All Remote Sites screen click on the New Remote Site button. Then Fill up 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


Save your settings, and you should be able to access your GeniusLink Application with full functionalities. 

Add Insights to 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 insights widget 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

NOTE: 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.

You should now see the Insights widget appear in the sidebar for a case, populated with the customer history. 


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.

Add the Related Articles List to the Case Page Layout

Once you have successfully installed the GeniusLink widget and configured the custom MindTouch settings, you can now view the related articles object in the case, by customizing the case view and adding the Related Articles object to the view.

To do this, go to setup, and in the left side window, under App Setup, select Customize, Cases, then page layouts. Then in the Case Page layout screen Select Edit next to Case Feed Layout.

case page layouts.png

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

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

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 on OK.

related list properties.png

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

Add GeniusLink to Service Cloud

Once you have successfully installed the GeniusLink widget, and you have configured the custom MindTouch Settings, you can now add the GeniusLink widget to your Service Cloud screen.

To add the Widget in the right side bar, go to setup, in the left side window, under App Setup, select Customize, Cases then page layouts. Then in the Case Page layout  screen select Edit next to Case Feed Layout under Case Page Layouts.

case page layouts.png

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

Once in the Custom console Components screen, we will add the MindTouch GeniusLink widget as a Subtab component in the right side bar. 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

Click on Save. You will be redirected to Case layout page, then click on save again to save your console component page. Goto your Service Cloud Console, select a case and validate that MindTouch GeniusLink does appear in the right sidebar.

Add GeniusLink to Service Cloud as a global widget

After successfully installing the package and configuring the MindTouch settings, you can add GeniusLink as a global widget in Service Cloud. To do this, enter setup. In the left side bar of the setup menu under App Setup, select  Create, then click on Apps.


In the Apps screen locate your Salesforce Service Cloud Console name, in the screen shot below it is titled "sample console", and click Edit.

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

Then click on save. Verify the Global widget by heading to your case console, then in any portion of the case console, you should see the MindTouch GeniusLink integration at the bottom.

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


Once installed, you can go to a case in Salesforce and you should see the following: