Salesforce (Beta)

Integrate Instruqt with your Salesforce instance and choose among options to create new leads as well as enrich existent leads and contacts with track play information.

Note: This feature is currently in beta and may not be available to all customers. Please contact Instruqt support to enable it for your organization.

Overview

Learn how to easily connect Instruqt to Salesforce and configure options to enrich leads and contacts with play data such as:

• Which tracks the user has played

• Time spent in each completed play

• Feedback provided (including comments).

Enable the integration

Before enabling the integration you might want to create a service account in Salesforce, dedicated to this integration. Any interactions of the integration will be performed using an access grant by this user/account.

Enabling the connection between Instruqt and Salesforce is easy and requires only a few steps:

🌐 Web UI

1. Go to play.instruqt.com and navigate to the menu Settings > Integrations. ↳ The integrations page is displayed with the platforms enabled to your account.

2. Inside the Salesforce section click on Connect. ↳ The integration configuration modal is displayed.

3. Click again on Connect and select the desired account type (Production or Sandbox). ↳ A salesforce authorization pop-up or tab is opened. You might be required to log-in. The list of permissions required by the integrations is displayed.

4. You need now to allow access to Instruqt via our subprocessor Paragon (check our subprocessor list for more information). Review the data displayed and click on Allow. ↳ The configuration modal on the Integrations page now displays the configuration of the workflows.

5. Enable the first workflow Create Lead on Form Submission and select the New Lead Status according to your preferences. Enabling this workflow is mandatory, but it won't duplicate entries in case there is already a Lead or Contact with the same email address, first name and last name. ↳ The configuration is saved automatically.

   

   Configuration modal
6. Review all other workflows to match your preferences. ↳ The configuration is saved automatically.

All set! You can now close the modal. It might take a few minutes before the integration is live.

Architecture

Overview

Paragon serves as a middleman that connects Instruqt's events and activities to a CRM system like Salesforce.

For each of the designated events enabled on our customers' Salesforce connection page, Instruqt prepares the necessary data and sends it to the Paragon APIs. Within the Paragon, our defined workflows activate and transform the provided data into the appropriate format for Salesforce. Finally, these workflows call Salesforce's internal APIs to complete the integration.

Permissions

To interact with Salesforce's internal objects through its API and for the Instruqt integration workflows that involve creating and manipulating custom objects, the specified permissions are required:

• Access the identity URL service

• Access Connect REST API resources

• Access custom permissions

• Manage user data via APIs

• Perform requests at any time

Custom objects & relationships

The Instruqt app creates two new objects: Instruqt_Play and Instruqt_Track. The Instruqt_Play object has Lookup Fields that connects to both native Lead and Contact objects. No data is written onto fields in the Lead or Contact object record.

Below are described the details of the Instruqt custom objects.

• Instruqt_Track

  Field Label	Field Name	Data Type	Indexed
  Created By	CreatedById	Lookup(User)	False
  Last Modified By	LastModifiedById	Lookup(User)	False
  Owner	OwnerId	Lookup(User,Group)	True
  Title	Name	Text(80)	True
  Track Slug	Track_Slug__c	Text(255)

• Instruqt_Play

  Field Label	Field Name	Data Type	Indexed
  Contact	Contact__c	Lookup(Contact)	True
  Created By	CreatedById	Lookup(User)	False
  Description	Name	Text(80)	True
  Feedback	Feedback__c	Text Area(255)	False
  Instruqt Track	Instruqt_Track__c	Lookup(Instruqt_Track)	True
  Invitation Link	Invitation_Link__c	URL(255)	False
  Last Modified By	LastModifiedById	Lookup(User)	False
  Lead	Lead__c	Lookup(Lead)	True
  Owner	OwnerId	Lookup(User,Group)	True
  Participant ID	Participant_ID__c	Text(15)	False
  Score	Score__c	Number(1, 0)	False
  Time Spent	Time_Spent__c	Text(15)	False
  Time Spent Seconds	Time_Spent_Seconds__c	Number(10, 0)	False

Visualize the data on Salesforce

Chatter

Out of the box the integration will send updates to the chatter section of both Leads and Contacts, including:

• Track started by the lead / contact

• Track completed by the lead / contact, including time spent until completion

• Track score feedback, if provided

• Track written feedback, if provided

Depending on how your salesforce setup, this tab might also be called "Activity".

Chatter example in a Lead

Display Instruqt information as related lists on Leads and Contacts

Besides the chatter it's also possible to visualize the data with the custom object Instruqt_Play in various ways.

One of the options is to displayed as dynamic related list, as described below.

Example of a dynamic related list in a Lead

Adding Instruqt plays to related lists

☁️ Salesforce

1. In Salesforce go to the settings from top right corner.

2. Go to Object Manager from left panel.

3. Find the Instruqt Play object and click on it.

4. Then click on the Fields & Relatioinship from left panel.

5. Click on the Lead property.

6. Click on the Set Field-Level Security and enable Visible to the profiles you want to be able to visualise Instruqt Plays (for instance: "Standard User" and "System Adminstrator") and click on Save.

   

   Example of giving visibility to Standard Users and Administrators.
7. Repeat the step above for every field you want to make visible for each profile. We advice to enable at least Lead, Contact, Instruqt Track, Feedback, Invitation link, Score and Time Spent.

Now that the field-level security visibility is correctly set we can add the Instruqt plays to the Lead and Contact pages layout.

1. Go to the leads page in Salesforce and open any lead. Click again on settings from top right corner.
2. Click on "Edit Page". In case you don't see that option you might need to contact you salesforce administrator.

3. On the left toolbar, under components, click on "Dynamic Related List" and drag it to the desired place in the layout.

4. Now configure your Dynamic Related List on the right, by changing the "Related List" field to "Instruqt Plays".

5. Scroll down "Related List Fields" section and click on the button "Add field".

6. Add any fields relevant to you. Here is as an example: Selected fields: Descriptio, Created Date, Time Spent, Feedback.
7. Click now on "Save" and followed by "Activate". Assign as Org or App default and choose between Desktop, Mobile or both as preferred. ↳ Done! You now have Instruqt data in your Leads.

8. Repeat the process on a "Contact" page to add the Instruqt Plays as well.

You have now configured your salesforce to display Instruqt plays on both Leads and Contacts!