Cloud EntrarSign in Crear cuenta gratisCreate free account

Guía de usoUser guide

De cero a ver tus máquinas en el teléfono. Solo monitoreo: la plataforma nunca controla equipos.From zero to watching your machines on your phone. Monitoring only: the platform never controls equipment.

1. Crear tu cuentaCreate your account

  1. Entra a Crear cuenta.
  2. Escribe el nombre de tu empresa, tu correo y una contraseña con 8 o más caracteres, una mayúscula, una minúscula y un número.
  3. Lee y acepta las Condiciones de uso y la Privacidad.
  4. Entras directo al panel. Te llega un correo para confirmar tu dirección: ábrelo cuando puedas.

Quien crea la cuenta es el dueño de la empresa en la plataforma: puede invitar a otros y cambiar el plan.

  1. Go to Create account.
  2. Enter your company name, your email and a password with 8+ characters, an uppercase letter, a lowercase letter and a number.
  3. Read and accept the Terms of use and the Privacy policy.
  4. You go straight to the dashboard. You will get an email to confirm your address: open it when you can.

Whoever creates the account is the company owner on the platform: they can invite others and change the plan.

2. Ver la demostraciónSee the demo

En el Panel, pulsa Crear demostración (1 clic). Se crea una "Planta demo" con un "Compresor demo", sus reglas de alarma y datos de ejemplo. En la pantalla del equipo, el Simulador genera situaciones como Sobretemperatura para ver cómo llega una alarma. Los datos de demostración son simulados.

On the Dashboard press Create demo (1 click). A "Demo plant" with a "Demo compressor", its alarm rules and sample data are created. On the machine page, the Simulator produces situations such as Overtemperature so you can see an alarm arrive. Demo data is simulated.

3. Sitios y equiposSites and machines

  1. Equipos → Agregar un equipo: toca el tipo (Bomba, Motor, Compresor, Caldera…). No hay que escribir nada: el nombre (ej. "Bomba 1"), la planta, los rangos normales típicos de ese tipo y las reglas de alarma se llenan solos.
  2. Se abre su Configuración: si quieres, cambia el nombre o ajusta los rangos a la ficha técnica del equipo → Guardar. Las reglas de alarma se ajustan solas.
  3. ¿Varias plantas? En Nuevo sitio toca un nombre listo (Planta 2, Bodega, Línea 1…) y luego elige el sitio al agregar equipos.

Los rangos preestablecidos son valores de referencia típicos, no los de tu equipo exacto: revísalos con mantenimiento. Cada equipo muestra su ID en Configuración: lo necesitarás para el agente (paso 5).

  1. Equipment → Add a machine: tap its type (Pump, Motor, Compressor, Boiler…). Nothing to type: the name (e.g. "Pump 1"), the plant, typical normal ranges for that type and the alarm rules are filled in.
  2. Its Configuration opens: if you want, rename it or adjust the ranges to the machine's datasheet → Save. Alarm rules follow automatically.
  3. Several plants? Under New site tap a ready name (Plant 2, Warehouse, Line 1…) and then pick the site when adding machines.

Preset ranges are typical reference values, not your exact machine's: check them with maintenance. Each machine shows its ID under Configuration: you will need it for the agent (step 5).

4. Alarmas: sensibilidadAlarms: sensitivity

Cada equipo nuevo ya trae sus alarmas: temperatura alta, corriente alta, presión baja, vibración alta y sin conexión (si deja de enviar datos ~2 minutos). En Configuración elige con un toque la sensibilidad:

  • Tolerante: menos alarmas, avisa solo con desvíos grandes.
  • Normal (recomendada): los rangos típicos del tipo de equipo.
  • Estricta: avisa antes, con desvíos más pequeños.

Los límites de las alarmas se ajustan solos. Si conoces los valores exactos, usa Ajuste fino (números). Una alarma avisa una sola vez y se cierra sola cuando el valor vuelve a lo normal (con un pequeño margen, para no avisar una y otra vez si el valor oscila en el límite).

Cómo leer los valores: verde = normal · amarillo = cerca del límite · rojo = fuera de lo normal. Debajo de cada valor ves su rango normal y una barra con la zona verde.

Every new machine comes with its alarms: high temperature, high current, low pressure, high vibration and offline (if it stops sending data for ~2 minutes). Under Configuration pick the sensitivity with one tap:

  • Tolerant: fewer alarms, warns only with larger deviations.
  • Normal (recommended): typical ranges for the machine type.
  • Strict: warns earlier, with smaller deviations.

Alarm limits follow automatically. If you know the exact values, use Fine tuning (numbers). An alarm notifies once and closes by itself when the value is back to normal (with a small margin, so it does not keep alerting if the value hovers at the limit).

Reading the values: green = normal · yellow = close to the limit · red = out of normal. Under each value you see its normal range and a bar with the green zone.

5. Conectar tus equipos realesConnect your real machines

El agente de borde es un programa pequeño que corre en una Raspberry Pi o una PC de la planta. Lee tus PLC, medidores o gateways en la red local y envía los datos. Es solo lectura: nunca escribe ni manda comandos.

  1. En la web, Claves API → nombre (ej. "Raspberry Planta Norte") → Agregar. Copia la clave abx_…: se muestra una sola vez.
  2. En la Raspberry/PC instala el agente (carpeta edge-agent, archivo LEEME.md):
