Telematics Integration

ℹ️ Pro+ feature

Samsara

Full integration with Samsara's fleet management platform.

• Vehicle GPS location
• Odometer and engine hours
• Fuel level and consumption
• Fault codes (DTCs)
• Driver assignments

Motive (formerly KeepTruckin)

Integration with Motive's ELD and fleet tracking platform.

• Vehicle location
• Odometer readings
• Engine hours
• Diagnostic codes
• ELD compliance data

Geotab

Integration with Geotab's comprehensive fleet management system.

• GPS tracking
• Odometer and engine hours
• Engine diagnostics
• Fuel usage
• Driver behavior data

Samsara setup

1. 1

   Go to Integrations

   Navigate to Settings → Integrations.
2. 2

   Find Samsara

   Locate the Samsara section and click Connect.
3. 3

   Enter API token

   In your Samsara dashboard, create an API token with read access. Paste it into BayTrack.
4. 4

   Test connection

   Click Test Connection to verify it works.
5. 5

   Save

   Save the connection. BayTrack will start syncing vehicle data.

Motive setup

1. 1

   Go to Integrations

   Navigate to Settings → Integrations.
2. 2

   Find Motive

   Locate the Motive section and click Connect.
3. 3

   Enter API key

   In your Motive dashboard, generate an API key. Paste it into BayTrack.
4. 4

   Test and save

   Test the connection and save.

Geotab setup

1. 1

   Go to Integrations

   Navigate to Settings → Integrations.
2. 2

   Find Geotab

   Locate the Geotab section and click Connect.
3. 3

   Enter credentials

   Enter your Geotab database name, username, and password.
4. 4

   Authorize

   Authorize BayTrack to access your Geotab data.
5. 5

   Save

   Save the connection.

Why mapping is needed

Telematics systems track vehicles by their own IDs. BayTrack assets have separate IDs. Mapping tells BayTrack which telematics vehicle corresponds to which asset.

How to map vehicles

1. 1

   Go to vehicle mapping

   In Settings → Integrations, click Map Vehicles for your provider.
2. 2

   View telematics vehicles

   You'll see a list of all vehicles from your telematics account.
3. 3

   Match to assets

   For each telematics vehicle, select the corresponding BayTrack asset. BayTrack will try to auto-match by VIN or unit number.
4. 4

   Save mappings

   Click Save. Data will start syncing for mapped vehicles.

Unmapped vehicles

Unmapped vehicles won't sync data. You can map them later, or leave them unmapped if they're not in your BayTrack fleet (rental equipment, personal vehicles, etc.).

Mileage / Odometer

• Current odometer reading updates automatically
• PM schedules based on miles recalculate due dates
• Mileage-based alerts trigger accurately

Engine hours

• Current engine hours update automatically
• PM schedules based on hours recalculate due dates
• Useful for equipment that doesn't track mileage

Fault codes (DTCs)

• Active diagnostic trouble codes display on asset detail
• See engine, transmission, ABS, and other system faults
• Fault code descriptions help identify issues

Location

• Last known GPS location
• Helpful for mobile service dispatch
• Location updates periodically (not real-time GPS tracking)

Fuel data (where available)

• Fuel level percentage
• Fuel consumption over time
• Used for fuel efficiency reports (Pro+ Fuel Efficiency report)

How it works

• PM schedules based on miles use actual odometer readings
• PM schedules based on hours use actual engine hours
• Due dates recalculate as data syncs
• No more guessing or manual mileage entry

Example

You set up an oil change every 15,000 miles. The asset currently shows 120,450 miles (from telematics), and the last oil change was at 108,000 miles. BayTrack calculates the next oil change is due at 123,000 miles — in approximately 2,550 miles.

As the vehicle drives and telematics syncs new odometer readings, the "miles remaining" count updates automatically.

Asset Telematics tab

Each mapped asset has a Telematics tab showing:

• Current odometer and engine hours
• Last sync time
• GPS location (map view)
• Active fault codes
• Fuel level (if available)

Dashboard widgets

Pro+ includes dashboard widgets for:

• Vehicles with active fault codes
• Low fuel alerts
• Sync status overview

ℹ️ Note on real-time

Connection failed

• Verify your API key or credentials are correct
• Check that your telematics account is active
• Ensure the API key has read permissions
• Try disconnecting and reconnecting

Vehicle not showing

• Check that the vehicle exists in your telematics account
• Verify it's not in a group you've excluded
• Try refreshing the vehicle list

Data not syncing

• Confirm the vehicle is mapped to a BayTrack asset
• Check the last sync time — wait for next sync cycle
• Use manual sync to force an update
• Verify the telematics device is reporting to the provider

Incorrect mileage

• Telematics mileage comes directly from the vehicle ECM
• If the telematics provider shows wrong data, contact them
• You can manually override mileage on the asset if needed