Agent Setup Guide¶
This guide is for individual agents setting up the HubSpot CTI Connector on their own machine, after the connector has already been deployed and installed in your HubSpot portal by your admin/IT team (see the Deployment Guide). You only need to do this once per browser profile.
Prerequisites¶
- The connector has already been deployed and its URL (FQDN) shared with you by your admin, e.g.
https://connector.yourcompany.com. - The app has already been installed in your HubSpot portal.
- You have a valid AWS Connect agent login for your contact center.
- Google Chrome is installed. If your organization manages Chrome centrally, confirm with IT that installing extensions is permitted, or that this extension is allow-listed.
Step 1 — Install the Chrome extension¶
- Open the HubSpot CTI Connector for AWS Connect listing on the Chrome Web Store.
- Click Add to Chrome.

Step 2 — Configure your connector URL¶
The first time you install the extension, it will prompt you for your connector URL.
- Enter your connector's FQDN with
/connector.htmlappended, e.g.:
- Click Save.
Appending
/connector.htmlto the FQDN is mandatory for the extension to function correctly. Don't use the bare FQDN here — that's a separate URL used only during the one-time HubSpot app install.

You can revisit this screen later from chrome://extensions → HubSpot CTI Connector → Extension options, if you ever need to change it.
Step 3 — Allow pop-ups¶
The connector opens your softphone in a pop-up window. The first time you open HubSpot with the extension active, Chrome will block this pop-up by default.
- Click the blocked pop-up icon in the Chrome address bar.
- Select "Always allow pop-ups and redirects from [connector URL]."
- Click Done, then reload the page.

Step 4 — Log in to your softphone¶
- Open HubSpot and click the extension icon, or navigate to a HubSpot record — the connector popup should open automatically.
- When prompted, log in with your AWS Connect agent credentials.
- Once logged in, your agent status and softphone controls will appear in the connector window.

You're ready¶
Once logged in, you should see:
- The softphone controls in the connector popup.
- Dial and message buttons appearing next to phone number fields in HubSpot.
For day-to-day usage, see the Agent User Guide.
Troubleshooting¶
See the Troubleshooting & FAQ guide if the extension won't connect, pop-ups stay blocked, or you can't log in.