Front-End Integration
Instructions on how to build the front-end integration for Inbox/On-Site Messages.
Here is the guide to implement the JS and enable on-site notifications on your website.
✅ Authentication
In order to make it work, you need to have an endpoint at your side which purpose is to validates the user session id (sid). This sid will be provided when initializing the integration.
Read more here about the
📨 On-site Notifications
Make sure you have authenticated/initialized the integration. You can read more about that .
📮Site Inbox Solution
(Added in version 1.1)
Fast Track CRM provides on-site notifications. The Site Inbox solution will further enhance this integration with the possibility to have an inbox on-site where players can receive and read historical messages similar to an email browser.
If you want to enable the Fast Track CRM Inbox, here is how it can be implemented.
Parameters
FT CRM will require a few options to be set for the inbox to run. Here are all parameters that the FT CRM Integration/Inbox accepts.
Name | Options / Type | Description | Default value | Required |
window.sid | String | Id used for authenticating against Fasttrack API. | | Yes |
window.fasttrackbrand | String | Fasttrack short code version of your brand name. You will get this from your Fasttrack contact person. | | Yes |
window.fasttrack.integrationVersion | 1.0 / 1.1 | Sets the version of the integration script. Use version 1.1! | 1.0 | Yes |
window.fasttrack.autoInit | Boolean | When set to false, script will not be invoked automatically. It has to be manually initialized in the developer console by running window.FasttrackCrm.init();. | false | No |
window.fasttrack.enableEventTracking | Boolean | Makes Fasttrack CRM tracking functions available. | true in 1.0. false in 1.1 | No |
window.fasttrack.enablePendingRewards | Boolean | Makes Fasttrack CRM pending rewards functions available. | true in 1.0. false in 1.1 | No |
window.fasttrack.enableCrmIntegration | Boolean | Makes Fasttrack CRM functions available. | true in 1.0. false in 1.1 | No |
window.fasttrack.inbox.enable | Boolean | Enables inbox functionality. Only available from version 1.1 and up. | false | No |
window.fasttrack.inbox.badgeId | String | ID of HTML element in your DOM. Will recieve text containing amount of unread messages. Element will be hidden if the unread count is zero. | null | No |
window.fasttrack.inbox.navBarLogo | String | URL to image (logo) that should be displayed in top left corner of inbox. | https://www.example.com/logo.png | No |
window.fasttrack.inbox.contactEmail | String | Email address for and support purposes. | info@example.com | No |
window.fasttrack.inbox.termsAboveButtons | Boolean | Some markets require to show terms above CTA Buttons. If this is set to true, that happens. | false | No |
window.fasttrack.inbox.closeModalOnFogClick | Boolean | If enabled (set to true) you will be able to close the inbox modal when clicking outside the modal on the overlay / fog. | false | No |
window.fasttrack.translations.recieved | Boolean | Translation used in inbox UI. | Recieved: | No |
window.fasttrack.inbox.validUntil | String | Translation used in inbox UI. | Valid until: | No |
window.fasttrack.inbox.questionsTop | String | Translation used in inbox UI. | Questions? Mail us at | No |
window.fasttrack.inbox.questionsShort | String | Translation used in inbox UI. | Questions: | No |
window.fasttrack.inbox.deleteMessagePrompt | String | Translation used in inbox UI. | Are you sure you want to delete this message? | No |
window.fasttrack.inbox.inboxEmpty | String | Translation used in inbox UI. | There is currently no messages in your inbox | No |
window.fasttrack.inbox.readMore | String | Translation used in inbox UI. | Read more | No |
👍Examples & debugging
Below is a full example of how the inbox integration script should look like in production on your site.
Staging Url for script:
Inbox button & badge
You can have a menu button (or similar) that toggles the inbox. It could have an associated badge that displays the number of unread inbox messages.
Here's how the markup and CSS would look like.
Visit to see a live demo of the Inbox functionality.
✍️ Using Google Tag Manager for inserting FT CRM Scripts
If you want to use your Google Tag Manager for injecting the Site Integration Script / Inbox Script on your site you can do that.
1. Create a new user-defined variable in GTM
2. Create a new trigger
Create a "Page View - DOM Ready" trigger. Add additional filters such as URL if you want. But it is important that the trigger is based on page vid AND DOM Ready.
3. Create a new tag with following code inside
Don't forget to replace your own values.
Make the tag fire on your "Page View - DOM Ready" trigger.
3. Insert the script in your HTML / DOM
You might already be adding dataLayer variables. If you do so, please append the dataLayer with your sid variable (the custom variable you created in step 1) and add the corresponding value.
If you are not already adding dataLayer variables to GTM you need to include the following before initiating the Google Tag Manager on your page:
And you're done! 👌
Debugging
Test user
If you want to debug in staging or production environment, you could deploy the above script to production with the variable autoInit set to false. With that done, you can manually enable the inbox integration by putting this into the browser developer console:
After doing that the inbox integration will initiate with the sid variable defined. You can change the sid in runtime by setting the sid in the developer console before initiating it, like this:
Sending a demo message
You can send a demo message from the developer console (script has to be initialized first!):
If you want to you can also set the data in the message yourself, like this:
📥 Front end inbox actions
If you want to toggle the visibility of the inbox in the front end of your site, you can add this action on your inbox button in the main menu for example:
🖍Override Styles
If you want to override the styles in the inbox, all styles should be wrapped within the CSS id #fasttrack-crm. That protects your sites CSS and allows you to easily target CSS classes in the inbox. Place a block of CSS above the invocation of the integration script.
Example
Dynamic CSS Classes
If you want, you can also style the notifications different based on wether it is a inbox notification or On-Site notification. You can also style the entire inbox message / shoutout view or style the list of inbox messages depending on if they are read or unread. Here are some CSS examples:
Further, you can add a dynamic class from FT CRM. Let's say you want to distinguish between two different inbox notifications on the front end, you could then use the Dynamic CSS field in FT CRM on the Inbox / On-Site notification action. If they are not enabled, ask your FT CRM Integrations Manager to enable them for you. Here are some examples of how to target the CSS: