HubSpot

Sync contact and event data between HubSpot & Regal

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

Install the Regal HubSpot app

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

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

1152

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 account, and once the integration completes installation, it will say "Connected."

Configure the app

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

Step 8: Map the relevant contact attributes from HubSpot to Regal. 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.

670

Edit properties

2108

Export all properties

  • There are certain contact attributes like first name and phone that Regal expects and has already named, so you just need to tell Regal 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 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, just click "Add Attribute." You can add as many as you'd like.
628

Map Attributes

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

816

Additional configurations

Contacts

Create new contacts

When a new contact is created in your HubSpot account, a new contact will be created in your Regal 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. 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.

πŸ“˜

Phone number required

A phone number is required for Regal to create a contact. If a contact is created in HubSpot without a phone number, it will not push to Regal. 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 with the new attribute values.

Deals

Create new deals

If a new deal is created in your HubSpot account, it will create an event in Regal 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 called "HubSpot Deal Updated" with the properties that were updated.

1458

HubSpot Deal Created & Updated Events

🚧

Limitations

  1. By default the only events Regal receives from Hubspot are: Hubspot Deal Created and Hubspot Deal Updated. Additionally, Regal does generate contact.created and contact.subscribed events when new Hubspot contacts are created or subscribed. If you want to send more events from Hubspot to Regal (for example, Lead Owner Assigned), you’ll need your Hubspot plan to include Operations Hub.
  2. You are not able to map Custom Hubspot Dropdown drop down fields in Regal sync bi-directionally by default. Instead, this will require a Regal journey to map the friendly value to the hubspot value id.

Regal events on HubSpot contact activity feed

As part of the integration, Regal 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 events

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

1438

Filter activity - Select Regal

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 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 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 events on the activity timeline in HubSpot, make sure to click "Filter activity" and check Regal events.

Backfilling already existing contacts

If you'd like to backfill existing HubSpot contacts into Regal, 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".
2598

Export View

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

Export

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