Jump to: navigation, search

Setup Hubspot CRM

Hubspot CRM Integration

Turn your sales process into a revenue-generating machine. With Hubspot CRM Get an up-to-the-minute view of your entire sales funnels on a clean, visual dashboard. You can sort deals won and lost, appointments scheduled, contracts sent over, and track performance against quotas you set in one simple view. HubSpot CRM tracks customer interactions automatically – whether they’re in an email, across social media, or on a call.

With detailed reports on sales activity, productivity, and individual performance, you’ll never be in the dark about how your team is tracking toward quota, and you’ll have all the data you need to coach your team to success.

Integrate your HubSpot CRM with the OnPrintShop system and sync contacts between the two. In this Integration, you will have the control to decide any one from below sync-type as per your business need.

  • One Way
    • In this sync, only the OnPrintShop contacts will be created in HubSpot. HubSpot contacts will never be created in the OnPrintShop system.
    • When the OnPrintShop contacts created in HubSpot are updated in HubSpot, they will be updated back into OnPrintShop through HubSpot webhook. And, when contact details are updated in OnPrintShop they will be updated in the HubSpot system as well.
  • Two-way
    • In this sync, OnPrintShop contacts will be created in HubSpot as well as HubSpot contacts will be created in the OnPrintShop system.
    • When contact details are updated in any of the systems, they will be reflected in the other system.

Read below a systematic guide to integrate Hubspot CRM with your OnPrintShop website.

Pre-requisites for Hubspot CRM Integration

Create a Hubspot CRM account from – https://app.hubspot.com/signup/crm

Now, with the same account create the developers account from –https://app.hubspot.com/signup/developers/step/user-info

For the integration, you’ll require OPS’s Endpoint URL i.e. the Webhook URL. Get this URL from OPS Technical Team.

Step – 1 Get the API Key

To get the API Key login into your Hubspot Account

Setup Hubspot CRM12.png

If you are already using Hubspot then you see the following screen. Click on Continue with this user.

Setup Hubspot CRM11.png

Now, go to Setting.

Setup Hubspot CRM10.png

Here, under Integrations go to API Key. Copy the key and save it for future references.

Setup Hubspot CRM9.png

Step – 2 Get the Client ID and Secret Key

To get the Client ID and Secret Key login into your Developers Account.

On the home screen click on Create App button. Next, fill the Application details and create the Application.

Once the Application is created the create app button will change into Manage apps.

Setup Hubspot CRM8.png

Click on Manage Apps and select your application. Under Settings, you’ll find the Client ID and Client Secret key. Copy and save it for future reference.

Setup Hubspot CRM7.png


Step – 3 Webhook Configuration

Step – 3.1 Redirect URL – In OPS Admin Panel

Visit your Admin Panel and go to Store Configuration >> External Service Settings >> Accounting tab >> Hubspot

Here, under Redirect URL paste the OPS’s endpoint URL.

Note: Above Redirect URL (also called OPS’s endpoint URL or Webhook URL) will be provided by the OPS Technical Team.

Step – 3.2 Redirect URL – In Hubspot

Open your Hubspot developers account and click on Manage App, select your App.

Here, under OAuth URL paste the URL given in below format –

OAuth URL:

https://app.hubspot.com/oauth/authorize?client_id=xxxxxxxxxxxxxxxx&redirect_uri=xxxxxxxxxxxxxxxx&scope=contacts

  • Client ID: Client ID used in Step – 3.
  • Redirect URL: Redirect URL used in Step – 4.1

Under Redirect URL paste OPS’s endpoint URL given by the Technical Team (the one used in Step – 3).

Setup Hubspot CRM6.png

Step – 3.3 Webhook URL – In Hubspot

Open your Hubspot developers account and click on Manage App, select your App.

Under Webhooks paste OPS’s endpoint URL given by the Technical Team (the one used in Step – 3).

Setup Hubspot CRM5.png

Step – 3.4 Create Subscription/Create Webhook

Open your Hubspot developers account and click on Manage App, select your App.

Under Webhooks, set Event Throttling time as 1 per minute (enter 1 and select 'per minute' from the dropdown). Now, click on Create Subscription.

HubspotUpdate1.png

Fill the new webhook subscriptions form in the following manner.

For object type choose Contacts.

