Integrating Alohub Softphone × HubSpot

Guide to installing and using the Alohub Softphone extension on HubSpot CRM: calling from phone numbers and automatically logging call history to the correct record.

Overview

Item	Value
Host	`https://app.hubspot.com/*`
Module	Contact `0-1`, Company `0-2`, Deal `0-3`, Ticket `0-5`
Attach call	HubSpot Associations — log once, appear in all linked records

Conditions

Alohub account has configured provider as HubSpot (connect Private App token / OAuth on the BE side).
Users have permission to create call engagement on HubSpot.

Installation

Install the extension, open app.hubspot.com.
Open the Alohub side panel, log in.
Provider badge displays HubSpot .

Usage — Call from phone number

On the Contact/Company/Deal/Ticket page or list, the "Call" chip appears next to each phone number. Click the chip to dial and start the call.

Log call attached to the correct record

The extension reads the URL to determine the record being viewed:

HubSpot	module / recordId
`/record/0-1/12345`	`0-1`/ `12345`
`/contact/12345/`	`0-1`/ `12345`
`/company/678`	`0-2`/ `678`
`/deal/910`	`0-3`/ `910`

When clicking the chip in the list , the extension finds the nearest record link in the DOM block to attach the correct clicked line. BE creates call engagement and associates it with that record; thanks to Associations, the call automatically appears in linked records (contact ↔ company ↔ deal).

Note: A call only needs to be logged once — HubSpot automatically displays it in all records with linked associations.

Troubleshooting

Phenomenon	How to handle
"Call" chip not visible	Reload the page; check if the extension is enabled on `app.hubspot.com`
Call not attached to record	Open DevTools console to see logs `[Alohub] DIAL ctx`; check if the URL has `module/recordId`
Unable to log in	Check Server URL in Options; see reCAPTCHA configuration if BE has enabled authentication

Need further assistance? Contact Alohub .