Connecter Samsara : importer le GPS des véhicules dans le suivi

Générez un API Token dans le Samsara Dashboard sous Settings → API Tokens avec un accès en lecture à fleet, vehicles et stats, collez-le dans Integration, choisissez l’URL de base US ou EU selon votre région, testez, mappez, activez.

Le connecteur Samsara lit le GPS des véhicules de votre flotte Samsara — pour chaque véhicule, l’heure GPS, la latitude et la longitude, le cap, la vitesse et le nom du lieu recherché pour cette position — et convertit ces positions en événements de suivi dans TMS, pour suivre un envoi en transit par véhicule. C’est son seul rôle : il ne lit que les positions des véhicules. Il n’importe pas les commandes, ne crée ni dispatch ni chargement, ne lit ni les journaux conducteur ni les heures de service, et n’écrit rien dans Samsara. Une connexion fonctionne avec un API Token Samsara.

Prérequis#

• Un compte flotte Samsara avec des véhicules qui remontent leur GPS, et les véhicules à suivre déjà configurés dans Samsara.
• Droit dans le Samsara Dashboard d’ouvrir Settings → API Tokens et de générer un token. Générer un token est une tâche côté administrateur : si vous ne voyez pas cette page, demandez à votre administrateur Samsara de créer le token pour vous.
• Le token doit disposer d’un accès en lecture à fleet, vehicles et stats. Un token généré sans l’accès en lecture à stats ne peut pas lire les stats GPS dont dépend cette connexion, et le test comme les lectures échoueront sur le droit d’accès.
• Vous savez à quelle région appartient votre compte Samsara. Les comptes US utilisent https://api.samsara.com ; les comptes EU utilisent https://api.eu.samsara.com. La région décide de base_url, et la mauvaise région ne répondra pas pour votre flotte.

Obtenir les identifiants#

1. Connectez-vous au Samsara Dashboard avec un compte pouvant gérer les API tokens et ouvrez Settings → API Tokens.
2. Générez un nouvel API Token pour cette intégration. Lors de la génération, accordez un accès en lecture à fleet, vehicles et stats — les trois — car la connexion lit le GPS des véhicules depuis les stats de la flotte.
3. Copiez le token affiché par Samsara, en entier. Il commence par samsara_api_ suivi d’une longue chaîne de caractères. Copiez-le au moment de la génération et gardez-le prêt à coller : traitez-le comme un mot de passe dès cet instant.
4. En même temps, confirmez une fois de plus votre région : US si votre compte est côté américain, EU s’il est côté européen. Vous utiliserez cette réponse pour base_url à l’étape suivante.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Samsara → Nouvelle connexion.
2. api_token, obligatoire, API Token : collez le token complet généré dans le Samsara Dashboard sous Settings → API Tokens, commençant par samsara_api_. C’est un champ de type mot de passe, conservé comme secret.
3. base_url, facultatif, Base URL : ce champ est votre sélecteur de région. Laissez-le vide, ou saisissez https://api.samsara.com, pour un compte US. Les clients EU doivent saisir https://api.eu.samsara.com à la place : avec une adresse US, une flotte EU ne répondra pas.

Tester la connexion#

Cliquez sur Tester la connexion. Avec un token saisi, le test envoie une vraie demande en lecture seule : GET {base_url}/fleet/vehicles/stats?types=gps avec votre token comme identifiant Bearer, avec un délai de 12 secondes. En cas de réussite, le résultat le confirme en toutes lettres : l’authentification par Bearer token a réussi et l’endpoint des positions des véhicules est joignable. Une réponse 401 ou 403 signifie que le token a été refusé : il est incorrect, n’est plus valide, ou il lui manque l’accès en lecture requis par l’endpoint. Une demande sans réponse dans le délai est signalée comme un timeout. Corrigez la cause, puis retestez : le test ne modifie aucune donnée dans Samsara.

Mapping / choisir un modèle#

Choisissez le mapping standard Samsara. Il prend chaque relevé GPS de véhicule — heure, latitude et longitude, cap, vitesse et nom du lieu de la position — et le convertit en événement de suivi TMS pour ce véhicule, de sorte que les positions correspondent au véhicule et à l’envoi suivis dans TMS. Après un test réussi, lancez une lecture et comparez un véhicule dont vous savez qu’il est en route : comparez sa dernière position, son cap et sa vitesse ici avec le même véhicule dans Samsara. S’ils correspondent, le mapping est correct et vous pouvez activer.

