Conectar Motive: llevar las ubicaciones de los vehículos a tracking
Complete el flujo OAuth 2.0 de Motive fuera de este sistema, pegue el access token en Integration, deje la URL base de la API por defecto salvo que use un endpoint regional, pruebe, mapee y active.
El conector de Motive lee las ubicaciones de los vehículos de su flota de Motive (antes KeepTruckin) y las convierte en eventos de tracking en TMS, para seguir un envío en tránsito por la posición del vehículo. Ese es su único trabajo: solo lee ubicaciones de vehículos. No trae pedidos, no crea despachos ni cargas, no lee registros del conductor ni horas de servicio y no escribe nada de vuelta en Motive. Una conexión trabaja con un access token de Motive.
Requisitos previos#
- Una cuenta de flota de Motive con vehículos que reportan ubicaciones, y los vehículos que quiere seguir ya configurados en Motive.
- Una forma de completar el flujo authorization_code de OAuth 2.0 de Motive fuera de este sistema: autorizar en gomotive.com/oauth/authorize e intercambiar el código en gomotive.com/oauth/token. Esta conexión no tiene botón de autorización dentro del sistema: usted trae un access token ya obtenido y lo pega.
- El token debe llevar el permiso de ubicación de vehículos. Sin ese permiso, la prueba responde MISSING_SCOPE, así que revise los permisos de la App en el Motive Developer Portal antes de probar.
- Usted sabe si su flota usa la dirección de API de Motive por defecto o un endpoint regional. La mayoría de las flotas usa la dirección por defecto y deja base_url vacío.
Obtener credenciales#
- Inicie el flujo OAuth 2.0 de Motive fuera de este sistema: abra gomotive.com/oauth/authorize y apruebe el acceso de su App de flota, siguiendo el flujo authorization_code con el que se configuró su App de Motive.
- Intercambie el código de autorización en gomotive.com/oauth/token para obtener el access token. El token es una cadena larga, con la forma mostrada en el paso de completar, que empieza con caracteres como eyJraWQiOiIyMDIwXzEi.
- Copie el access token completo de una vez y téngalo listo para pegar. No lo acorte y no añada espacios ni saltos de línea: un token recortado responde INVALID_TOKEN.
- Recuerde que este token caduca. Cuando caduca, esta conexión no puede renovarlo por usted: usted repite el mismo flujo authorization_code de OAuth y pega el token nuevo. Planifique esa renovación antes de que la flota deje de reportar.
Completar en Integration#
- Abra Integration → Marketplace → Motive → Nueva conexión.
- token, obligatorio, OAuth2 access token: pegue el access token completo que intercambió en gomotive.com/oauth/token, por ejemplo una cadena larga que empieza con eyJraWQiOiIyMDIwXzEi. Es un campo de tipo contraseña y se guarda como secreto.
- base_url, opcional, URL base de la API: déjelo vacío para usar el valor por defecto https://api.gomotive.com. Complételo solo cuando su flota use un endpoint regional de la API de Motive, y en ese caso complete esa dirección de endpoint tal como Motive la entregó.
Probar la conexión#
Haga clic en Probar la conexión. Con un token completado, la prueba envía una solicitud real de solo lectura: GET {base_url}/v2/vehicle_locations con su token como credencial Bearer, con un tiempo límite de 12 segundos. Una respuesta 200 significa que el token es aceptado y que el endpoint de ubicaciones responde. Una respuesta 401 vuelve como INVALID_TOKEN: el token no es válido o ha caducado. Una respuesta 403 vuelve como MISSING_SCOPE: el token no lleva el permiso de ubicación de vehículos. Una solicitud que no responde a tiempo vuelve como TIMEOUT. Corrija la causa que indica el código y pruebe de nuevo: la prueba no cambia ningún dato en Motive.
Mapping / elegir plantilla#
Elija el mapping estándar de Motive. Toma cada ubicación de vehículo devuelta para su flota y la convierte en un evento de tracking de TMS para ese vehículo, de modo que las posiciones coinciden con el vehículo y el envío que sigue en TMS. Tras aprobar la prueba, ejecute una lectura y compare un vehículo que sepa que está en ruta: contraste su última posición aquí con el mismo vehículo en Motive. Si la posición coincide, el mapping es correcto y puede activar.
Activar#
Tras activar, la conexión lee las ubicaciones de los vehículos de Motive con su token y mantiene el tracking de TMS actualizado con las últimas posiciones de la flota. Vigile las primeras lecturas en Runs / Logs y compare algunos vehículos con Motive antes de dejar la conexión sin supervisión, y anote la fecha de caducidad del token para renovarlo a tiempo.
Lo que esta conexión no hace: no trae pedidos ni cargas de Motive, no crea ni cambia despachos, no lee registros del conductor, horas de servicio ni registros de combustible, y no envía posiciones ni ningún otro dato de vuelta a Motive. Siga gestionando eso en el propio Motive o en los sistemas donde el trabajo ocurre realmente.
Preguntas frecuentes#
La prueba falla con INVALID_TOKEN (401)
Motive rechazó el token: no es válido o ha caducado. Los access tokens del flujo authorization_code de OAuth no duran para siempre, y un token recortado al copiarlo se rechaza igual: la prueba no distingue un token cortado de uno caducado.
Repita el flujo authorization_code de OAuth de Motive (autorice en gomotive.com/oauth/authorize e intercambie el código en gomotive.com/oauth/token), copie el access token nuevo completo, péguelo en el campo token, guarde y pruebe de nuevo. Esta conexión no tiene botón de renovar: un token nuevo siempre viene de una nueva vuelta de OAuth.
La prueba falla con MISSING_SCOPE (403)
El token en sí fue aceptado, pero no lleva el permiso de ubicación de vehículos, así que Motive no le permite leer las ubicaciones. Los valores que completó no son el problema: el permiso no se concedió a la App cuando se emitió el token.
Abra el Motive Developer Portal, revise los permisos de la App y asegúrese de que el acceso a ubicaciones de vehículos está concedido; después repita el flujo OAuth para emitir un token con ese permiso, pegue el token nuevo y pruebe de nuevo.
La prueba falla con TIMEOUT
La solicitud de ubicaciones no respondió en 12 segundos. Es un problema de alcance en el camino a la API de Motive (una base_url incorrecta, un endpoint regional que no responde para su flota o una lentitud temporal de la API de Motive), no una prueba de que el token esté mal.
Revise primero base_url: déjelo vacío para el valor por defecto https://api.gomotive.com, salvo que su flota use de verdad un endpoint regional. Después pruebe de nuevo. Si el timeout se repite con la dirección por defecto, espere un poco y reinténtelo, y conserve la hora del fallo de Runs / Logs cuando pida ayuda.
Conectaba antes, luego las ubicaciones dejaron de actualizarse
La causa más común es que el access token llegó a su fecha de caducidad. La conexión conserva el token antiguo y no puede renovarlo por sí sola, así que las lecturas empiezan a fallar, normalmente con INVALID_TOKEN en los registros, sin que nada más haya cambiado en la conexión.
Repita el flujo authorization_code de OAuth, pegue el access token nuevo en el campo token, guarde y pruebe. Cuando la prueba apruebe, las posiciones se reanudan. Esta vez anote la nueva fecha de caducidad para que la próxima renovación ocurra antes de que caduque.
Conectado, pero un vehículo no muestra posición
La conexión devuelve las ubicaciones que Motive tiene de la flota: si el propio Motive no tiene una ubicación actual para ese vehículo (vehículo apagado, fuera de cobertura o sin reportar), no hay nada que este sistema pueda mostrar para él. Una conexión sana no puede inventar una posición que Motive no tiene.
Revise primero ese mismo vehículo en Motive. Si Motive muestra una posición actual y este sistema no, ejecute una lectura manual, compare el vehículo en Runs / Logs y pruebe la conexión de nuevo. Si Motive tampoco muestra nada, corrija el reporte de ese vehículo en el lado de Motive.
¿Por qué no llegan pedidos ni despachos por Motive?
Porque este conector solo lee ubicaciones de vehículos. Los pedidos, las cargas y los despachos no forman parte de lo que puede leer de Motive, así que una lista de pedidos vacía aquí es el comportamiento esperado, no una conexión rota.
Siga creando y gestionando pedidos y despachos en los sistemas donde ese trabajo ocurre, y use esta conexión para lo que hace: seguir en el tracking de TMS a los vehículos que llevan esos envíos.