Skip to main content

Samsara Integration (DVIR)

availability
Platform:WebMobile
Plan Type:BasicEssentialPremiumEnterprise
User Type:RequesterFull UserAdministrator
note
  • There are other Samsara integrations available depending on your plan. Contact your MaintainX representative for more information.
  • The Workflow Automations feature is not available for customers with a Samsara integration at this time.

The MaintainX integration for Samsara synchronizes data between MaintainX and Samsara.

The integration allows Driver Vehicle Inspection Reports (DVIRs) from Samsara to be transferred over as Work Requests or Work Orders in MaintainX.

Requirements

  • Your organization is on a MaintainX Premium or Enterprise plan.
  • Your organization has purchased the MaintainX Samsara integration.
  • Administrator rights for your MaintainX organization.
  • Administrator rights for your Samsara organization.
  • MaintainX assets are mapped to Samsara assets by the MaintainX integration team.
  • MaintainX meters and meter triggers are set up.
  • Payload URL provided by your MaintainX representative.

Setup and Configuration

To set up and configure the Samsara integration with MaintainX, you need to:

Samsara Setup​

  1. From the sidebar, create a new Samsara API Token by navigating to API Tokens and select Add an API Token.

    • Ensure the token has DVIR Write Access and is stored securely.

    • For a complete list of steps, see Create an API Token.

  2. From the sidebar, create a Samsara Webhook by navigating to Settings > Webhooks and select Add Webhook.

    • Fill in the Name and Payload URL provided by your MaintainX representative.

    • For a complete list of steps, see Register the webhook handler.

  3. From the sidebar, create a Samsara Alert by navigating to Alerts > Configured Alerts and select Create Alert.

    • Select the DVIR Submitted trigger and select your desired conditions.

    • Add an additional Action to Send Webhook.

    • Select the webhook that was created in step 2.

    • For a complete list of steps, see Alert Configuration.

    note

    The Conditions and DVIR Durations that are selected here filter which DVIRs are submitted to MaintainX as work requests/orders. You can modify them at any time.

MaintainX Configuration Form​

Complete the MaintainX Samsara Configuration Form provided by your MaintainX representative.

You need the following information to complete the form:

  • Samsara API Token (obtained from step 1 of the Samsara setup).
  • Samsara Webhook Secret (obtained from step 2 of the Samsara setup).
  • Samsara Organization ID (obtained from Samsara Settings).
  • Default Samsara DVIR Resolver’s Name (name of the user who will be resolving DVIRs).
  • Samsara Tag Names (if connecting multiple organizations).
  • MaintainX Organization ID (provided by your MaintainX representative).
  • Default priority level for MaintainX work request/order.
  • Frequency of Data Transfer (For example, every 4 hours).

Setup Additional Assets​

You can also set up additional assets (vehicles) in Samsara so that their data is transmitted into MaintainX.

To set up an additional vehicle in Samsara:

  1. Generate a Vehicle in Samsara.

  2. Obtain the unique Samsara ID by navigating to the Vehicle URL.

    • The Vehicle Samsara ID is stored right after /devices/.
    Vehicle URL
    Vehicle URL

  3. Create an Asset in MaintainX with the same name as the Samsara Asset.

    • Populate the Samsara Asset ID with the ID obtained from step 1.

  4. Create a Meter in MaintainX that's connected to the Asset created in step 2.

    • Select the unit to either be Hours (if reading engine hours) or Miles (if reading mileage).

The MaintainX meter will populate with the correct data at the next data sync. A DVIR will be correctly linked in MaintainX if it's submitted with the vehicle.