Sign in Talk to us Free trial
Free trial

Design and software studio
Colour

Connect Samsara, Motive or Geotab

Paste your own Samsara, Motive or Geotab credentials, test the connection, match vehicles and bring their positions onto the Live map.

For
OwnerAdministrator
Hosting
Any hosting
Devices
Web browser
Business
TowingFleet

Checked against Pop Dispatch 0.1.0

If your trucks already carry a Samsara, Motive or Geotab device, Pop Dispatch can fetch their positions and show them on the Live map. You will be able to connect one or more of these accounts, match each vehicle to one of your assets and bring the positions in.

You bring your own vendor account. The Pop Street has no partnership with these vendors and charges no fee for the connection. A vendor may charge you for access to its programming interface (API). Ask your vendor before you start.

Before you start #

  • The owner saves the keys and switches a connection on. Owners and managers can change the vehicle matching. Dispatchers can read the cards.
  • Each vehicle you want on the map is an asset in Fleet (see fleet-assets-screens).
  • What you need from your vendor account:
    • Samsara: an API token.
    • Motive: an API key.
    • Geotab: a user name, a password and the database name. The server address is optional.

Steps #

  1. Open Settings, then Connections. Each vendor has a card showing its status: off, saved, connected or error.
  2. On the card, paste the credentials you collected from your vendor and save. Pop Dispatch seals them and hides them after saving.
  3. Choose Test connection. A passing test reads "ok" and lists the vehicles it found. Fix the credentials if it fails.
  4. Switch the connection on. The switch works after a passing test.
  5. Open the vehicle matching. Each vehicle from the vendor shows beside a menu of your assets. Match each one, or leave it unmatched.
  6. Choose Sync now. The result reports how many positions were fetched, how many were stored and how many belonged to unmatched vehicles.
  7. Open the Live map. Matched vehicles show their pins and a track (see reading-the-live-map).

To stop, switch the connection off, or remove it to delete the saved credentials.

Technical details
  • Cards: GET /integrations/telematics. Save: PUT /integrations/telematics/:provider (api_token for Samsara, api_key for Motive, username, password, database and server for Geotab). Test: POST .../test. Switch: POST .../enable with enabled. Remove: DELETE.
  • Vehicles: GET .../vehicles and POST .../vehicles/map with external_id and asset_id (null removes the match). Sync: POST .../sync.
  • Positions land in the position history with the source hardware and the device id <provider>:<external_id>.
  • Secrets are sealed in storage and left out of every reply.

If something goes wrong #

  • Test connection fails: re-copy the credential from your vendor account, then test again. The card shows the last error.
  • The switch refuses to turn on: run a passing test first.
  • Sync reports unmatched vehicles: match them in step 5, then sync again.
  • A vehicle has no pin: check it is matched and that the vendor has sent a position.