Activer#

Après activation, la connexion lit le GPS des véhicules dans Samsara avec votre token et tient le suivi TMS à jour avec les dernières positions, caps et vitesses de la flotte. Surveillez les premières lectures dans Runs / Logs et comparez quelques véhicules avec Samsara avant de laisser la connexion sans surveillance.

Ce que cette connexion ne fait pas : elle n’importe ni commandes ni chargements depuis Samsara, ne crée ni ne modifie de dispatch, ne lit ni journaux conducteur, ni heures de service, ni relevés de caméras ou de capteurs, et n’envoie ni positions ni aucune autre donnée vers Samsara. Continuez à gérer cela dans Samsara même, ou dans les systèmes où le travail se fait réellement.

FAQ#

Le test échoue avec 401 — le token est refusé

Samsara n’a pas accepté la valeur de api_token. Les causes habituelles tiennent à la valeur elle-même : elle a été collée en partie, un ancien token qui n’est plus valide a été collé, ou une valeur qui n’est pas un API Token Samsara a été collée dans le champ.

Allez dans le Samsara Dashboard → Settings → API Tokens, générez un nouveau token avec un accès en lecture à fleet, vehicles et stats, copiez-le en entier — il commence par samsara_api_ — collez-le dans api_token, enregistrez et retestez.

Le test échoue avec 403 — le token n’a pas l’accès en lecture

Le token est bien arrivé chez Samsara, mais il n’a pas le droit de lire ce que le test demande. Cette connexion lit le GPS des véhicules depuis les stats de la flotte : un token généré sans accès en lecture à fleet, vehicles et stats est donc refusé sur cet endpoint, même si le token lui-même existe.

Générez un nouveau token dans le Samsara Dashboard → Settings → API Tokens et, cette fois, accordez l’accès en lecture à fleet, vehicles et stats avant de le copier. Collez le nouveau token dans api_token, enregistrez et retestez : l’ancien token ne peut pas être modifié, son accès a été fixé lors de sa génération.

Le test expire sans jamais répondre

La demande de stats GPS n’a pas répondu en 12 secondes. C’est un problème d’accès vers l’API Samsara — le plus souvent une base_url pointant vers la mauvaise région pour votre flotte, ou un ralentissement temporaire de l’API Samsara — et non la preuve que le token est faux.

Vérifiez d’abord base_url par rapport à votre région : https://api.samsara.com pour les US, https://api.eu.samsara.com pour l’EU. Corrigez-la si elle pointe vers l’autre région, puis retestez. Si le délai se répète avec la bonne région, attendez un peu et réessayez, et gardez l’heure de l’échec tirée de Runs / Logs quand vous demandez de l’aide.

Flotte EU : tout semble correct, mais le test échoue toujours

La connexion pointe toujours vers l’adresse API US. base_url vaut par défaut https://api.samsara.com, et un compte EU n’y répond pas : le token et ses accès peuvent être parfaits, la flotte EU ne répondra quand même pas sur l’adresse US.

Réglez base_url sur https://api.eu.samsara.com, enregistrez et retestez la même connexion avec le même token — ne générez pas d’abord un nouveau token et ne changez rien d’autre.

Connecté, mais un véhicule n’affiche aucun GPS

La connexion renvoie le GPS que Samsara détient pour la flotte : si Samsara lui-même n’a pas de GPS actuel pour ce véhicule — véhicule éteint, hors couverture ou sans remontée — ce système n’a rien à afficher pour lui. Une connexion saine ne peut pas inventer une position que Samsara n’a pas.

Vérifiez d’abord ce même véhicule dans Samsara. Si Samsara affiche une position actuelle et que ce système ne l’affiche pas, lancez une lecture manuelle, comparez le véhicule dans Runs / Logs et retestez la connexion. Si Samsara n’affiche rien non plus, corrigez la remontée de ce véhicule côté Samsara.

Pourquoi aucune commande ni aucun dispatch n’arrive par Samsara ?

Parce que ce connecteur ne lit que les positions GPS des véhicules. Les commandes, les chargements et les dispatches ne font pas partie de ce qu’il peut lire dans Samsara : une liste de commandes vide ici est donc le comportement attendu, pas une connexion cassée.

Continuez à créer et gérer commandes et dispatches dans les systèmes où ce travail se fait, et utilisez cette connexion pour ce qu’elle fait : suivre dans le suivi TMS les véhicules qui transportent ces envois, avec position, cap et vitesse.