Cómo configurar Firebase (FCM) en Traccar para Notificaciones Push

Las notificaciones push son fundamentales para cualquier aplicación de rastreo moderna. Traccar utiliza Firebase Cloud Messaging (FCM) para enviar estas alertas a dispositivos móviles de manera eficiente y gratuita.

Requisitos Previos

1. Tener una cuenta en Firebase Console.
2. Haber configurado un proyecto de Firebase.
3. Si usas una App personalizada, tener el archivo google-services.json (Android) o GoogleService-Info.plist (iOS) integrado en tu código fuente.

Configuración del Servidor Traccar

Para que el servidor Traccar pueda enviar las alertas a Firebase, debemos configurar la "Server Key" en el archivo traccar.xml.

1. Obtener la Clave de Firebase

1. Entra a tu proyecto en la Consola de Firebase.
2. Haz clic en el icono de engranaje (Configuración del proyecto).
3. Ve a la pestaña Cloud Messaging.
4. Copia la Clave de servidor (si usas la API antigua) o configura una Cuenta de servicio para la API v1 (recomendado).

2. Editar traccar.xml

Añade las siguientes entradas a tu archivo de configuración:

<!-- Habilitar el tipo de notificador firebase -->
<entry key='notificator.types'>web,mail,firebase</entry>

<!-- Clave de servidor de Firebase -->
<entry key='notificator.firebase.key'>TU_SERVER_KEY_AQUÍ</entry>

Nota: Si estás usando la nueva API de Firebase, el proceso requiere un archivo JSON de cuenta de servicio, pero la mayoría de las instalaciones de Traccar siguen usando la Server Key clásica.

Cómo llegan las notificaciones al usuario

Para que un usuario reciba la notificación push, deben cumplirse dos condiciones:

1. Token del dispositivo: La aplicación móvil debe registrar el "FCM Token" del teléfono en el atributo del usuario dentro de Traccar. Esto sucede automáticamente cuando el usuario inicia sesión en la aplicación oficial o una bien configurada.
2. Atributos: El atributo en la base de datos se guarda generalmente como fcmToken.

Pruebas de funcionamiento

Puedes verificar si la configuración es correcta desde el panel de Traccar:

1. Ve a Ajustes -> Notificaciones.
2. Selecciona una notificación y haz clic en el icono de "Prueba" (la campana).
3. Si el servidor está bien configurado y el usuario tiene un token válido, el teléfono debería recibir la alerta al instante.

Solución de problemas comunes

• No llega la notificación: Verifica que el teléfono tenga permisos de notificación activados para la App y que no esté en modo "Ahorro de batería" agresivo.
• Error en los logs: Revisa el archivo tracker-server.log. Si ves errores de "401 Unauthorized", significa que tu notificator.firebase.key es incorrecta o ha expirado.
• Token no registrado: Si el atributo fcmToken no aparece en el usuario, la aplicación móvil no se está comunicando correctamente con Firebase.

Configurar Firebase correctamente garantiza que tus usuarios nunca se pierdan una alerta importante, mejorando la seguridad y confianza en tu servicio de rastreo.