Please Note:To begin setting up your integration with Samsara, please make sure you have your subsidiaries setup first. Then, follow the instructions below to integrate with Samsara.
Part 1: Generate a Samsara API token
1
From within Samsara, please navigate to the Settings page, then find API Tokens and click "Add an API Token".
2
Name the token "Alvys" in order to easily identify it.
3
In Scopes/Global, please make sure that you have selected the Global Read checkbox.
Part 2: Configure the Samsara API token within Alvys
1
Once you have your Samsara API token, you are ready to configure it within Alvys. Navigate to the Management page within Alvys by clicking the Profile button in the upper right corner, then select "Management".
2
On the Management page, select the proper subsidiary from the left hand side, then find the Integrations section. Click the blue Integrate button, then the Add Integration pop-up window will appear.
3
In the Add Integration window, use the drop-down menu to find and select Samsara.
4
Next, copy and paste the API token from Samsara into the API Key field.
5
Select which subsidiaries Samsara will be used for. If it will be used for all subsidiaries, select the checkbox for "All Subsidiaries".
6
Click the blue Save button.
Part 3: Add the Samsara asset ID to individual assets within Alvys
Please Note: Before beginning part 3, you'll need to have your trucks and/or trailers set up in the Alvys system.
1
Find the Assets option on the blue Alvys toolbar, then select either trucks or trailers (depending on what you need to set up).
![Samsara [https://alvys.com/wp-content/uploads/2022/10/Samsara.svg, 1 min. read] 1](https://alvys.com/wp-content/uploads/2022/10/AssetsMenu.png)
2
From the list of assets, find and double click the particular asset you are ready to assign. This will open the Edit Asset page.
3
On the asset page, scroll down to find the ELD Integrations section, then click the blue Add Integration button. Then, the Add Integration pop-up window will appear.
4
In the Add Integration window, click the drop-down menu and select Samsara.
5
Next, find the Samsara asset ID (which can be found in the hyperlink of the asset when viewing it within Samsara), then paste it into the Integration ID field in the Add Integration window.
Example of hyperlink (only use highlighted portion): https://cloud.samsara.com/o/25542/devices/281474978231471/vehicle?end_ms=1654232399999
![Samsara [https://alvys.com/wp-content/uploads/2022/10/Samsara.svg, 1 min. read] 2](https://alvys.com/wp-content/uploads/2022/10/Samsara.png)
6
Click the blue Save button. Repeat steps 2 through 6 for the rest of your Samsara trucks and/or trailers. After you've completed this step for applicable assets, then you're done! Great job!