Skip to main content
Mitratech Success Center

Salesforce Keys

Salesforce Integration (oAuth)

Overview

This topic outlines the steps to setup a new Salesforce oAuth integration with TAP, and to add Salesforce elements to a workflow once the oAuth integration has been completed. You will need to have both TAP and Salesforce open (in separate browser windows or tabs), and be logged in to both accounts.

Salesforce oAuth Integration

TAP - salesforce keys (image 1).jpg

Salesforce Permissions Settings

Salesforce Sandbox and developer accounts typically have these permissions set to 'Editable' for all profiles. 

In production instances of Salesforce, these settings are typically changed by security teams. To ensure the TAP and Salesforce API communication is successful, the 'Integration Profile' permissions must be set to 'Editable.'

A symptom of the wrong permissions is typically 'Unable to get reference object' when configuring a Salesforce field on the workflow. 

 Salesforce API Permissons2.png

 

To setup a new Salesforce oAuth integration:

  1. Open Salesforce (www.salesforce.com) and log in to the account from which you wish to create the API connection.
     
  2. Once logged in, navigate to the Setup page (located in the top right corner of the home page).
     
  3. From the Build menu, select Create > Apps.
     
  4. On the Apps page, under the Connected Apps section, click the New button.
     
  5. Name the new app and provide the user email to be associated with it.
     
  6. TAP - salesforce keys (image 2).jpg
  7. Select  the Enable OAuth Settings checkbox, add all Available OAuth Scopes to the Selected OAuth Scopes list, then click Save.
     
  8. Open and log in to TAP. Click the Administration TAP - salesforce keys (image 3).jpg button in the TAP Toolbar to access the Administration module.
    • The User page is displayed by default.
       
  9. Click the SalesForce Keys link in the INTEGRATIONS menu to display the Salesforce Keys page. Click the New salesforce key button.

    •  
  10. TAP - salesforce keys (image 4).jpg
  11. Once this has been saved, we need to move over to TAP and get our Callback URL - log in to TAP, navigate to the Users tab, click on "Salesforce Keys" > New Salesforce Key.
     
  12. Copy and paste the callback URL (found at the bottom of the page) onto Salesforce and click "Save."
     
  13. Back on TAP, we need to input the "Key Label" (anything relevant) and copy over the "Consumer Key" and "Consumer Secret" from the Salesforce page onto TAP (Do NOT click "Save" yet)
     
  14. Wait 2 - 10 minutes for the integration from Salesforce to take effect and then click "Save."
     
  15. A new screen will pop up on TAP asking you to allow or deny access - click "Allow."

The oAuth integration is now set up and can be selectively used in any workflow.

Salesforce on Workflows

Once Salesforce oAuth integration setup has been completed, you can add a Salesforce element to any workflow.

To add a Salesforce element to a workflow:

TAP - salesforce keys (image 7).jpg

  1. Open the desired workflow in the Designer.
     
  2. Add a new TAP - salesforce keys (image 5).jpg Salesforce records field to the workflow form.
     
  3. Click the new Salesforce record field in the workflow form, then click the TAP - salesforce keys (image 6).jpg Salesforce Options button in the toolbar.
    • The Salesforce record options dialog displays.
       
  4. Select the newly created Salesforce key from the Please select salesforce key menu.
     
  5. Select the desired object type from the Please select object type menu.
     
  6. Select the desired object field from the Please select object field menu.
     
  7.  When all desired options have been selected, click the Save button to save your changes and close the Salesforce record options dialog.

Example Salesforce Workflow Use Case

In the example below we will build a workflow that puts attachments into a Salesforce account that has been linked to this environment.

Start by setting up a simple workflow that has an Attachment form field on the form and has a basic 2 stage Workflow. Once this is built click on the relationship between the two stages and notice a button on the ribbon bar called “Salesforce Supoort”. Click this button to customize what will be sent to Salesforce. 

 

 

 

Within Salesforce support you can customize everything that you need to do for your workflow. For our example we will be ‘Adding a new object”, selecting the correct Salesforce key and selecting the Object Type. The Account Name will be Custom Value and I will call mine Test. 
 

Then click “Options” and we will be adding the form field called “Attachments” that we added to our form to the section of Options called “Attachments”. The goal of this is to bring attached forms into Salesforce when we go through this relationship. 

 

Now run a workflow and notice that when the workflow passes through this stage it will add attached documents into Salesforce as you can see in the screenshot below. 

 

See that we have created a test account and it was created with an attachment that I put on it called “Test”. 

 

 

  • Was this article helpful?