Connect HubSpot
What connecting HubSpot does, from caller names to calls logged back, and how to get its key and connect it.
HubSpot is a CRM for sales, marketing and service. This article explains what connecting it does and how to connect it.
What it does
Your HubSpot contacts are copied into your company contacts, so a caller HubSpot 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 HubSpot 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 HubSpot doesn't know the caller, you choose to skip the call, or log it with no contact, or create a new contact.
Contacts sync every 15 minutes (only what changed), with a full sync each day that also removes contacts deleted there.
Before you start
- Plan: any HubSpot plan with API access.
- Who: A HubSpot super admin creates the app or key.
- On our side: a company administrator connects it, once, for the whole company.
Get your private app access token from HubSpot
- In HubSpot, go to Development > Legacy apps and click Create legacy app, then Private.
- On Basic Info, name it Cannon VoIP.
- On the Scopes tab, click Add new scope and tick crm.objects.contacts.read and crm.objects.contacts.write, then Update.
- Click Create app, then Continue creating.
- Open the app, go to the Auth tab, click Show token and copy it.
Connect it
- In the portal, go to Contacts and click Connect a CRM (or Connect another CRM). You can also start from Company > Integrations.
- Choose HubSpot and fill in:
- Click Connect & sync. The first sync runs straight away and says how many contacts came across.
- To file calls in HubSpot, tick Log finished calls into HubSpot on the connection, and choose what happens when HubSpot doesn't know the caller.
- Private app access token: the token from the app's Auth tab
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 HubSpot: 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.
- HubSpot renamed private apps to legacy apps. They still work. A service key (Development > Keys > Service keys) with the same two scopes works too.
- Calls are logged as the person who made the token. If that person leaves HubSpot, logging stops with a permissions error: make a new token as someone who is staying.
- HubSpot recommends rotating the token every six months. Rotate and expire later keeps the old one working for 7 days while you paste the new one in.
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 HubSpot.
