Skip to main content
Connect Salesforce so Doris can import accounts, contacts, opportunities, owners and stages. A workspace admin does this once for the whole workspace. Salesforce needs an app your organization owns. You create an External Client App in Salesforce, then give its key and secret to Doris.

Before you start

You need:
  • A Doris role that can connect integrations. See Team & Usage.
  • A Salesforce admin who can create an External Client App.
  • A Salesforce user to authorize the connection. Use an admin or a dedicated integration user.
  • No other CRM connected in Doris. Doris uses one CRM for each workspace.
The authorizing Salesforce user needs:
  • API access
  • Read access to User, Account, Contact and Opportunity, and to opportunity stages and owners
  • Edit access to Account, Contact and Opportunity if Doris will update CRM fields
  • Create access to Task if Doris will write notes back to Salesforce
A dedicated integration user is better than a rep’s account. The connection keeps working when people change roles.

1. Start the connection in Doris

1

Open Integrations

Go to Settings > Workspace > Integrations.
2

Choose Salesforce

On the CRM row, select Connect, then choose Salesforce. The Connect Salesforce dialog opens.
3

Choose the environment

In Salesforce environment, choose Production (login.salesforce.com) or Sandbox (test.salesforce.com).
4

Copy the callback URL

The dialog shows the callback URL. Select the copy button. You need it in Salesforce. In production it is:
Keep the dialog open.

2. Create the External Client App in Salesforce

1

Open the app manager

In Salesforce Setup, open Apps > External Client Apps > External Client App Manager.
2

Create the app

Create a new External Client App. Turn on the OAuth settings.
3

Add the callback URL

Paste the callback URL from Doris. It must match exactly.
4

Add the OAuth scopes

Add these scopes:
5

Turn on PKCE

Turn on the Web Server Flow. Require PKCE with the S256 challenge method.
6

Copy the credentials

Save the app. Copy its Consumer Key and Consumer Secret.

3. Authorize in Doris

1

Paste the credentials

In the Connect Salesforce dialog, paste the Consumer Key and Consumer Secret. Doris encrypts the secret and never shows it again.
2

Authorize

Select Save and authorize. Salesforce opens. Sign in as the integration user and approve access.
3

Return to Doris

Salesforce sends you back to Doris. A message says “Salesforce connected”. Select Finish setup in it.
Authorization does not import CRM data. Doris imports nothing until you finish the setup below.

4. Choose what Doris imports

The connection opens on a checklist, Finish setting up Salesforce. It has three steps: Connect Salesforce, Choose what Doris reads and Start the first import.
1

Pipelines

Choose the pipelines to import. Doris imports only records in the pipelines you select.
2

Record owners

Choose all owners or only some. With selected owners, Doris processes only records those owners own. If you change the owner choice, Doris asks you to confirm it, then select Save configuration.
3

Start the import

Select Start import. The import runs in the background, so you can close the page while it runs. Once it starts, the connection shows the Overview, Data and Admin tabs.
Doris always imports amount, close date, stage, owner and pipeline. To import more deal fields, open the Data tab and, under Fields, select Import fields.
The record owners you select also filter Gong calls. If you choose Selected CRM owners and select nobody, Doris ignores every Gong call.

What syncs

Doris checks Salesforce for changes every 15 minutes and runs a full sync nightly at 01:00 UTC. Salesforce sends Doris no live deal events, so deal triggers in flows fire only for changes made in Doris. Doris writes notes back to Salesforce as Task records when that write is turned on for your workspace.

Troubleshooting

The callback URL in Salesforce must match the one in the Doris dialog exactly. Check for a missing https or an extra slash.
Start again and choose Sandbox in Salesforce environment. Production and sandbox use different sign-in domains.
Open the Salesforce connection, then the Admin tab. Select Disconnect Salesforce…. Connect again with a user from the correct org. Doris checks the org identity during authorization.
Check the pipelines and record owners on the Data tab. Then check the integration user’s object permissions and field-level security.
Doris uses one CRM for each workspace. Disconnect the current CRM before you connect Salesforce.