Salesforce the Legacy Bigtincan Content App

1.  This support article refers to a legacy version of the Bigtincan Salesforce app. This version is no longer available for download.
2. A new version can be downloaded from Salesforce App Exchange at https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3u00000PFVBcEAP

Salesforce The Legacy Bigtincan Content App

Bigtincan provides seamless integration between Salesforce (SF) and Bigtincan Hub. The integration also comes with a powerful Content Recommendation feature that enables Salesforce users to make use of related content in Bigtincan hub.

This guide provides an overview to enable installation and configuration of the Bigtincan Content Recommendation plugin. This includes steps required in both Bigtincan Hub and client specific Salesforce instance. 

Requirements

Assumptions

Below are assumptions made prior to following the steps in this manual. 

• The Bigtincan Content Recommendation plugin for Salesforce requires Salesforce API access and so one of the following Salesforce editions are required:

Enterprise Edition
Unlimited Edition
Developer Edition
Performance Edition

• An active Bigtincan Hub tenant exists and is enabled to work with SF (i.e. https://app.bigtincan.com)
• Client Salesforce instance up and running (i.e.https://company.my.salesforce.com)
• Outreach to customersuccess@bigtincan.com requesting licenses for plugin.

Also an administrator of the Company’s Salesforce instance should execute the installation of the package and steps required in this manual.

Please note that if the Salesforce instance is a Sandbox please send a request to support@bigtincan.com asking for Salesforce Sandbox support.

Allow Access 

The Hub requires certain permissions for the integration process. Users must ensure they've allowed the following permissions for properly integration: 

Click "Allow" to save the granted permissions and progress to the next step of integration. 

Post Installation Instructions

After the installation, please follow the steps below to start using the plugin.

1. Navigate to “Setup”.
2. Navigate to Setup-> App Setup-> Develop-> Custom Settings or use quick access menu and search for “Custom Settings”. Click “Custom Settings” to go to the page.
   
3. On the Custom Settings page, find the object called “BTCSettings” and click “Manage”.
   
4. On the BTC Settings detail page, either click on "New" (or "Edit" if it already exists) and copy the URI from the custom BTC Settings.                 
5. From the Bigtincan web app, navigate to Platform Configuration> Custom Apps and select the "Standard OAuth 2.0 (User Authentication)" option.
   
6. Fill out the Application Name field with a descriptive name (e.g., "Salesforce"), add the URL for your Salesforce instance in the OAuth 2.0 URI field and select all of the Application Scope check boxes. Copy and save the Client ID and Client Secret value for use in the next step.
   
7. Return to Salesforce and fill out the BTC Settings form with values from Step 6 and click “Save” (note that the "Security_Token" field is left blank intentionally and that the redirect URI is case-sensitive).
8. Update Remote Site Settings in Salesforce.

   Update remote site settings to include the prefix set in Platform configuration>Security>DNS

   - Enter Setup in Salesforce.com

   - Security Controls>Remote site settings

   - Edit Remote Site URL to include the DNS alias for bothbigtincan_pub_API_USandbigtincan_API_USor the appropriate region specific entries.

    

   https://<DNS>.push.bigtincan.<wbr>com

   https://<DNS>.pubapi.<wbr>bigtincan.com

    

9. Go to an Opportunity page and click the “Edit Layout” link on the page.
   
10. On Opportunity Layout page scroll down to “Visualforce Pages” and select “Section” on the right hand side, then drag it to a location on the page that you want to display. This will be the container for the Content Recommendation plugin.
    
11. Once you let go of the “Section” widget, you will see the details window (below), enter Section Name as “Bigtincan Content Recommendation," select “1-Column” option and de-select “Edit Page” option. Click OK.
    
12. In the Opportunity Layout window, select “Related Content Page," drag and drop into the section you have just created.
13. After drag & drop, you will see that the widget lies in that section. Please click the toolbox icon on the right hand side. It will be visible when you move the mouse to that point.
14. In Visualforce Page Properties window, modify the height as “680” and select “Show scrollbars” option. Click OK.
    
15. Click Save page layout and you should see the plugin page similar to below;
16. Note that If your company does not make end users’ Salesforce email the same as your Bigtincan Hub user email, you will get a warning window similar to below;
17. Please have the users go to Me> Settings> General> CRM and save either your “Salesforce Username” or “Salesforce Email” so that authentication and authorization will work smoothly.

*Note:

1. If your Bigtincan Hub instance has a different or customized URL other than https://app.bigtincan.com, please follow the steps 4 through 7 and modify the WEBAPP_URL field with your company’s WebApp URL.
2. If you are in a different region than the United States (the default region), you should also modify API_URL by following the same steps 4 through 7. Please check the table below;

Region – API URL Table

Addendum: Enabling SSO for the Content Recommendation package

1. Update BTC settings to include the prefix set in Platform configuration>Security>DNS

Enter Setup in Salesforce.com

Develop>Custom Settings> BTC Settings

Manage> Edit

Update API_URL and WEBAPP_URL to include the Company Identifier DNS defined in Platform Configuration Security DNS.

API_URL: https://<DNS>.push.bigtincan.com

WEBAPP_URL: https://<DNS>.appnext.bigtincan.com

2. Update remote site settings to include the prefix set in Platform Configuration> Security>DNS

Enter Setup in Salesforce.com

Security Controls>Remote site settings> Bigtincan remote site settings (BTCMOBILE)

Edit Remote Site URL to include the DNS alias for both bigtincan_pub_API_US and bigtincan_API_US or the appropriate region specific entries.

https://<DNS>.push.bigtincan.com

https://<DNS>.pubapi.bigtincan.com

Summary

The Bigtincan Hub & Salesforce integration has been designed with security in mind, offering a convenient, easy and seamless type of integration to your favorite CRM. Above explained steps can be achieved easily without hassle. Please contact Bigtincan Support in case you have problems, Bigtincan is ready to help you 24/7.