Sync contact and event data between HubSpot & Regal Voice

This guide describes how to sync your HubSpot and Regal Voice contact, and how to bring Regal Voice events into your HubSpot contact profile's activity feed as a custom Regal Voice timeline event.

Install the Regal Voice HubSpot app

Step 1: Log into the Regal Voice app. And navigate to "Integrations."

Step 2: In the HubSpot Integration card, click "Connect."



Step 3: This will prompt you to auth into your Hubspot account.

Step 4: Select the relevant HubSpot account, click "Choose Account."

Step 5: On the next screen, click "Connect app" and complete the Captcha.

Step 6: This will take you back to your Regal Voice account, and once the integration completes installation, it will say "Connected."

Configure the app

Step 7: Back in the Regal Voice app, on the HubSpot card, click "Edit."

Step 8: Map the relevant contact attributes from HubSpot to Regal Voice. For the Hubspot attributes you must use the internal_name of the attribute, not the display name.

To find the internal_name of your HubSpot attributes, go to your HubSpot account and navigate to "Contacts" > "Edit properties" > "Export all properties." That will allow you to download a csv of all your contact properties with a column for the internal_name.

Edit propertiesEdit properties

Edit properties

Export all propertiesExport all properties

Export all properties

  • There are certain contact attributes like first name and phone that Regal Voice expects and has already named, so you just need to tell Regal Voice which attributes on your HubSpot contacts map to those.
  • For opt in, if all of your contacts are opted in, you can toggle on "Opt in all"; if however, not all of your contacts are opted in, you will need to have contact properties in HubSpot that represents opt in. For those properties Regal Voice expects a value of "true" if the contact is opted in or "false", if not.
    For any other contact property you'd like to map to regal voice, just click "Add Attribute." You can add as many as you'd like.
Map AttributesMap Attributes

Map Attributes

Step 9: Select what you want Regal Voice to do if a contact is edited in Regal Voice or if there is no matching contact in HubSpot.

Additional configurationsAdditional configurations

Additional configurations


Create new contacts

When a new contact is created in your HubSpot account, a new contact will be created in your Regal Voice account and appear in the Audience tab.

The attributes you mapped in the above configuration step will appear on the contact's profile if you click on the contact in Regal Voice. We automatically pass the unique link to the hubspot contact profile into an attribute called "hubspotLink" so your agents can have quick access to the contact's HubSpot profile from Regal Voice.


Phone number required

A phone number is required for Regal Voice to create a contact. If a contact is created in HubSpot without a phone number, it will not push to Regal Voice. If a phone number is later added, it will.

Update contact attributes

Anytime an update is made in HubSpot to one of the attributes you've mapped, that will push an update to the contact in Regal Voice with the new attribute values.


Create new deals

If a new deal is created in your HubSpot account, it will create an event in Regal Voice called "HubSpot Deal Created" with all of the properties of the deal.

Update deals

As deals are moved through the funnel stages in HubSpot or updated, it will create an event in Regal Voice called "HubSpot Deal Updated" with the properties that were updated.

HubSpot Deal Created & Updated EventsHubSpot Deal Created & Updated Events

HubSpot Deal Created & Updated Events

Regal Voice events on HubSpot contact activity feed

As part of the integration, Regal Voice publishes sms and call events back to HubSpot so that they appear as cards on a contact's activity feed in HubSpot.

Events include:

  • Call completed
  • Call recording link available
  • SMS conversation completed
  • SMS message sent
  • SMS message received
  • MMS message received


Each agent needs to select to see Regal Voice events

Filtered activities are set on an individual agent basis. In order to see Regal Voice events on the timeline of a contact, each of your agents will need to click Filter activity, then check Regal Voice. They only need to do this once.

Filter activity - Select Regal VoiceFilter activity - Select Regal Voice

Filter activity - Select Regal Voice

Testing your integration

Once you've completed the above steps, try:

  • Creating a new contact in your HubSpot account. After a couple of minutes, you should see that contact appear on the Audience tab in your Regal Voice account. Click on the contact to see that their contact properties came through correctly.
  • Updating a contact property of an existing contact. After a couple of minutes, check the contact in the Audience tab in your Regal Voice account.
  • From the agent desktop, initiate an outbound sms to one of those contacts. You don't need to actually text anything, just complete the Conversation Summary, and you should see that event appear on the activity feed of the contact in HubSpot. If you don't see Regal Voice events on the activity timeline in HubSpot, make sure to click "Filter activity" and check Regal Voice events.

Backfilling already existing contacts

If you'd like to backfill existing HubSpot contacts into Regal Voice, download your contacts and properties from HubSpot and share the file in a secure way (for example, you can password protect the excel file then email it [email protected] and share the password over slack).

To download your contacts:

  1. Click the Contacts tab in HubSpot, select all or the subset of relevant contacts, and click "Table actions" > "Export view".
Export ViewExport View

Export View

  1. Select "All properties on records", then "Export."


If you have any questions about how to install the Regal Voice HubSpot app or which contact properties are important to send to Regal Voice, reach out to [email protected]

Did this page help you?