Automatizaciones

Las tres piezas

Toda automatización tiene un disparador (qué la despierta), opcionalmente unos filtros (a qué vehículos o zonas aplica) y una o más acciones (qué hace). Nada más.

Qué puede despertarla

Cualquiera de los eventos que la plataforma ya detecta. Eliges uno o varios:

SOS

El conductor pulsa el botón de emergencia del equipo.

Choque detectado

El acelerómetro detecta un impacto.

Remolque detectado

El vehículo se mueve con el motor apagado.

Robo de combustible

Caída brusca del nivel de combustible.

Suplantación sospechosa

La posición da un salto imposible.

SIM extraída

Le sacaron el chip al equipo.

Entrada / salida de geocerca

El vehículo entra o sale de una zona que definiste.

Exceso de velocidad

Supera el límite que fijamos para tu flota (90 km/h por defecto).

Frenada, aceleración o giro brusco

Conducción agresiva.

Encendido / apagado del motor

Arranca o se apaga.

Mantenimiento vencido

Se cumplió un recordatorio de servicio.

Batería baja

El equipo se está quedando sin energía.

Acota siempre a algo. Una automatización activa necesita al menos un tipo de evento — si no, reaccionaría a todo lo que pasa en tu flota. Además puedes limitarla a vehículos concretos o a geocercas concretas, buscándolos por nombre o placa.

Qué puede hacer

Enviar un correo

A una o varias direcciones. El texto lo escribes tú y puedes intercalar datos del evento.

Mandar un mensaje de Telegram

A un chat o a un grupo, con los datos del evento. Puede incluir la ubicación del vehículo: un pin que se toca y abre el mapa.

Llamar a un webhook

Una petición HTTP a tu CRM, a Slack, a Make o a cualquier sistema tuyo. Le mandas los datos con el formato que ese sistema espera.

Mandar un comando al equipo

Cortar el motor, restablecerlo, activar una salida, reiniciar el equipo. Es la acción más delicada y se comporta distinto: ver más abajo.

Esperar

Pausar hasta cinco minutos antes del siguiente paso. Sirve para secuencias del tipo "manda el comando, espera medio minuto, comprueba".

Preguntar (condición)

Bifurca el flujo según un dato del evento. "¿La caída de combustible fue de más del 15%?" — si sí, una rama; si no, otra.

Avisar por Telegram

Es probablemente la forma más rápida de que un aviso llegue a alguien: al móvil, sin depender de que mire el correo. Funciona tanto a una persona como a un grupo del equipo.

Usa tu propio bot, no uno nuestro. Se monta una sola vez y son tres pasos:

1. En Telegram, habla con @BotFather, manda /newbot y ponle nombre. Te devuelve un token.
2. En Ubitrack, entra en Automatizaciones → Secretos, pulsa Nuevo secreto y pega ahí ese token. Se guarda cifrado y no se puede volver a ver — sólo reemplazar. El botón Verificar le pregunta a Telegram si es válido.
3. En la automatización, añade el paso Telegram, elige tu bot y pulsa Buscar destinos.

Ese último botón resuelve la parte que suele atascar a todo el mundo: no necesitas saber ningún identificador. Escríbele /start a tu bot desde Telegram —o mételo en el grupo y manda cualquier mensaje—, pulsa Buscar destinos, y eliges de una lista con nombres.

El token no se escribe dentro de la automatización. Vive en Secretos y el paso sólo lo referencia por su nombre. Así puedes cambiarlo en un sitio —si lo revocas y creas otro— sin tocar ninguna de las automatizaciones que lo usan.

Varias cosas a la vez, y esperar a que terminen

Las acciones no tienen que ir en fila. Un paso puede lanzar varias ramas en paralelo, y varias ramas pueden juntarse en un paso común que espera a que todas terminen antes de seguir.

Eso es lo que permite el ejemplo de arriba: el correo y el webhook salen a la vez —no uno detrás del otro— y el corte de motor no ocurre hasta que ambos hayan terminado. En el editor se dibuja arrastrando: cada acción es una tarjeta que mueves donde quieras, y las flechas entre ellas son las que mandan.

Lo único que no se puede es cerrar un bucle: una automatización tiene que avanzar hasta terminar. El editor no te dejará dibujar una flecha que vuelva hacia atrás.

Poner condiciones

El paso Preguntar deja pasar el flujo sólo si se cumple lo que le pidas. Eliges el dato de una lista —no hay que escribir nada raro— y con qué compararlo.

