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.
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 field | HubSpot field | Required HubSpot type | Description |
|---|---|---|---|
PLAYER_ID | string | The player identifier | |
PARTNER_USER_ID | string | The partner user identifier (sent through partner API) | |
GIVEN_NAME | firstname | string | The given name |
FAMILY_NAME | lastname | string | The family name |
EMAIL | email | string | The email (you mustn't change it) |
PHONE | phone | string | The phone number (in E.164 format) |
COUNTRY | hs_country_region_code | string | The country code (in ISO 3166-1 alpha-2 format) |
POSTAL_CODE | zip | string | The postal code |
LATITUDE | number | The latitude | |
LONGITUDE | number | The longitude | |
LAST_PLAY_DATE | dateTime | The initial play date from the last play | |
LAST_PLAY_CLAIM_MINIMUM_DATE | dateTime | The minimum date to claim his prize from the last play | |
LAST_PLAY_CLAIM_MAXIMUM_DATE | dateTime | The maximum date to claim his prize from the last play | |
LAST_PLAY_LANGUAGE | string | The language code (in ISO 639-1 format) from the last play | |
LAST_PLAY_CLAIM_LINK | URL | The link address to claim his prize from the last play | |
LAST_PLAY_CLAIMED_DATE | dateTime | The claimed date (in RFC3339 format) from the last play | |
LAST_PLAY_PRIZE_ID | string | The prize identifier from the last play | |
LAST_PLAY_PRIZE_NAME | string | The prize name (in play language) from the last play | |
LAST_PLAY_GAME_ID | string | The game identifier from the last play | |
LAST_PLAY_GAME_NAME | string | The game name (in play language) from the last play | |
LAST_PLAY_ESTABLISHMENT_ID | string | The establishment identifier from the last play | |
LAST_PLAY_ESTABLISHMENT_NAME | string | The establishment name from the last play | |
LAST_CLAIMED_DATE | string | The claimed date from the last claimed play | |
LAST_CLAIMED_PRIZE_ID | string | The prize identifier from the last claimed play | |
LAST_CLAIMED_PRIZE_NAME | string | The prize name (in play language) from the last claimed play | |
LAST_CLAIMED_GAME_ID | string | The game identifier from the last claimed play | |
LAST_CLAIMED_GAME_NAME | string | The game name (in play language) from the last claimed play | |
LAST_CLAIMED_ESTABLISHMENT_ID | string | The establishment identifier from the last claimed play | |
LAST_CLAIMED_ESTABLISHMENT_NAME | string | The establishment name from the last claimed play |