Configuración de Notificaciones en Traccar: Correo, Push, SMS y Telegram

Las notificaciones son una forma esencial de mantener a los usuarios informados sobre eventos importantes. Traccar admite varios canales para la entrega de notificaciones, incluyendo correo electrónico, notificaciones push, SMS, Telegram y más.

Por defecto, Traccar tiene habilitados los canales web y de correo electrónico. Ten en cuenta que para que el correo electrónico funcione, es necesario configurar un servidor SMTP, ya sea por usuario o globalmente en el archivo de configuración.

Configuración de Correo Electrónico (Email)

Existen dos formas de configurar las notificaciones por correo:

1. Parámetros globales en el archivo de configuración del servidor (traccar.xml).
2. Configuración por usuario a través de los atributos de usuario.

Ejemplo de Configuración SSL (Gmail)

Si deseas usar Gmail, aquí tienes un ejemplo de configuración:

<entry key='mail.smtp.host'>smtp.gmail.com</entry>
<entry key='mail.smtp.port'>465</entry>
<entry key='mail.smtp.ssl.enable'>true</entry>
<entry key='mail.smtp.from'>tu-correo@gmail.com</entry>
<entry key='mail.smtp.auth'>true</entry>
<entry key='mail.smtp.username'>tu-correo@gmail.com</entry>
<entry key='mail.smtp.password'>tu-contraseña-de-aplicación</entry>

Ejemplo de Configuración STARTTLS

<entry key='mail.smtp.host'>smtp.gmail.com</entry>
<entry key='mail.smtp.port'>587</entry>
<entry key='mail.smtp.starttls.enable'>true</entry>
<entry key='mail.smtp.from'>tu-correo@gmail.com</entry>
<entry key='mail.smtp.auth'>true</entry>
<entry key='mail.smtp.username'>tu-correo@gmail.com</entry>
<entry key='mail.smtp.password'>tu-contraseña-de-aplicación</entry>

Configuración de Notificaciones Push

Las notificaciones push se envían a través de la plataforma Firebase. Hay dos opciones principales:

1. Notificaciones oficiales de Traccar: Para las aplicaciones oficiales Traccar Manager.
2. Notificaciones directas de Firebase: Para tu propia aplicación móvil personalizada.

Para recibir notificaciones en la aplicación oficial, configura los siguientes parámetros con tu clave de API (disponible en tu cuenta en traccar.org):

<entry key='notificator.types'>traccar,web,mail</entry>
<entry key='notificator.traccar.key'>TU_CLAVE_TRACCAR</entry>

Configuración de SMS

Traccar admite un formato flexible para trabajar con muchos proveedores de API de SMS. También puedes usar la aplicación Traccar SMS Gateway para Android para enviar SMS directamente desde tu propio teléfono.

Ejemplo de configuración para Traccar SMS Gateway:

<entry key='notificator.types'>sms,web,mail</entry>
<entry key='sms.http.url'>https://www.traccar.org/sms/</entry>
<entry key='sms.http.authorization'>TU_TOKEN</entry>
<entry key='sms.http.template'>
    {
        "to": "{phone}",
        "message": "{message}"
    }
</entry>

Configuración de Telegram

Telegram es una opción muy popular y económica para recibir alertas.

1. Crea un Bot: Usa @BotFather en Telegram para crear un bot y obtener tu clave (Token).
2. Obtén el Chat ID: Crea un grupo con tu bot o inicia una conversación y obtén el ID del chat.

Configuración en Traccar:

<entry key='notificator.types'>telegram,web,mail</entry>
<entry key='notificator.telegram.key'>TU_BOT_KEY</entry>
<entry key='notificator.telegram.chatId'>TU_CHAT_ID</entry>

El ID del chat también se puede configurar por usuario en los atributos de usuario de la plataforma.

Configuración Web

Las notificaciones web se entregan directamente a la aplicación web o móvil cuando está abierta y conectada al servidor. No requieren configuración adicional y están habilitadas por defecto. Se muestran como ventanas emergentes (toasts) y también están disponibles en el panel de eventos.

Plantillas (Templates)

Traccar utiliza el motor Velocity Engine para las plantillas de notificación. Los correos electrónicos utilizan el contenido completo de la plantilla, mientras que otros canales suelen utilizar la cadena de resumen (digest).

Las plantillas se encuentran en archivos .vm y deben estar en codificación UTF-8. Puedes personalizarlas o traducirlas según tus necesidades.