Puedes encadenar varias con Y / O, y agruparlas: «va a más de 120 y (es un camión o lleva carga)». El botón que hay entre dos condiciones cambia todo el grupo de «y» a «o».

La lista de datos disponibles cambia según el evento que escuche la automatización, porque cada evento trae cosas distintas:

En cualquier evento puedes comparar además el vehículo, su placa o tipo, el conductor, la geocerca y la severidad.

Ojo con los equipos a batería. Los rastreadores Jimi mandan una alarma sin detalle: un exceso de velocidad suyo no incluye la velocidad. Si tu flota los mezcla con equipos Teltonika, una condición sobre la velocidad no se cumplirá para esos vehículos. El editor marca esos datos como parciales.

Personalizar los mensajes

En el asunto, el cuerpo de un correo o el contenido de un webhook puedes intercalar datos del evento escribiéndolos entre llaves dobles. El editor los lista todos y, al pulsar uno, lo escribe donde tengas el cursor.

Mientras escribes, los campos se colorean y la lista de la derecha te enseña en qué se va a convertir cada uno con los datos de tu flota: junto a {{asset.label}} verás el nombre y la placa de un vehículo tuyo de verdad.

Si un campo sale en naranja es que no existe. No da error: el correo saldría igual, pero con un <missing:…> en medio. Antes eso sólo se descubría cuando el correo ya se había enviado.

Y antes de activar nada, el botón Probar recorre la automatización entera contra un evento real y te enseña qué haría cada paso. No envía nada — sólo te lo muestra.

Cuando algo falla

Internet falla y los servidores de terceros se caen. Si un correo o un webhook no sale a la primera, se reintenta automáticamente hasta tres veces, esperando cada vez un poco más. Una alerta no se pierde porque el servidor de tu CRM tuvo un mal minuto.

Los comandos al vehículo no se reintentan nunca. Es deliberado. Cortar un motor no se deshace, y un reintento tardío podría cortar un vehículo en marcha por una situación que ya se resolvió. Si un comando falla, la ejecución queda marcada en rojo para que una persona decida qué hacer. Por la misma razón, una automatización tampoco actúa sobre eventos de hace horas: si el sistema estuvo detenido, al volver no vacía la cola de golpe.

Si un paso falla del todo, por defecto la ejecución se detiene ahí y los pasos siguientes no corren. Preferimos parar a medias y avisar antes que seguir ejecutando sobre una premisa que ya falló.

Puedes cambiarlo paso a paso. En cada acción hay un ajuste «Si este paso falla»: déjalo en Detener —lo normal— o ponlo en Seguir con el resto para el caso legítimo de «avísame por Slack y, si Slack está caído, continúa igual». La ejecución queda entonces marcada «con avisos»: ni exitosa —algo no salió— ni fallida —hizo lo demás—.

Cuidado al ponerlo en «seguir». Si más adelante en ese mismo flujo hay un corte de motor, correrá aunque el paso anterior no haya funcionado. Es exactamente la situación que el comportamiento por defecto evita.

Y hay un tope de duración por automatización, una hora por defecto. Si una ejecución tarda más —por ejemplo porque reintenta contra un servidor que sigue caído— se corta y queda como fallida, en vez de quedarse abierta indefinidamente. Se cambia en los ajustes del editor.

Historial

Cada vez que una automatización se dispara queda registrada. Lo ves en dos sitios: la pestaña Ejecuciones de la lista, con lo de todas las automatizaciones junto, y dentro de cada una, filtrado sólo por ella.

De cada paso se guardan las dos mitades: qué recibió —el correo tal como se redactó, el cuerpo que se le mandó al webhook, con los datos ya puestos— y qué devolvió. Es lo que convierte un «no llegó el correo» en «el asunto salió vacío porque el campo estaba mal escrito». Las contraseñas y credenciales nunca se guardan.

Cuánto detalle se guarda lo decides tú en los ajustes de cada automatización: Sólo lo que falla, Normal (lo habitual) o Detallado, que no recorta nada y conviene usar sólo mientras persigues algo concreto. El historial se conserva 30 días.

Antes de activar

• Las automatizaciones nacen apagadas, incluidas las que creas desde una plantilla. Revísalas y actívalas tú.
• Las plantillas traen datos de ejemplo —como [email protected]— que tienes que cambiar por los tuyos.
• Para cortar el motor hace falta que el relé esté declarado en la instalación del equipo. Si no lo está, la plataforma lo rechaza en vez de reportar un corte que no ocurrió.
• Usa Probar antes de activar. Especialmente si hay un comando al vehículo de por medio.