HubSpot integration

HubSpot integration is designed to send data to HubSpot.

Based on the field mapping defined in your admin panel, we will send data to HubSpot when:

  • a new game has started
  • a new user has registered
  • a user has updated their details
  • a user has claimed a prize

Workflow

stateDiagram-v2
    direction LR
    [*] --> PLAY_GAME
    PLAY_GAME --> REGISTER_PLAYER
    REGISTER_PLAYER --> UPDATE_PLAYER
    REGISTER_PLAYER --> CLAIMED_PRIZE
    UPDATE_PLAYER --> CLAIMED_PRIZE
    CLAIMED_PRIZE --> [*]

Getting Started

To start the HubSpot integration, you must link your HubSpot account to your SuggPro Gaming account.

Link your HubSpot account

Follow these steps:

  • Access your company account.
  • Navigate to "Settings" > "HubSpot integration".
  • Click on "Link your HubSpot account".
    • You will be redirected to HubSpot.com.
  • Authorize SuggPro Gaming to access your HubSpot account
    • You will be redirected to pro.gaming.suggpro.com.
  • Sign in to your account.
  • Link HubSpot to your chosen company.
  • Return to your company account.

Workflow

flowchart TD
    A[company.pro.gaming] --> B(click on 'Link your HubSpot account')
    B --> |redirect to hubspot.com| C(Authorize SuggPro Gaming)
    C --> |redirect to pro.gaming| D(Sign in to your account) 
    D --> E(Link HubSpot to your chosen company)
    E --> F(Return to your company account)
    F --> |redirect to pro.gaming| G[company.pro.gaming]

Configure your integration

Your integration can be configured in your company account, in the "Settings" > "HubSpot integration" section. By default, synchronization is disabled.

Enable synchronization

By default, synchronization is disabled. You can see the following message: "Synchronization with HubSpot is inactive." To enable synchronization, click on the "Enable synchronization with HubSpot" button. Confirm your choice when prompted.

Full synchronization is NOT launched by default

When synchronization is enabled, we will send only new data to HubSpot. To send all data, you must launch a full synchronization with the "Synchronize now with HubSpot" button. Confirm your choice when prompted. There is no feedback when synchronization is finished: check your HubSpot account.

Disable synchronization

When synchronization is enabled, you can disable it by clicking on the "Disable synchronization with HubSpot" button. Confirm your choice when prompted.

Field mapping

By default, we map only a few fields to HubSpot. To define your field mapping, you can fill out the form in the "SuggPro Gaming fields mapping with HubSpot" section.

Gaming fieldHubSpot fieldRequired HubSpot typeDescription
PLAYER_IDstringThe player identifier
PARTNER_USER_IDstringThe partner user identifier (sent through partner API)
GIVEN_NAMEfirstnamestringThe given name
FAMILY_NAMElastnamestringThe family name
EMAILemailstringThe email (you mustn't change it)
PHONEphonestringThe phone number (in E.164 format)
COUNTRYhs_country_region_codestringThe country code (in ISO 3166-1 alpha-2 format)
POSTAL_CODEzipstringThe postal code
LATITUDEnumberThe latitude
LONGITUDEnumberThe longitude
LAST_PLAY_DATEdateTimeThe initial play date
from the last play
LAST_PLAY_CLAIM_MINIMUM_DATEdateTimeThe minimum date to claim his prize
from the last play
LAST_PLAY_CLAIM_MAXIMUM_DATEdateTimeThe maximum date to claim his prize
from the last play
LAST_PLAY_LANGUAGEstringThe language code (in ISO 639-1 format)
from the last play
LAST_PLAY_CLAIM_LINKURLThe link address to claim his prize
from the last play
LAST_PLAY_CLAIMED_DATEdateTimeThe claimed date (in RFC3339 format)
from the last play
LAST_PLAY_PRIZE_IDstringThe prize identifier
from the last play
LAST_PLAY_PRIZE_NAMEstringThe prize name (in play language)
from the last play
LAST_PLAY_GAME_IDstringThe game identifier
from the last play
LAST_PLAY_GAME_NAMEstringThe game name (in play language)
from the last play
LAST_PLAY_ESTABLISHMENT_IDstringThe establishment identifier
from the last play
LAST_PLAY_ESTABLISHMENT_NAMEstringThe establishment name
from the last play
LAST_CLAIMED_DATEstringThe claimed date
from the last claimed play
LAST_CLAIMED_PRIZE_IDstringThe prize identifier
from the last claimed play
LAST_CLAIMED_PRIZE_NAMEstringThe prize name (in play language)
from the last claimed play
LAST_CLAIMED_GAME_IDstringThe game identifier
from the last claimed play
LAST_CLAIMED_GAME_NAMEstringThe game name (in play language)
from the last claimed play
LAST_CLAIMED_ESTABLISHMENT_IDstringThe establishment identifier
from the last claimed play
LAST_CLAIMED_ESTABLISHMENT_NAMEstringThe establishment name
from the last claimed play