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.
- 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
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:
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.
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
Salesforce rejects the callback URL
Salesforce rejects the callback URL
The callback URL in Salesforce must match the one in the Doris dialog exactly. Check for a missing
https or an extra slash.Records are missing after the import
Records are missing after the import
Check the pipelines and record owners on the Data tab. Then check the integration user’s object permissions and field-level security.
Doris says another CRM is connected
Doris says another CRM is connected
Doris uses one CRM for each workspace. Disconnect the current CRM before you connect Salesforce.