In the Listen for which events choose events based on your sync type:

  • If Sync Type is One-way choose Property changed.
  • If Sync Type is Two-way choose Created & Property changed

Under which properties select the properties to sync between OnPrintShop to Hubspot. Add the following parameters – firstname, lastname, email, mobilephone, address, city, state, zip, and country.

Finally, click on Subscribe. Once the Webhook subscription is created in Hubspot Developer Account, activate it as well as all the events involved in the particular subscription.

Setup Hubspot23.png

Step – 4 Get the Auth Code (Authentication to sync data between two systems)

To generate Auth Code run the following URL in the web browser.

https://app.hubspot.com/oauth/authorize?client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&scope=contacts%20automation&redirect_uri=xxxxxxxxxxxxxx

Client ID: Client ID used in the previous step

Redirect URL: Redirect URL used in the previous step

Once you run it, you will be asked to Login into your HubSpot CRM account.

Setup Hubspot CRM2Updated.png

Upon successful login, you’ll be asked to ‘Grant Access’. Click on Grant Access.

HubspotCRMIntegrationUpdate27.png

As soon as access is granted, you’ll be redirected to a screen as shown below –

AuthCode Hubspot.png

Copy and save the Auth Code for future references.

Step – 5 Integration into OPS Admin Panel

Login in to your OPS Admin Panel and go to Store Configuration >> External Service Settings >> Others tab >> Hubspot

Here on this screen paste all the credentials derived in previous steps:

SetupHubspot24.png

  • Sync Type – Select one-way or two-way.
    • One Way – In this sync, only OnPrintShop contacts will be created in HubSpot.
    • Two Way – In this sync, OnPrintShop contacts will be created in HubSpot as well as HubSpot contacts will be created in the OnPrintShop system.
  • API Key: Saved in Step – 2
  • Client Secret and Client ID: Saved in Step – 3
  • Redirect URL: Endpoint URL given by the OPS Technical Team (the one used in Step – 3).
  • Auth Code: The code generated in Step – 5.
  • Custom/Extra Fields Sync – If you want to sync any other HubSpot fields apart from those mentioned above (in Step – 3.4), then follow the below steps –
    • Mention the HubSpot fields/property’s Internal Field Name in this textbox (for multiple fields, enter each in a new line).
    • To get the internal name of the fields/properties, go to Properties Listing in your HubSpot CRM account. While editing the property you’ll get its internal name (as shown in the image below).

SetupHubspot25.png

Then, map those fields with OnPrintShop customer extra fields. To map create customer extra field, in Block/Field Name Enter the HubSpot field/property’s internal name (as shown in the image below).

SetupHubspot26.png

Note:
  • In the Custom/Extra Fields Sync text box, the ‘Internal field name’ can be of standard or custom HubSpot fields.
  • You can configure HubSpot Standard fields in HubSpot Webhook, with this it will sync two ways (i.e. OnPrintShop to HubSpot CRM and vice-versa.
  • Any HubSpot custom fields cannot be mapped in Webhook. Therefore, the HubSpot Custom fields will only sync one-way (i.e. OnPrintShop to HubSpot).

Exceptional Fields

  • Address 2’ and ‘Consent for communication’
    • The HubSpot custom fields – ‘Address 2’ and ‘Consent for communication’ are exceptional. You will not have to map them manually with any OnPrintShop extra fields.
    • These fields will be automatically mapped with the OnPrintShop field – ‘Address 2’ & ‘Send newsletter’ respectively if they are created in your HubSpot CRM account.
  • Source
    • If you want the source identification of any Contact/Customer in the OnPrintShop system i.e. whether the contact was created in OnPrintShop or HubSpot, create a ‘Source’ extra field with Block/Field name as ‘source’, set its validation as – ‘Ready Only’.
    • Then, mention its Block/Field name (i.e. ‘source’) in the ‘Custom/Extra fields sync’ textbox.

After configuring all the derived credentials, click on the ‘Generate access token’ button to generate the access token and allow the two systems to access specific data.

Note: Make sure that the ‘Auth code’ and ‘Access token’ both are generated within the time-lapse of 10 minutes, else you will have to regenerate them for successful sync.

Once all the above steps are completed successfully, you are all set to sync data between OnPrintShop and HubSpot CRM.

Sync Contacts: It will sync (create & update) all the OnPrintShop contacts into the HubSpot CRM.