Samsara Integration

Track asset locations, maintenance information, and more with the native Samsara integration. It works with Samsara GPS devices for customers in North America and Europe.

Supported Device Types

Fleetio currently integrates with the following Samsara device types:

• Vehicles (VG34 with GPS and CAN bus interface)
• Trailers (AG52, AG26 attached via 7-way cable)
• Reefers (AG52, AG26 attached to a refrigerated trailer)
• Powered Equipment (AG52, AG46P, AG26 attached via APWR, CAT, or J1939 cable)
• Unpowered Assets (AG46)

You can identify your Samsara device types in the Devices section of your Samsara account.

Adding the Integration

Before creating an API token in Samsara, it's good to double-check your assets in Fleetio. Once you're ready, you'll create the token, then copy it into Fleetio and configure your settings.

Check Fleetio Assets

There are two items to check in Fleetio:

• Assets are configured with the proper meters and meter measurement units. Samsara supports primary/secondary meter units in miles, kilometers, and engine hours.
• VINs are correct for each asset in Fleetio and Samsara. VINs are used to automatically map Samsara devices to Fleetio, so an asset with an incorrect or missing VIN will need to be manually mapped.

Create Samsara API Token

1. Log in to your Samsara account.
2. Select the Settings gear in the lower left corner of your Samsara dashboard, then select API Tokens from the Developer section.
3. Select + Add an API Token.

4. Enter a Name, such as Fleetio Integration.
5. Ensure the Tag Access option is set to Entire Organization.

6. Set the Global dropdown under Scopes as Global Read and Global Write.

7. Click Save.

Enter the API Token in Fleetio

1. Click Integrations in the Sidebar Navigation.

2. Click Telematics in the Integrations Directory.

3. Click the Connect button in the Samsara tile.

4. Enter the API Token you created in Samsara, select your Region, and then click Next.

5. Choose whether to Sync Vehicles and Devices in Fleetio, which will import your Samsara vehicles into Fleetio, or Only Add the Devices, then click Connect Samsara to Fleetio.

It may take a few minutes for Fleetio to process the integration and map your assets from Samsara to Fleetio.

Manually Map Assets

If an asset doesn't have a VIN or can't be automatically mapped from Samsara, you can manually map devices.

1. Click Integrations in the Sidebar Navigation.
2. Click My Integrations in the Integrations Directory.

3. Click the More Actions Button for Samsara and select Manage Devices. This will bring you to the Telematics Devices list filtered by the Samsara integration.

4. Choose the corresponding Fleetio Vehicle by clicking the Unassigned link under the Assigned Vehicle column in each unmapped row.

Reference the Manage Telematics Devices article for more information on managing your devices through the Telematics Devices page.

Managing Integration Settings

Settings can be adjusted at any time after your initial setup. To get to your settings:

1. Click Integrations in the Sidebar Navigation.
2. Click My Integrations in the Integrations Directory.

3. Click the More Actions Button for Samsara and select Edit.

4. In the Settings section, use the checkboxes to turn on/off the Fuel Vendor Location Alerts, Engine Faults, or DVIR Defects.

5. When you're finished, click Save.

Fuel Vendor Location Alerts

If the Fuel Vendor Location Alerts setting is enabled, Fleetio will notify the Account Owner if a fuel entry is logged outside of the designated Exception Radius. These Exceptions only occur on transactions from a fuel card integration.

Fault Rules for Fault Codes

If the Engine Faults setting is enabled, Fleetio will create Faults against the asset from Diagnostic Trouble Codes and other engine alerts using your Samsara device.

Currently, Fleetio can import OBD-II and J1939 Faults from Samsara devices. By default, these are imported nightly, but there is an optional setting to import them hourly.

Issues from DVIR Defects

Samsara DVIR Defects fall into one of three general types.

Import DVIR Defects

If the Import DVIR Defects setting is enabled, Fleetio will create an issue from certain DVIR Defects entered through the Samsara mobile app. These are imported every hour.

If a defect is imported, Fleetio will:

• attempt to match the first and last name of the Samsara user to a Fleetio contact.
• attempt to provide an issue name. Depending on the Samsara DVIR source, the name may appear as "Other." This can happen when a driver selects multiple attributes for a given component that has a defect.

Push Issue Resolutions back to Samsara

If you enable Pushing DVIR Defect Resolutions Back to Samsara, Fleetio will resolve issues in Samsara when they are resolved in Fleetio, thereby no longer showing as an open defect. This only applies to issues that have been resolved, not closed.

Refreshing Meters

Primary and secondary meter readings automatically sync every day at midnight (in your account's time zone), but you can also manually trigger an update at any time.

1. Click Integrations in the Sidebar Navigation.
2. Click My Integrations in the Integrations Directory.

3. Click the More Actions Button for Samsara and select Refresh Devices.

With this integration, Fleetio pulls meters from your Vehicle's ECU. If the ECU value is not available for any reason, Fleetio will pull the calculated GPS meter from Samsara.

Using Integration Links to get to Samsara

On the Vehicle Details page, you can go directly to Samsara by clicking the View in Samsara link in the Integration section.

Viewing Telematics Sensor Data on a Vehicle

For Vehicles that use telematics devices with the Samsara integration, you can view sensor data directly from the Vehicle in Fleetio. Reference the Viewing Telematics Sensor Data on a Vehicle article for more information.

Troubleshooting

I'm getting a message that says, "Samsara Vehicle Gateways are missing VINs." What do I do?

First, confirm you are using a supported Samsara device. If you are using a supported device, you need to enter the missing VINs in Samsara.

1. Log in to your Samsara account using a web browser (this cannot be completed in the mobile app).
2. Select the icon in the lower-left corner of the Samsara dashboard, then select Devices > Gateways.
3. Select the Add VINs button on the warning banner
4. Enter the corresponding VIN for each Vehicle name, then select Save.

I'm not receiving meter updates and faults.

Check that the VIN is entered properly in Samsara and that it is mapped to the correct asset in Fleetio.

My meter keeps showing the same value.

Check to see if there is a tooltip next to the entry that provides the most recent date and time the meter was pulled. The Advanced Meter Topics article covers this in-depth.

Samsara Driver App Custom Tile

Fleetio Go can be launched from within the Samsara Driver mobile app using a custom tile deep link. This functionality is set up and managed directly within the Samsara Cloud portal.

To enable the Custom Tile:

1. Navigate to the Samsara Cloud Portal (https://cloud.samsara.com/) and log in.
2. Click the Gear Icon in the menu on the left to access your settings.

3. Scroll down to the Fleet section and click Driver App.

4. Click the Features tab, then in the Custom App Tiles section, click Add Tile.

5. Complete the fields in the pop-up:
   • In the Tile Name text box (a), enter Fleetio or Fleetio Go.
   • In the Deep Link or URL text box (b), enter fleetiogo://dashboard
   • Select a tile background color (c).

6. When you're finished, Click Done.

The custom tile will download to the Samsara Driver App the next time the driver opens the app on their mobile device.

When the user taps the custom tile, Fleetio Go will open to the main dashboard.