Cannon VoIP Help

Connect Salesforce

What connecting Salesforce does, from caller names to calls logged back, and how to get its details and connect it.

Updated October 19, 2026

Salesforce is Salesforce's CRM (Sales Cloud and Service Cloud). This article explains what connecting it does and how to connect it.

What it does

Your Salesforce contacts are copied into your company contacts, so a caller Salesforce knows shows by name on every desk phone and app before anyone picks up, and in your call history afterwards.

With call logging on, every finished call is filed in Salesforce on the matching record: who took it, how long it lasted, missed calls and voicemails, and the call summary. You can log texts too (one note per conversation once it goes quiet for half an hour), and add a link to the call in the portal. When Salesforce doesn't know the caller, you choose to skip the call, or log it with no contact, or create a new lead.

Contacts sync every 15 minutes (only what changed), with a full sync each day that also removes contacts deleted there.

Before you start

  • Plan: Enterprise, Performance, Unlimited or Developer edition. Professional edition needs Salesforce's paid API add-on.
  • Who: A Salesforce admin, as a user with the API Enabled permission.
  • On our side: a company administrator connects it, once, for the whole company.

Get your details from Salesforce

  1. In Setup, search App Manager and click New External Client App. (New connected apps are switched off by default now; an external client app is Salesforce's replacement.)
  2. Name it Cannon VoIP and add a contact email. Under API (Enable OAuth Settings), tick Enable OAuth and set the callback URL to https://login.salesforce.com/services/oauth2/success.
  3. Add the scopes Manage user data via APIs (api) and Perform requests at any time (refresh_token, offline_access), then click Create.
  4. On the Policies tab, set the refresh token policy to valid until revoked and save.
  5. On the Settings tab, open OAuth Settings, click Consumer Key and Secret, enter the emailed code and copy both.
  6. To get the refresh token, open https://YOURDOMAIN.my.salesforce.com/services/oauth2/authorize?response_type=code&client_id=CONSUMER_KEY&redirect_uri=https://login.salesforce.com/services/oauth2/success and sign in. Copy the code from the address bar, then POST it to https://YOURDOMAIN.my.salesforce.com/services/oauth2/token with grant_type=authorization_code, code, client_id, client_secret and the same redirect_uri. The answer contains refresh_token.

Connect it

  1. In the portal, go to Contacts and click Connect a CRM (or Connect another CRM). You can also start from Company > Integrations.
  2. Choose Salesforce and fill in:
  3. - Instance URL (https://company.my.salesforce.com): your My Domain address, https://YOURDOMAIN.my.salesforce.com - Connected app consumer key: the Consumer Key from step 5 - Consumer secret: the Consumer Secret from step 5 - Refresh token: the answer to the POST in step 6

  4. Click Connect & sync. The first sync runs straight away and says how many contacts came across.
  5. To file calls in Salesforce, tick Log finished calls into Salesforce on the connection, and choose what happens when Salesforce doesn't know the caller.

If it says Needs attention

The connection's card on Company > Integrations shows the last error. The usual causes:

  • The key was reset, expired or deleted in Salesforce: make a new one and connect again with it.
  • The person who made the key lost access or left: make the key as someone who is staying.
  • If the refresh token policy expires tokens (Salesforce's example is 90 days), the connection stops then. Valid until revoked avoids that.
  • Step 6 is the fiddly part. If you'd rather not, contact support and we'll do it with you on a call.

Press Sync now on the connection to try again straight away. To stop, press Disconnect: contacts already copied stay in your contacts, and calls already logged stay in Salesforce.

Was this helpful?
← All help articles