Aplicable a : Administrador, Administrador de socios, Soporte · Módulo : Integraciones
Última revisión : junio de 2026 · Propietario : Equipo de soporte
Proveedor: Samsara · Dirección de sincronización: Unidireccional: Samsara envía datos de ubicación, horario de servicio y sensor de temperatura a Alvys.
Ubicación: Administración > Perfil de la empresa > Pestaña Integraciones
Descripción general
La integración de Samsara conecta sus datos ELD y telemáticos con Alvys, lo que permite el seguimiento en tiempo real de la ubicación de camiones y remolques, el control de las horas de servicio (HOS), la generación de informes de kilometraje IFTA y el acceso a los datos de los sensores de temperatura para remolques refrigerados. La configuración requiere generar un token en Samsara y, posteriormente, vincular cada activo en Alvys. Esta integración también se conoce como seguimiento ELD de Samsara, telemática de Samsara o seguimiento de flotas de Samsara. Los datos fluyen en una sola dirección, desde Samsara hacia Alvys. Alvys no envía datos de carga ni de despacho de vuelta a Samsara a través de esta integración.
Requisitos previos
Antes de configurar la integración con Samsara, confirme lo siguiente:
Tienes una cuenta activa de Samsara con acceso de administrador.
Has iniciado sesión en Alvys con el rol de "Administrador" , "Administrador de socios" o "Soporte" . Los usuarios que no tengan uno de estos roles no pueden acceder a la página de Integraciones.
Sus filiales ya están configuradas en Alvys. La integración se aplica por filial, por lo que todas las filiales que tengan activos equipados con Samsara deben existir en Alvys antes de conectarse.
Sus camiones y remolques ya están configurados en Alvys antes de que complete el paso de identificación de activos (paso 3 a continuación).
¿Cómo conectarse?
La configuración de la integración consta de tres partes: generar un token en Samsara, configurar la integración en Alvys y, a continuación, añadir los ID de activos de Samsara a cada camión y remolque.
Genera un token de Samsara
Inicia sesión en tu cuenta de Samsara y ve a "Configuración" .
Seleccione la pestaña "Aplicaciones" .
Busca "Alvys" en la lista de aplicaciones y haz clic en su tarjeta.
Haz clic en "Habilitar" .
Página de Samsara Apps, tarjeta de Alvys con botón Habilitar.
Página de Samsara Apps, tarjeta de Alvys con botón Habilitar.
Samsara le pedirá que acepte los términos del "Anexo de importación y uso compartido de datos de Samsara" . Acepte los términos para continuar.
Pantalla de aceptación del Anexo de importación y compartición de datos de Samsara.
Pantalla de aceptación del Anexo de importación y compartición de datos de Samsara.
Samsara mostrará un token en la siguiente ventana. Copie este token; lo necesitará al configurar la integración en Alvys.
Ventana de generación de tokens Samsara.
Configurar Samsara en Alvys
En Alvys, navegue a "Administración" > "Integraciones" .
En la pestaña "ELD" , busque "Samsara" y haga clic en el botón azul "Integrar" .
En la ventana "Agregar integración" , utilice el menú desplegable para seleccionar "Samsara" .
Pega el token que copiaste de Samsara en el campo "Clave API" .
Seleccione las filiales para las que se utilizará Samsara. Para aplicar la integración a todas las filiales, marque la casilla "Todas las filiales" .
Haz clic en el botón azul "Guardar" .
Agregue los identificadores de activos de Samsara a los camiones y remolques.
Antes de comenzar, confirme que todos los camiones y remolques que desea conectar ya estén configurados en Alvys.
En Alvys, seleccione "Activos" en el menú de la izquierda y luego elija "Camiones" o "Remolques" .
En la lista de activos, busque el activo que desea configurar y haga doble clic sobre él para abrir la página "Editar activo" .
Desplácese hacia abajo hasta la sección "Integraciones ELD" y haga clic en el botón azul "Agregar integración" .
En la ventana "Agregar integración" , seleccione "Samsara" en el menú desplegable.
Localiza el ID del activo en Samsara. Este ID se encuentra en la URL cuando visualizas el activo en Samsara. Por ejemplo, en la URL https://cloud.samsara.com/o/25542/devices/281474978231471/vehicle , el ID del activo es 281474978231471 (el número que aparece en la sección de dispositivos de la URL).
Ejemplo de URL de recurso de Samsara con el ID del recurso resaltado.
Ejemplo de URL de recurso de Samsara con el ID del recurso resaltado.
Pegue el ID del activo en el campo "ID de integración" .
Para remolques: complete únicamente el campo "ID del activo" . Deje el campo "ID del sensor" en blanco. Una vez que guarde el ID del activo, Alvys conectará automáticamente todos los sensores externos asociados, incluidos los sensores de temperatura y de puertas.
Haz clic en el botón azul "Guardar" .
Repita estos pasos para cada camión y remolque restante.
¿Qué se sincroniza?
Samsara envía los siguientes tipos de datos a Alvys a través de esta integración:
Datos de localización: posición GPS en tiempo real de camiones y remolques, mostrada en el mapa de activos de Alvys.
Horas de Servicio (HOS): registros de horas de servicio de los conductores de camiones equipados con Samsara, utilizados para la visibilidad del cumplimiento en la planificación de despachos.
Kilometraje IFTA: datos de kilometraje estado por estado extraídos de Samsara y utilizados en el módulo de informes IFTA de Alvys.
Datos de temperatura y sensores de puerta: para remolques refrigerados, Samsara transmite lecturas de temperatura y eventos de apertura/cierre de puerta. Estos se conectan automáticamente al guardar el ID del remolque; no es necesario introducir un ID de sensor por separado.
El ID del activo introducido en Alvys debe coincidir con el ID del activo de Samsara que aparece en la URL al visualizar el activo en Samsara. Si los ID no coinciden, se impedirá el flujo de datos a dicho activo.
Cómo se comporta la sincronización:
Una vez que se guarda un ID de activo y la integración está activa para la filial correspondiente, los datos de Samsara se transfieren a Alvys de forma continua.
Cada activo debe vincularse individualmente con su ID de activo de Samsara. La vinculación de la integración a nivel de filial no vincula automáticamente los activos individuales.
Si un conductor asignado a un viaje no está vinculado a tu cuenta de Samsara, Alvys mostrará una advertencia durante la asignación del viaje. Los flujos de trabajo basados en tabletas no estarán disponibles para ese viaje: las tareas de parada, la carga de documentos y los formularios se deshabilitarán cuando el conductor no esté vinculado a Samsara.
La integración con Samsara es compatible con todas las filiales de tu cuenta de Alvys. Al seleccionar "Todas las filiales" al configurar la integración, el token se aplica a todas ellas.
Lo que no es compatible:
El campo "ID del sensor" para remolques no se utiliza con Samsara. Déjelo en blanco; todos los sensores asociados se conectan automáticamente a través del ID del activo.
Los datos de Samsara no fluyen de vuelta desde Alvys a Samsara. Las asignaciones de carga, las actualizaciones de parada y los cambios de despacho en Alvys no se envían a Samsara.
Cada activo debe vincularse individualmente. No existe la importación masiva de identificadores de activos de Samsara.
La integración con Samsara solo está disponible para las filiales seleccionadas explícitamente durante el paso de integración. Los activos pertenecientes a una filial que no haya sido seleccionada no recibirán datos.
Para verificar que la integración esté activa después de la configuración:
Navegue a "Administración" > "Integraciones" y confirme que Samsara aparece como conectado en la pestaña "ELD" .
Abra un activo (camión o remolque) que haya vinculado con un ID de activo de Samsara y confirme que la sección "Integraciones ELD" muestre a Samsara como una integración activa.
Consulta el mapa de activos de Alvys para confirmar que el camión o remolque muestra una ubicación.
Si utiliza Samsara para la declaración IFTA, acceda al módulo IFTA y confirme que aparecen los datos de kilometraje del ELD para los camiones correspondientes.
Solución de problemas
Samsara no aparece en la pestaña ELD en Administración > Integraciones.
Confirma que has iniciado sesión con un rol de "Administrador" , "Administrador de socios" o "Soporte" . Los usuarios sin estos roles no pueden acceder a la página de Integraciones.
Confirma que tu cuenta de Alvys tenga habilitada la integración con Samsara. Si no ves Samsara en la lista, ponte en contacto con el soporte de Alvys para verificar que la integración esté disponible para tu cuenta.
Los datos del ELD no se están transmitiendo a un activo.
Abra el recurso en Alvys y verifique que Samsara aparezca en la sección "Integraciones ELD" con el ID de recurso correcto guardado.
Confirme que el ID del activo en Alvys coincide con el ID del activo de Samsara que aparece en la URL al visualizar el activo en Samsara. El ID debe introducirse exactamente como aparece en la URL.
Confirma que la filial a la que pertenece este activo se seleccionó al guardar la integración de Samsara. Si la filial no se incluyó, edita la integración y añádela.
Si todo lo anterior es correcto y aún así no aparecen los datos, póngase en contacto con el soporte técnico de Alvys.
El token Samsara no se acepta en Alvys.
Confirme que aceptó el Anexo de importación y compartición de datos de Samsara al generar el token. Los tokens generados sin aceptar el anexo podrían no tener los permisos necesarios.
Confirma que todos los permisos de ámbito granular necesarios se habilitaron al generar el token en Samsara. Si faltaba algún permiso, edita tu token existente en Samsara para agregarlo; el valor del token permanecerá igual.
Si el token se generó pero luego se revocó o caducó en Samsara, genere un nuevo token y actualice el campo Clave API en Alvys.
La asignación del conductor muestra una advertencia de Samsara.
Cuando Alvys muestra el mensaje de que un conductor no está vinculado a su cuenta de Samsara y que los flujos de trabajo basados en tabletas no estarán disponibles, significa que el registro del conductor en Alvys no coincide con el de su cuenta de Samsara. Verifique que el conductor exista en Samsara y que su registro en Alvys esté correctamente vinculado. Si el conductor no debe estar vinculado a Samsara para esa filial, puede ignorar la advertencia.
Preguntas frecuentes
P: ¿Qué sucede si no habilito todos los permisos de alcance granular al generar el token?
A: Los datos ELD de Samsara no se transferirán a Alvys. Asegúrese de que todos los permisos necesarios estén habilitados al generar su token en Samsara.
P: ¿Necesito crear un nuevo token si necesito agregar el permiso de escritura para sensores?
R: No, puedes editar tu token existente en Samsara para añadir el permiso Sensors: Write. El valor del token seguirá siendo el mismo después de la edición.
P: ¿Cómo puedo encontrar los ID de activos de Samsara para remolques con sensores de temperatura?
A: El ID del activo es el número visible en la URL cuando visualiza el tráiler en Samsara (por ejemplo, 281474978231471 de https://cloud.samsara.com/o/25542/devices/281474978231471/vehicle ). Una vez que guarde ese ID en Alvys, todos los sensores asociados, incluidos los de temperatura y de puertas, se conectarán automáticamente.
P: ¿Puedo usar el mismo token de Samsara para varias filiales?
R: Sí. Al agregar la integración de Samsara en Alvys, puede seleccionar varias filiales o elegir Todas las filiales. Un solo token cubre todas las filiales que seleccione.
P: ¿Por qué no se muestra la sección de Integraciones ELD en la página de un activo?
A: La sección Integraciones ELD aparece en todas las páginas de camiones y remolques. Si no la ve, desplácese hacia abajo en la página Editar activo; la sección se encuentra debajo de los detalles principales del activo. Si la sección no aparece, póngase en contacto con el soporte de Alvys.