Settings → CRMs in your OpenCX dashboard. Requires the Integrations permission in Roles: Read to view, Write to connect, disconnect or change settings. This connection is separate from a helpdesk connected in Settings → Add-ons, such as the HubSpot helpdesk integration.
Which CRMs you can connect
Connect HubSpot
1
Create a private app in HubSpot
In HubSpot, open Settings → Integrations → Private Apps and create an app, or pick an existing one. On the Scopes tab, enable
crm.schemas.contacts.read, crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read and tickets. Copy the access token.2
Connect it
In Settings → CRMs, select Connect on Connect HubSpot, paste the token into Access Token and select Connect HubSpot. The row then shows HubSpot Connected with your portal ID.
3
Import contacts (optional)
Select Sync contacts to copy every HubSpot contact into OpenCX contacts with their email, phone and first name. Run it again whenever you want to pick up new HubSpot contacts.
Connect Salesforce
1
Create a Connected App in Salesforce
In Salesforce Setup, open App Manager and create a New Connected App. Enable OAuth settings, add the
api scope and check Enable Client Credentials Flow. Enter any valid callback URL, such as https://login.salesforce.com; it is required but not used.2
Choose the user OpenCX acts as
Under the app’s Manage → Edit Policies, assign a Run As user for the client credentials flow. That user needs API access and read access to Contact, Lead, Account, Opportunity and Case.
3
Connect it
Copy the Consumer Key and Consumer Secret from Manage Consumer Details, and your My Domain URL from Setup → My Domain. In Settings → CRMs, select Connect on Connect Salesforce, fill in the three fields and select Connect Salesforce.
Synced Salesforce contacts and leads become OpenCX contacts linked to their Salesforce record. When someone edits a linked contact’s name, email or phone in OpenCX, the change is written back to the Salesforce Contact or Lead.
What agents see in a session
Each connected CRM adds a card to the session details panel. Reorder or hide them for everyone under Session details cards in Workspace settings.- HubSpot: the contact is matched by email, then phone. The card appears only when there is a match. Agents see HubSpot Contact (name, email, phone, company and HubSpot ID, with a link to the record), HubSpot Company, the latest two HubSpot Deals and the last three HubSpot Tickets.
- Salesforce: OpenCX looks for a Contact by email, then by phone, then for an unconverted Lead the same way. Agents see the matched record with its Account, Opportunities, Past cases and any custom objects you enabled. With no match, the card says No Salesforce match for this contact and offers Create contact and Create lead, which create the record from the contact’s details. If Salesforce can’t be reached, the card says so instead of reporting no match.
What the AI agent gets
- Salesforce: fields you choose under Attributes and Stamp fields are stored on the contact as attributes. The AI agent reads contact attributes as context, within the limits you set in AI Context. Segments can use them too.
- HubSpot: this connection gives the AI agent no HubSpot records. Sync contacts only creates or updates OpenCX contacts.
Disconnect a CRM
Select Disconnect on the HubSpot row, or in the Salesforce Manage dialog. Disconnecting Salesforce stops every lookup and sync and clears its setup, including synced fields and custom objects. Attributes already stored on your contacts stay, and nothing changes in Salesforce.Troubleshooting
Related Documentation
HubSpot helpdesk
Run HubSpot as your helpdesk
Salesforce Service Cloud
Route sessions to Salesforce agents
AI Context
Choose which attributes the AI sees
Contacts
Manage synced contacts