TMS 7.11 Setup & Configuration

  • Updated on Jun 28, 2024
  • Published on May 24, 2024
  • 1 minute(s) read
Prev Next

Overview

The integration with the Samsara API provides direct integration to drivers and the assets they are driving through an ELD device and a phone application.

Samsara provides “push” status updates to the TMS via a sites-based web service. Inbound packets from Samsara are stored in the Queued Transaction table and processed by the QueuedTransactionJob.  

Setup

Enter Credentials

Enable the Samsara integration by: 

  1. Navigating to TMS Admin, 

  2. Select Credentials. 

  3. Select the Global Services tab,

  4. Find Samsara in the list and open the card. 

  5. Check the Enabled box.

  6. Enter the User ID and Password 1 into the text fields. 

  7. Set the Service URL to: https://api.samsara.com.

  8. Set the Test Service URL to: https://api.samsara.com.

  9. Click the Save button when finished.

User ID

Password 1

Password 2

Customer Number

"Revenova"

Required API Key


Remote Site Settings

Upgrading from previous versions of the TMS may have outdated information. Check that the Remote Site Settings for the Samsara integration URL are up to date.

  1. Click the Setup gear icon in the top right corner.

  2. From the drop-down, click Setup.

  3. In the Quick Find Toolbar type Remote Site Settings and click the link.

  4. From the list of remote sites find Samsara and click the Edit link.

  5.  Update the Remote Site URL to: https://api.samsara.com.

Partner Community Setup

The Samsara integration requires a webhook to send information into the TMS. Create an API Site to accept inbound traffic.

  1. Create a Salesforce Site for API Guest User Access.

  2. Set the public access for the Site.

  3. Activate and Publish the Site.

  4. Enter the API URL into the field for Inbound API Community URL under TMS Admin, in the Configuration section. 

  5. Add the following extension to the end of the URL to match the example below: /services/apexrest/rtms/tmslistener?org=[18-character org id]&source=Samsara&pwd=[credentials code field]

  6. Contact Samsara support and provided them this "Post-back" URL to point at your listener.

{API Community URL}/services/apexrest/rtms/tmslistener?org=[18-character org id]&source=Samsara&pwd=[credentials code field]

Example: https://revenova.my.site.com/api/services/apexrest/rtms/tmslistener?org=00D180000008oA9EAI&source=Samsara&pwd=4wGFDgnT950Ovg1

Related articles