Using Samsara with SoterAI
Connect Samsara to SoterAI and bring fleet safety data — vehicles, drivers, safety events and hours of service — into your chats and workflows.
Like every SoterAI connector, the Samsara connection is read-only: SoterAI can read and search your data, but it cannot create, edit, or delete anything in Samsara.
Assisted setup. Samsara is connected with help from our team. In the Connectors panel, its card shows Request setup instead of Connect. You bring the access details from your side, and we set up the connection to your workspace for you — there is nothing to install.
Before you request setup
Have the following ready before you send your request:
- A read-only Samsara API token, created in your Samsara dashboard under Settings > API Tokens, with the scopes for the data you need
- Your Samsara dashboard region (US or EU)
- The data in scope, such as safety events or hours of service (HOS)
Keep your credentials safe. Don't paste passwords, secrets or tokens into the request email. List which details you have ready, and our team will confirm how to share them securely. Use credentials scoped to the minimum access you need.
What SoterAI can access
Once connected, SoterAI has read-only access to:
- Vehicles and drivers
- Safety events
- Hours of service (HOS) logs — limited to the scopes on your API token
Access is always limited to what the credentials you provide are allowed to read.
What SoterAI cannot do
- Cannot create, edit, or delete records in Samsara
- Cannot submit forms or trigger workflows inside Samsara
- Cannot access data outside the scope of your credentials
- Cannot change configuration, permissions, or user access
How to request setup
- 1Click the puzzle piece icon in the chat input bar to open the Connectors panel.
- 2Open the Available tab and find Samsara under Risk & safety (use the Search integrations bar if needed). The card shows a short summary of what we'll need.
- 3Click Request setup. A prefilled email to our support team opens, with the connector name and your workspace already filled in, plus the same checklist.
- 4Add any details you already have (without credentials) and send it.
- 5Our team will reply to arrange the next steps and set up the connection. Once it's live, Samsara appears in your Connected tab and you can use it in chat like any other connector.
If your email app doesn't open, write to help@soteranalytics.com with the subject ‘Connector setup request: Samsara’.
To remove access at any time, open the Connectors panel and click Disconnect on the Samsara card in the Connected tab.
Example queries
Once connected, just ask naturally.
Safety events
- "Which drivers had the most harsh braking events last month?"
Reading and analysing
- "Summarise HOS violations by depot this quarter"
- "Draft a toolbox talk based on our most common safety event types"
Use cases
Fleet safety reporting
Ask about safety events and hours of service in plain language, and get a summary by driver, vehicle or depot without building a report each time.
Targeted driver coaching
Spot the event types that come up most often and turn them into focused coaching conversations or toolbox talks.
Linking driving events with wider safety data
Review fleet events alongside your incident and risk data so patterns across the business are easier to see.
Troubleshooting
| Issue | Solution |
|---|---|
| My email app didn’t open when I clicked Request setup | Write to help@soteranalytics.com with the subject ‘Connector setup request: Samsara’. |
| SoterAI can’t see certain records | Access is limited by the permissions of the credentials you supplied. Ask your Samsara administrator to confirm what they can read. |
| Slow responses on large queries | Narrow your question, for example to a date range, site, or single record type. |
| Some data is missing | The API token only exposes the scopes it was created with. Create a new read-only token with the scopes you need and contact our support team. |
| Connection stops working | Samsara API tokens can be revoked or deleted in your dashboard. Create a new read-only token and contact our support team. |
For more general help, see Troubleshooting external app connections.