GPS Insight and WhipAround have partnered to simplify fleet management by enabling seamless integration between the two platforms. This integration allows WhipAround to pull critical fleet data from GPS Insight. This data flows into Whip Around to update Location, Odometer and generates new Defects for every DTC.
To initiate the integration, you will need to generate an App Token from within the GPS Insight Portal.
Step 1: GPS Insight - generate an App Token
What is an App Token: An App Token is the most secure method for authenticating API access without exposing your login credentials. It acts as an alias for your credentials, enabling you to securely retrieve a session token. This authentication method is ideal for scenarios where you want to avoid passing sensitive login details through HTTP requests or sharing your portal credentials with third-party vendors. Additionally, access granted through the App Token can be revoked or modified at any time.
How to Generate an App Token
Standard Tier Customers: Please contact your Account Manager or Support team to request the creation of an App Token for the WhipAround integration.
Pro/Enterprise Customers: Follow the steps below to generate your own App Token:
Log into the GPS Insight portal.
From the Explore screen, click Manage Users.
In the Manage Users screen, click Third-Party Access to API V2 Functions.
In the API Apps List grid, click the API App button next to Create New.
In the New API App window, enter an App Name and Description, then click Save API App.
A new App Token will be generated.
Benefits of Using an App Token
The App Token authentication method offers several advantages:
It does not grant access to the GPS Insight portal.
It can be easily changed or deactivated by an admin user.
App usage can be monitored and tracked.
Password changes will not affect the API flow, unlike regular login credentials.
Note: Limiting Vehicle Access for API Users
If you do not want the API to have access to all vehicles in your fleet, we recommend creating a dedicated WhipAround user with restricted vehicle access and permissions for API use only. For example, you can create a user named simplytransit.whiparound specifically for API access. This way, you can ensure that only specific vehicles and data are accessible to WhipAround.
Step 2: Add App Token into Whip Around
Completing the Integration Setup
Once you have your App Token, along with the GPS Insight username, copy, and paste it into the WhipAround integration setup page to complete the connection.
From the top right hand corner, click Integrations
Under GPS Insight, select Activate
Enter your GPS Insight username and App Token
Click Submit
Vehicle Data Synchronization
For WhipAround to correctly match your GPS Insight vehicle data with the WhipAround portal, ensure that vehicles in both systems have matching VINs assigned. This will allow the data to sync accurately between the two platforms.
Please contact us at [email protected] or call us at +1 844-537-2100 if you would like to discuss your integration requirements.