python3 -m venv venv && source venv/bin/activate
pip install httpx pymodbus        # pymodbus para Modbus TCP; paho-mqtt para MQTT
cp config.example.json config.json   # pon server_url, api_key, equipment_id y la fuente
python -m abx_agent --config config.json --once   # prueba
python -m abx_agent --config config.json          # funcionamiento continuo

Fuentes: Modbus TCP (registros holding/input) y MQTT (JSON). Si se cae internet, el agente guarda las lecturas y las envía al volver.

La clave API es como una contraseña: no la publiques. Si se pierde, revócala en Claves API y crea otra.

The edge agent is a small program that runs on a Raspberry Pi or a plant PC. It reads your PLCs, meters or gateways on the local network and sends the data. It is read-only: it never writes or sends commands.

  1. On the web, API keys → name (e.g. "Raspberry North Plant") → Add. Copy the abx_… key: it is shown only once.
  2. On the Raspberry/PC install the agent (folder edge-agent, file LEEME.md):
python3 -m venv venv && source venv/bin/activate
pip install httpx pymodbus        # pymodbus for Modbus TCP; paho-mqtt for MQTT
cp config.example.json config.json   # set server_url, api_key, equipment_id and the source
python -m abx_agent --config config.json --once   # test
python -m abx_agent --config config.json          # continuous

Sources: Modbus TCP (holding/input registers) and MQTT (JSON). If the internet drops, the agent stores readings and sends them later.

The API key is like a password: do not publish it. If it is lost, revoke it under API keys and create a new one.

6. Alarmas y diagnósticoAlarms and diagnostics

En Alarmas: Reconocer (ya la estoy atendiendo), Resolver (terminada) y Diagnóstico IA, que propone posibles causas y revisiones. Es una ayuda: la decisión y la inspección son de un técnico calificado. Si un equipo deja de enviar datos ~2 minutos, se marca sin conexión.

Under Alarms: Acknowledge (I'm on it), Resolve (done) and AI diagnostic, which suggests possible causes and checks. It is a helper: decisions and inspections belong to a qualified technician. If a machine stops sending data for ~2 minutes it is marked offline.

7. Alertas al teléfonoPhone alerts

  • App en el teléfono (gratis): Android/Chrome → menú ⋮ → Instalar app. iPhone/Safari → Compartir → Añadir a pantalla de inicio y abre la app desde ese icono. Luego Notificaciones → Activar alertas en este dispositivo.
  • Correo: los dueños y administradores reciben las alarmas críticas.
  • Telegram (gratis): Notificaciones → Vincular Telegram y sigue los pasos.

Los avisos llegan en el idioma que elijas con el botón EN/ES. No son un sistema de seguridad: dependen de internet, del teléfono y de terceros.

  • Phone app (free): Android/Chrome → menu ⋮ → Install app. iPhone/Safari → Share → Add to Home Screen and open the app from that icon. Then Notifications → Enable alerts on this device.
  • Email: owners and admins receive critical alarms.
  • Telegram (free): Notifications → Link Telegram and follow the steps.

Alerts arrive in the language you pick with the EN/ES button. They are not a safety system: they depend on the internet, your phone and third parties.

8. ReportesReports

Reportes muestra alarmas por severidad y por equipo, y horas de operación (1, 7, 30 o 90 días). Descargar CSV genera un archivo que abre directo en Excel, en español.

Reports shows alarms by severity and by machine, and runtime hours (1, 7, 30 or 90 days). Download CSV creates a file that opens directly in Excel.

9. Tu equipo de trabajoYour team

En Usuarios, el dueño o un administrador invita por correo y elige el rol:

  • Administrador: todo, menos planes y pagos.
  • Operador: ve todo, reconoce y resuelve alarmas, usa el simulador y agrega equipos.
  • Solo lectura: ve paneles, alarmas y reportes.

La persona recibe un enlace para elegir su contraseña (si el correo no está activado, copia el enlace y envíaselo tú). Puedes cambiar el rol o quitar el acceso cuando quieras.

Under Users, the owner or an admin invites by email and picks the role:

  • Admin: everything except plans and billing.
  • Operator: sees everything, acknowledges and resolves alarms, uses the simulator and adds machines.
  • Read-only: sees dashboards, alarms and reports.

The person gets a link to choose their password (if email is not enabled, copy the link and send it yourself). You can change the role or remove access at any time.

10. Planes y pagosPlans and billing

La prueba gratis no pide tarjeta. Para más equipos, el dueño pulsa Mejorar a… en el Panel y paga en la página segura de Stripe (este sitio nunca ve los datos de tu tarjeta). Después, Gestionar facturación permite cambiar de plan, actualizar la tarjeta, ver facturas o cancelar. Ver Condiciones de uso.

The free trial needs no card. For more machines, the owner presses Upgrade to… on the Dashboard and pays on Stripe's secure page (this site never sees your card). Then Manage billing lets you change plan, update the card, see invoices or cancel. See the Terms of use.

11. AyudaHelp

Escríbenos a automationbotx@gmail.com. Nunca te pediremos tu contraseña.

Write to automationbotx@gmail.com. We will never ask for your password.