Beacons BLE para herramientas, implementos y activos

Qué resuelve un beacon BLE

Un beacon no reemplaza un GPS de largo alcance. Sirve para saber que un activo estuvo cerca de un teléfono FlotaMaq y asociar esa detección con hora, RSSI y ubicación disponible del móvil.

Es especialmente útil para herramientas, implementos, accesorios y equipos que se mueven junto con personal o vehículos.

Perfiles soportados

• iBeacon mediante UUID, major y minor.
• Service UUID para periféricos que anuncian un servicio BLE conocido.
• Android usa el escáner BLE nativo con filtros del sistema.
• iOS usa Core Location para iBeacon y Core Bluetooth para Service UUID.

Privacidad por diseño

Las apps reciben únicamente la lista de identificadores configurados para la empresa. No suben un inventario general de Bluetooth cercanos ni persisten identificadores de periféricos ajenos.

Alertas de zona y ausencia

Un beacon puede asociarse a una geocerca esperada. Si se detecta fuera, FlotaMaq abre una alerta; si vuelve a verse dentro, la resuelve automáticamente.

También puede definirse cuánto tiempo puede pasar sin detecciones. Un chequeo periódico del servidor abre la alerta de beacon no visto cuando se supera ese intervalo.

Cómo activarlo en Android

1. 1Registrá el beacon en Geolocalización y Tracking → Beacons BLE.
2. 2Abrí la app FlotaMaq y entrá a Más → Seguimiento GPS → Beacons BLE.
3. 3Tocá Activar escaneo BLE y concedé los permisos de Bluetooth solicitados. En Android anteriores a 12 el sistema puede pedir ubicación para permitir el escaneo BLE.
4. 4Acercá el teléfono al beacon y verificá en el backend que cambie Última detección, RSSI y, cuando exista información suficiente, distancia estimada.

Importante: La app usa filtros BLE y modo de bajo consumo. Android puede espaciar o suspender callbacks cuando la aplicación queda totalmente en segundo plano.

Cómo activarlo en iPhone

1. 1Registrá el beacon como iBeacon o Service UUID.
2. 2En la app FlotaMaq abrí Más → Seguimiento GPS → Beacons BLE y tocá Activar escaneo BLE.
3. 3Concedé Bluetooth. Para iBeacon también debés permitir ubicación porque iOS usa Core Location para el ranging.
4. 4Verificá la primera detección desde el backend antes de definir alertas estrictas de ausencia.

Importante: Service UUID usa Core Bluetooth y el modo bluetooth-central; iOS puede agrupar descubrimientos en background. El escaneo no continúa si el usuario fuerza el cierre de la app.

Monitor de beacon no visto en Dokploy

La ausencia de un beacon no genera un evento por sí sola. Para abrir alertas de “no visto”, el servidor debe ejecutar periódicamente el endpoint protegido POST /api/cron/beacons/check.

Definí BEACON_MONITOR_SECRET en el entorno de FlotaMaq y programá un cron que invoque el endpoint con Authorization: Bearer. Una frecuencia de 10 a 15 minutos suele ser suficiente si el menor missingAfterMinutes configurado es igual o mayor a ese intervalo.

• No programes el cron con una frecuencia mayor que la necesaria para tu menor umbral de ausencia.
• Si ya usás CRON_SECRET, el endpoint puede reutilizarlo como fallback.
• El endpoint revisa todos los beacons habilitados y abre o resuelve alertas según su última detección.

Limitaciones de background

Android e iOS aplican restricciones de energía y privacidad al escaneo Bluetooth. FlotaMaq usa filtros y modos permitidos por cada plataforma, pero no promete una frecuencia constante cuando el sistema suspende la aplicación o el usuario fuerza su cierre.