Connect TFM to Alvys

​

Overview

TFM is an electronic logging device (ELD) solution, also known as a telematics or GPS tracking provider, that tracks driver Hours of Service and vehicle locations. The TFM integration lets Alvys pull live location data from your TFM-equipped trucks and trailers, giving you visibility on the Asset Map and in dispatch planning. To complete setup, you will generate a token in your TFM account, configure the integration in Alvys, and then map each truck or trailer to its TFM asset ID.

​

Prerequisites

Before connecting TFM to Alvys:

• You must have an active TFM account with permission to generate tokens.
• Each truck or trailer you want to track must already be set up in your TFM account.
• You must have the “Admin”, “Partner Admin”, or “Support” role in Alvys. These roles can access Company Profile > Integrations.
• If you manage multiple subsidiaries, complete the steps below once for each subsidiary you want to enable.

​

How to connect

​

Generate your TFM token

1. Log into your TFM account.
2. Navigate to Management and select API Tokens.
3. Click Generate Token. TFM account: Management > API Tokens screen showing the Generate Token button.
4. Enter a token name (for example, “Alvys Integration”) and click OK. TFM token name entry dialog with OK button.
5. The page refreshes and displays your new integration token. Copy this token; you will need it in the next section.

​

Enter your token in Alvys

1. In Alvys, click your profile icon in the lower-left corner to open Company Profile.
2. Select the subsidiary you want to configure.
3. Click the Integrations tab.
4. Expand the ELD section.
5. Click the pencil icon on the TFM card. Alvys Integrations tab with ELD section expanded and TFM card pencil icon visible.
6. Enter your TFM API Token in the field provided.
7. Click Save.

Alvys validates your credentials immediately. If the token is accepted, the TFM integration becomes active for that subsidiary.

​

Map each asset to its TFM asset ID

After the integration is active, you map individual trucks and trailers in Alvys to their corresponding asset IDs in TFM. This mapping tells Alvys which TFM asset to pull location data from for each vehicle. The Integration ID field in Alvys corresponds to the asset ID in your TFM account. To find an asset’s TFM ID, open the asset in your TFM account and look at the URL. The number at the end of the URL path is the asset ID. For example, if the URL is app.tfmeld.com/client/trucks/25236, the asset ID is 25236.

1. Go to Assets in the left navigation menu and select Trucks or Trailers.
2. Double-click the asset you want to configure to open its profile.
3. Scroll down to the ELD Integrations section and click Add Integration.
4. Select TFM from the dropdown.
5. Enter the TFM asset ID in the Integration ID field.
6. Click Save.

Repeat for each truck or trailer you want to track.

​

What syncs / data flow

• Data flows one way: TFM sends location and Hours of Service data to Alvys. Alvys does not send data back to TFM.
• Once an asset is mapped, Alvys pulls its location automatically and displays it on the Asset Map and in dispatch planning.
• Each subsidiary’s TFM integration is configured and synced independently.

​

Verify it is working

1. Go to Assets in the left navigation and select Trucks or Trailers.
2. Open a truck or trailer you have mapped.
3. Confirm the ELD Integrations section shows TFM with the asset ID you entered.
4. Open the Asset Map in Alvys and confirm the truck or trailer is showing a current location.

​

Troubleshooting

​

Token rejected at save

1. Confirm you copied the full token from TFM without any leading or trailing spaces.
2. Return to your TFM account under Management > API Tokens and generate a new token, then re-enter it in Alvys.
3. If the error persists, confirm your TFM account has permission to create tokens. Contact Alvys support if none of these reasons apply.

​

Asset location not appearing on the Asset Map after mapping

1. Confirm the asset ID you entered in Alvys matches exactly the number shown at the end of the URL path for that asset in your TFM account.
2. Confirm the asset is currently active and reporting in your TFM account.
3. Allow a few minutes for the first location update to sync after saving the mapping.
4. If the asset is active in TFM and the ID is correct but no location appears, contact Alvys support.

​

ELD section or TFM card not visible in Alvys

1. Confirm you are signed in with an Admin, Partner Admin, or Support role. The Integrations tab is not visible to other roles.
2. Confirm you are viewing a subsidiary, not the top-level company profile.
3. If you have the correct role and are on a subsidiary but the TFM card is still not visible, contact Alvys support.

​

FAQs

Q: Where do I find my TFM asset IDs? A: Open the asset in your TFM account. The asset ID is the number at the end of the URL path. For example, if the URL is app.tfmeld.com/client/trucks/25236, the asset ID is 25236. Q: Can I track both trucks and trailers with TFM? A: Yes. You can add the TFM integration to both trucks and trailers by mapping each asset separately under Assets > Trucks or Assets > Trailers. Q: What happens if I enter an invalid token? A: Alvys validates credentials before saving. If the token is incorrect, you will see an error immediately and the integration will not activate. Q: Can I use TFM for multiple subsidiaries? A: Yes. Repeat the connection and asset mapping steps for each subsidiary. Each subsidiary requires its own TFM token configuration.

​

Go Deeper

• FleetLocate ELD/Telematics
• Samsara ELD/Telematics
• ELD Rider ELD/Telematics