Skip to main content

 

MindTouch Success Center

Touchpoint for Salesforce Sales Cloud

This page applies to:MindTouch (current)

This document explains how to create a Touchpoint for Salesforce Sales 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 Sales Cloud enabled.
  • Your MindTouch site has to be configured with an SSL.
     

How to set up your Touchpoint for Salesforce Sales Cloud


Follow the steps below to install and configure your Touchpoint for Salesforce Sales Cloud:

Step 1: Install your Touchpoint package 

  1. Install the Touchpoint for Salesforce Sales Cloud package. Select the users to grant access to and click Install to proceed.
  1. Follow the step Add your Touchpoint to your Sales Cloud opportunities. (You have already configured the previous steps.)
  2. On the Package Installation Details page, click Continue.
  3. In the Package Installer, on Step 1, review and approve the object permissions needed to use this integration and click Next.
  4. On Step 2, select the appropriate security setting and click Next.
  5. On Step 3, click Install to install the package.
  6. 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 DevelopCustom Settings.

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

manage custom settings.png

  1. On the MindTouch Settings page, click New at the top of the dialog to create a new default organization level value.

new custom setting.png

  1. In the MindTouch Settings Edit dialog edit your settings.
Field Meaning
Location Case Search Field The field to conduct the search on. Leave this at Subject.
Site Name The name of your MindTouch site. This will be displayed at the top of the widget.
MindTouch URL The URL of your MindTouch site.
Publish Article Path The path in your MindTouch site where created articles will post to.
Customer Activity ID Field This is the API name of the custom field within a case you have created to store the MindTouch customer activity ID. Example: customer_activity_id__c


edit 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: Add your site to approved remote sites

In order to take full advantage of your Touchpoint, you need to add your MindTouch site as an approved site in Salesforce.

  NOTE:  If you skip this step, you can still use the Touchpoint search tool, but you cannot relate articles to cases. 

  1. In the Setup dialog, under Administration Setup, select Security ControlsRemote Site Settings.

  1. In the All Remote Sites dialog, click New Remote Site and enter the corresponding values:
Field Description
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 Check to make remote site connection active.

 

remote_site_edit.png

  1. Click Save
     

Step 4: Adding Touchpoint tools to your Sales Cloud

Add related articles to your case page

Once you have successfully installed your Touchpoint and configured your custom MindTouch settings, add the Related Articles object by customizing the case view:

  1. In the Setup menu, under App Setup, select Customize > Cases > Page Layouts.
  2. Under Case Page Layouts, select Edit next to Case Feed Layout.

case page layout.png

  1. In the Case Layout Editor tools, select Related Lists and find MindTouch Related Articles.

mindtouch related articles.png

  1. Click and drag the MindTouch Related Articles list to any place on the layout panel, preferably under Related List. 

mindtouch related article drag and drop.png

  1. Click the wrench icon to edit the properties.
  2. In the Related List Properties - MindTouch Related Articles dialog, add the fields you want to display in the Related Articles list and click OK.


 

  1. Click Save in the Case Layout Editor tools.
  2. Navigate to Cases in your Sales Cloud console and verify the MindTouch Related Articles list displays properly.

related article list.png
 

Add a MindTouch section to your opportunities

Once you have successfully installed your Touchpoint and have configured the custom MindTouch settings, create an integration for your Sales Cloud:

  1. On the Setup menu, under App Setup, select CustomizeOpportunities > Page Layouts.

  1. Under Opportunity Page Layouts, select Edit next to Opportunity Layout.

  1. In the Opportunity Layout dialog, from the Fields section, select and drag Section to an area within the opportunity details.

opp.png

  1. In the Section Properties dialog, enter the following details:
Field Value
Section Name MindTouch
Display Section Header On Detail Page, Edit Page
Layout 2-Column
Tab-key Order Left-Right

  1. Click OK to save the new section.
  2. To confirm the section was added successfully, look for it under Opportunity Detail.

MindTouch section.png

 

Add a search component to opportunities

After you have successfully added a new section, add the search component: 

  1. Select Visualforce Pages in the components section.
  2. Drag and drop the mindtouch_search_opportunities to the newly created MindTouch section.

mt search for opp.png

  1. Click the wrench icon to configure the Visualforce Pages.

opp drag.png

  1. In the Visualforce Page Properties dialog, enter the following values:
Field Value
Width 100%
Height 400 (400 pixels in the minimum recommended height)
Show scrollbars leave unchecked
Show label leave unchecked

  1. Click Save to save your changes and view the newly installed integration.

save.png