Skip to main content
All CollectionsSalesforceSet up and use the Salesforce integration
Set up your Salesforce integration with Tackle Setup Assistant
Set up your Salesforce integration with Tackle Setup Assistant

After you install your Tackle package in Salesforce, use the Tackle Setup Assistant to authenticate and configure your integration.

Steve Stormoen avatar
Written by Steve Stormoen
Updated today

After you download and install the Tackle package in Salesforce, the next step is to go through a handful of tasks to set up the integration so everything works properly β€” and Tackle provides a handy assistant app to guide you through each of these steps. The Tackle Setup Assistant is packaged with your Tackle - Salesforce integration. Find it by typing Tackle in the App Launcher of your Salesforce instance.

Important

You must have Tackle Package Integration Manager permissions to complete the steps outlined in the Tackle Setup Assistant. Ask your Salesforce Admin to configure these permissions for you. If you do not have the proper permissions, you will see a banner like this:

An error banner from Salesforce reading "You do not have the right Salesforce permissions to connect to Tackle. Please contact your Salesforce Admin and ask them to review our guide on Tackle Permission Sets.

Launch the Tackle Setup Assistant

After you download and install the integration, get started by accessing the Tackle Setup Assistant:

  1. In Salesforce, click the App Launcher and search for Tackle Setup Assistant. Click to open it.
    ​

    The app launcher in Salesforce, with "Tackle" entered in the search bar. The first search result is an app titled "Tackle Setup Assistant".

  2. The Tackle Setup Assistant shows the steps needed to set up the integration. Also, it shows which Tackle features are enabled with your subscription, the package version you are setting up, and a help resource section at the bottom with your org ID and a link to Tackle Support. Click Start next to the step you want to work on. As long as you configure permissions and connect Tackle and Salesforce, the remaining steps do not need to be completed in the order shown.
    ​

    An overview of the steps included in the Tackle Setup Assistant. They include "System Connections", "Error Retry Batch Scheduler", "Debug Log Management", "Add Tackle Flow Actions", and "Data Mapping".


    ​Tip: If you don't see the features you expect, contact Tackle SupportπŸ”— and provide your Salesforce Org ID so they can add the necessary entitlements to your subscription.
    ​

  3. When you complete a step, the Start button changes to Edit in case you want to manage changes later. Learn more about each step in the Tackle Setup Assistant:
    ​

    1. System Connections: Connect Tackle and Salesforce

    2. Error Retry Batch Scheduler: Set up an automated retry

    3. Debug Log Management: Enable debug logs

    4. Add Tackle Flow Actions: Add buttons to trigger Tackle features

    5. Field Mapping: Map fields
      ​

  4. Configure any additional Tackle features necessary for pipeline scoring, co-sell, and offers to work with your process.

Connect Tackle and Salesforce

This is a required step to integrate Tackle with your Salesforce instance. This step must be completed by the Tackle Administrator for your company. The Salesforce client id and secret will not be available to standard Tackle Users.

  1. In the Tackle Setup Assistant, click Start under System Connections.
    ​

    Step 1 of the Tackle Setup Assistant: Systems Connections. Description: "Establish a connection between Tackle and Salesforce". The Start button is on the right-hand side.

  2. Follow the link to the Tackle Salesforce IntegrationπŸ”—, (in the Tackle application, click Integrations > Configure for the Salesforce integration). Copy and paste the Client ID and Secret you see there, from Tackle into the two fields you see when you expand System Connections in the Tackle Setup Assistant. Click Connect.
    ​

    In the Tackle platform, enter your Salesforce Client ID and Salesforce Client Secret in the provided fields. You can click the copy icon on each field to copy that data to your device's clipboard.

    If the connection is successful, the bar above your Client ID and Secret fields will change from "Not Connected" to "Connected".

  3. When the connection is successful, click Next.
    ​

  4. Click Authorize to grant Tackle access to your Salesforce instance. In the pop-up, click Allow. Click Finish. Now Salesforce and Tackle are connected.

Additional setup for your Tackle for Salesforce integration

The following steps are designed to make your Tackle for Salesforce integration flow more reliably and efficiently.

Set up automated retry

