Skip to content

HubSpot Connector

HubSpot provides a CRM platform with different tools to enable businesses to manage customer service, operations, marketing, sales, and more. SearchAI’s HubSpot Connector enables you to easily integrate with the HubSpot application to ingest Tickets, Contacts, Companies, and Deals related content and use it to answer user queries.

Specifications

Type of Repository Cloud
Supported Content Type Tickets, Contacts, Companies, Deals
RACL Support Yes
Content Filtering No

Authorization Support

You can set up communication between Search AI and HubSpot using a private app or set up an OAuth Authorization Code Grant Type for communication.

Note that a set of permissions is required to ingest the required data from the HubSpot account. Select the following scopes while creating the app.

  • crm.objects.companies.read
  • crm.objects.contacts.read
  • crm.objects.deals.read
  • tickets
  • crm.objects.owners.read
  • crm.objects.users.read
  • settings.users.teams.read

HubSpot Connector Configuration

  • Go to the Connectors page and select HubSpot.
  • On the Authorization page, provide the following information to enable SearchAI to establish a connection with HubSpot.
  • Name: Unique name for the connector
  • Authentication: Select one of the following.
    • OAuth Authorization: For this type of authentication, provide the client ID and client secret and the refresh token generated above.
    • Private App: For this type of authorization, provide the Access Token generated in the HubSpot account.

Content Ingestion

After successfully connecting the Search AI connector to the HubSpot account, go to the Configuration tab and set up content synchronization. For immediate sync, use the Sync Now option and the Schedule Sync option to set up a scheduler to sync the content in the future.

Upon sync, Search AI ingests Tickets, Contacts, Companies, and Deals from the HubSpot account.

For each of the four types of ingested content, the following fields are captured as the content field in the Search AI index. The type field in the ingested content suggests the type of content. Other properties are stored in dedicated fields within the indexed content or as metadata fields.

Tickets:

  • Content of the ticket
  • Priority
  • creation Date
  • Owner Name
  • Last activity date
  • Associated Companies
  • Associated Contacts

Deals:

  • Amount
  • Creation Date
  • Deal Stage
  • Owner Name
  • Last Activity Date
  • Associated Companies
  • Associated Contacts

Contacts:

  • Email Id
  • Phone number
  • Company name
  • Total Revenue
  • Recent Deal amount
  • Creation Date
  • Last Activity Date
  • Owner Name
  • Associated Companies.

Companies

  • Description
  • Domain Name
  • Industry
  • City
  • Employees Count
  • Annual Revenue
  • Owner Name
  • Associated Contacts

RACL Support

For each of the content types ingested from HubSpot, the following fields are added to the sys_racl field.

  • Owner of the content type, e.g. owner of the ticket, deal, etc. For the owner, the sys_racl field directly contains the email address of the owner.
  • The teams having access to the content type, i.e., the teams that the owner of the content belongs to. A permission entity is created corresponding to each team having access to the content. To enable access control for the team members in Search AI, associate users to the corresponding permission entity using the Permission Entity APIs.