Prevent issues in the future by setting up an automated retry if Salesforce fails to send data to Tackle. For example, during an unexpected disconnect, you can configure the integration to retry sending data.

  1. Click Start in the Tackle Setup Assistant next to Error Retry Batch Scheduler.
    ​

    The Set Up Automated Retry menu lets you choose a job frequency and time to schedule re-sending data that failed the first time. It also lists other jobs you may have scheduled to avoid a conflict.

  2. Under Job Frequency select an option for how often you want Salesforce to attempt to re-send data that fails to post.

  3. Under Job Start Time, select the option you want.

  4. Click Activate, then click Activate again in the pop-up.

  5. Click Finish.

Enable debug logs

Automatically create activity logs for use in the debugging process. You can choose to log both success and error activity, or just error activity.

  1. Click Start next to Debug Log Management in the Tackle Setup Assistant.

  2. Under Logs Captured, choose whether you want to capture errors only, or errors and successes. (Do not set to None as that will interfere with error handling for packaged flow templates.)
    ​

    Image shows modal where you can configure log settings

  3. Enter the number of logs you want to retain next to Max Log Records Retained, up to 1000. This is the maximum number of log records that will be saved in this Salesforce organization log. If the limit is hit, older records will be automatically removed to make room for new ones.

  4. Click Finish.

  5. In the Tackle Setup Assistant, select the Package Log tab to view logs. Select an individual package log record to see details of the record. If there are errors in the Package Log that need resolution, please contact Tackle SupportπŸ”—.

Add buttons to trigger Tackle features

Configure Salesforce to display Tackle-managed buttons to make it easy to access to Tackle features in Salesforce. You only need to add buttons for the Tackle features you have enabled and are using, but it may be most efficient for your Salesforce admin to complete all of these at once.

Important

You must have Salesforce admin permissions to complete these steps.

Sellers (with Tackle Sales Operator permissions) can create co-sell opportunities and create offers in Salesforce. To do this, they will need buttons to open the forms and initiate the process.

  1. In Salesforce Page LayoutsπŸ”—, click Opportunity Layout. (If you are using multiple opportunity layouts, you will need to repeat this whole process for each one.)
    ​

    A list of Page Layouts in Salesforce. This account has four different Opportunity Layouts, with extra layouts for Marketing, Sales, and Support, respectively.

  2. Hover over the Salesforce Mobile and Lightning Experience Actions section. Then drag the Tackle Co-Sell button from Opportunity Layout > Mobile and Lightning Actions to the Salesforce Mobile and Lightning Experience Actions enable the new button.
    ​

    An animated GIF showing the process of dragging the "Create Co-Sell" button from the Opportunity Layout and adding it to the Salesforce Mobile and Lightning Experience Actions section.


    ​Note: If you are unable to access the Salesforce Mobile and Lightning Experience Actions section, hover and click the wrench icon to enable changes.
    ​

  3. Repeat the previous step for the Tackle Offers button.

  4. To display information about the co-sells and offers on the opportunity layout, you can include them in the Related Lists. Add Tackle Co-sell and Tackle Offers components to your Related List. Under Setup > Object Manager > Opportunities > Page Layout, drag Tackle Co-Sells and Tackle Offers to the Related Lists section.

  5. Optionally, you can add a related object to Tackle Offers to your opportunity layout. To do this:

    1. Select the Related Lists icon (wrench) for Tackle Offers. A pop-up opens.

    2. Go to the Columns section and for Selected Fields, select the fields you want. This should include Stage.
      ​

      A sample list of selected fields for Tackle Offers. This list includes "Tackle Offer Name", "Stage", "Offer Acceptance Deadline", and "Created By".


      ​Note: Make sure to also go to the Buttons section and deselect New and Change Owner. This ensures that the record syncs to Tackle and the marketplace. If you don't, records will not sync.
      ​

      The standard buttons are New and Change Owner.


      After you complete this, your related lists for Tackle Offers should appear.
      ​

  6. Click Save in the Opportunity Layout section.

  7. To check your work, open an Opportunity Record. You should see Tackle Co-Sell and Tackle Offers as new buttons, as well as in your Related List, like this:
    ​

    A sample Salesforce Opportunity Record with the above steps completed. The Tackle Co-Sell and Tackle Offers buttons are available in the top Opportunity menu bar and are included in the "Related List Quick Links" menu.


    ​Note: If you do not see the buttons on your Opportunity Record, you may have the Lightning App Builder enabled and you will need to take additional steps. Contact Tackle SupportπŸ”— for assistance.

Did this answer your question?