Cómo conectar dispositivos de Digi International a TagoIO

Digi International fabrica algunos de los gateways industriales y routers celulares más fiables del mercado. Su línea de dispositivos, desde el gateway IX15 LTE-M hasta el router serie IX30, conecta sensores y máquinas de campo a internet en entornos donde la fiabilidad no es opcional.

TagoIO te da la capa de aplicación: gestión de dispositivos, almacenamiento de datos, dashboards en tiempo real, alertas automáticas y una API REST completa sobre la que construir. Las dos plataformas se complementan muy bien.

Pero llevar los datos de un dispositivo Digi hasta TagoIO no es automático. Tienes que elegir la ruta de integración correcta, dar el formato adecuado al payload y configurar ambos lados. Esta guía cubre exactamente eso, con instrucciones paso a paso para cada enfoque y ejemplos en cuatro áreas de aplicación: edificios inteligentes, monitoreo industrial, agricultura y equipos inteligentes.

Qué necesitas antes de empezar

Una cuenta de TagoIO (plan gratuito disponible)
Un gateway Digi (IX15, IX20, IX30 o similar) o una cuenta de Digi Remote Manager
Acceso a internet desde el dispositivo Digi

Cómo funciona la integración

Hay dos rutas principales para llevar los datos de los dispositivos Digi a TagoIO:

Ruta 1: DataStreams de Digi Remote Manager + webhook HTTPS Esta es la ruta recomendada cuando ya usas DRM para gestionar tu flota. DRM recopila los datos de tus dispositivos Digi a través de DataStreams y puede reenviarlos a cualquier endpoint HTTPS, incluida la API de TagoIO.

Ruta 2: MQTT directo desde el gateway Digi Si tu gateway Digi ejecuta un script de Python o tiene un cliente MQTT integrado, puedes conectarlo directamente al broker MQTT de TagoIO usando TagoTiP. Esto evita DRM por completo y te da una latencia más baja.

Ambas rutas funcionan. Elige la que se ajuste a tu configuración actual.

Ruta 1: DataStreams de Digi Remote Manager a TagoIO

Paso 1: Crea un dispositivo en TagoIO

Inicia sesión en admin.tago.io.
Haz clic en Devices en la barra lateral izquierda.
Haz clic en Add Device.
Selecciona HTTPS como tipo de conector.
Dale un nombre al dispositivo (por ejemplo, digi-ix15-building-a).
Haz clic en Create Device.

Documentación completa de configuración de dispositivos: docs.tago.io/docs/tagoio/devices

Paso 2: Copia el token del dispositivo

Después de crear el dispositivo, ve a la pestaña General y copia el Device Token. Lo usarás para autenticar las solicitudes que vienen de DRM.

Más sobre tokens: docs.tago.io/docs/tagoio/devices/device-token

Paso 3: Configura una suscripción de DataStream en Digi Remote Manager

En DRM, los DataStreams son canales de datos con nombre en los que tu dispositivo Digi escribe (por ejemplo, temperature, humidity, battery_level). Puedes suscribirte a esos streams y enviar los datos a un endpoint HTTPS externo.

Inicia sesión en tu cuenta de DRM en devicecloud.digi.com.
Ve a Data Services > DataStreams.
Encuentra los data streams que provienen de tu dispositivo. Siguen el formato /dia/channel/<device-id>/<stream-name>.
Ve a Monitor y crea una nueva Monitor subscription.
Define el tema con los data streams que quieres reenviar.
Define el método de entrega como HTTP POST.
Define la URL del endpoint como:
```
https://api.tago.io/data
```
Añade el siguiente encabezado HTTP:
```
Device-Token: YOUR_DEVICE_TOKEN
```

Ahora DRM enviará datos por POST a TagoIO cada vez que llegue un nuevo valor a los streams suscritos.

Paso 4: Mapea el payload de DRM a variables de TagoIO

DRM envía los datos en su propio formato XML o JSON. TagoIO espera el formato de datos estándar:

[
  {"variable": "temperature", "value": 23.5, "unit": "C"},
  {"variable": "humidity", "value": 65, "unit": "%"}
]

Si DRM está enviando una estructura diferente, usa un Payload Parser en TagoIO para transformar el payload entrante antes de que se almacene.

Para añadir un parser:

Abre tu dispositivo en TagoIO.
Ve a la pestaña Payload Parser.
Escribe una función de JavaScript que extraiga las variables del payload de DRM y las devuelva en el formato de TagoIO.

Paso 5: Verifica los datos en el Live Inspector

Abre la pestaña Live Inspector en la página de tu dispositivo en TagoIO. Muestra cada solicitud entrante en tiempo real. Envía una lectura de prueba desde DRM y confirma que los datos aparecen aquí antes de construir tu dashboard.

Documentación del Live Inspector: docs.tago.io/docs/tagoio/devices/live-inspector

Ruta 2: MQTT directo desde el gateway Digi

Los gateways Digi que ejecutan firmware de Digi o scripts de Python pueden conectarse directamente a TagoIO vía MQTT usando el protocolo TagoTiP.

Paso 1: Crea un dispositivo TagoTiP en TagoIO

En TagoIO, ve a Devices > Add Device.
Busca TagoTiP y selecciónalo como conector.
Dale un nombre al dispositivo y define su Serial Number (esto se asocia al tema MQTT).
Guarda el dispositivo y anota el Authorization Hash de la pestaña General.

Paso 2: Conecta el cliente MQTT del gateway Digi

Configura el cliente MQTT de tu dispositivo Digi con estos ajustes:

Ajuste	Valor
Host	`mqtt.tip.us-e1.tago.io` (EE. UU.) o `mqtt.tip.eu-w1.tago.io` (UE)
Puerto	`1883` (dev) o `8883` con TLS (producción)
Usuario	Los primeros 8 caracteres hexadecimales de tu Authorization Hash
Contraseña	Los últimos 8 caracteres hexadecimales de tu Authorization Hash
Tema de publicación	`$tip/{serial}/push`
Tema de suscripción	`$tip/{serial}/ack`

Paso 3: Publica los datos del sensor

El formato de payload de TagoTiP es compacto y legible para personas:

[temperature:=23.5#C;humidity:=65#%]

Para un Digi IX15 con un sensor de temperatura conectado, un script de Python ejecutándose en el gateway se vería así:

import paho.mqtt.client as mqtt

SERIAL = "ix15-building-a"
AUTH_HASH = "4deedd7bab8817ec"  # replace with your hash
HOST = "mqtt.tip.us-e1.tago.io"

client = mqtt.Client()
client.username_pw_set(AUTH_HASH[:8], AUTH_HASH[8:])
client.connect(HOST, 1883)

payload = "[temperature:=23.5#C;humidity:=65#%]"
client.publish(f"$tip/{SERIAL}/push", payload)
client.disconnect()

Documentación completa de TagoTiP: docs.tago.io/docs/tagotip/transports/mqtt

Paso 6: Construye tu dashboard

Una vez que los datos están fluyendo hacia TagoIO, ve a Dashboards y haz clic en + para crear uno nuevo.

TagoIO ofrece plantillas de dashboard prediseñadas desde las que puedes empezar. En el diálogo de creación del dashboard, busca Templates para encontrar diseños listos para usar en aplicaciones comunes, incluido el monitoreo ambiental y el seguimiento de activos. Después puedes adaptar los widgets a las variables de datos de tu Digi.

Documentación de dashboards: docs.tago.io/docs/tagoio/dashboards

Para aplicaciones que gestionan varios dispositivos Digi en distintas ubicaciones, usa un Blueprint Dashboard. Los blueprint dashboards usan tags para asociar automáticamente un mismo diseño de dashboard con varios dispositivos. Creas el diseño una sola vez y cada dispositivo obtiene su propia vista.

Paso 7: Configura alertas y acciones automáticas

Usa las Actions de TagoIO para disparar notificaciones o lógica cuando los valores de los sensores cruzan umbrales. Por ejemplo, envía un email o un SMS cuando un sensor de temperatura en una sala de servidores supere los 30 C, o dispara un script cuando una máquina se desconecta.

Documentación de Actions: docs.tago.io/docs/tagoio/actions

Ejemplos de aplicación

Edificios inteligentes

Los gateways Digi IX15 o IX20 se conectan a BACnet/IP, Modbus RTU o entradas de sensores directas dentro de un edificio. Variables comunes para enviar a TagoIO:

Temperatura y humedad del HVAC por zona
Consumo de energía (kWh) por circuito
Conteos de sensores de ocupación
Detección de fugas de agua (alerta binaria)

En el dashboard, usa gráficos de series temporales para las tendencias de energía y widgets de tarjeta para las temperaturas actuales por zona. Configura alertas para avisar al equipo de instalaciones cuando una zona quede fuera de la banda de confort.

Monitoreo industrial

Los routers Digi IX30 e IX40 tienen puertos serie RS-232/RS-485 que se conectan a PLCs y a equipos industriales heredados. Envía a TagoIO:

Conteos de ciclos de máquina y métricas de OEE
Consumo de corriente del motor y vibración
Velocidad y rendimiento de la cinta transportadora
Códigos de alarma de los registros del PLC

Usa scripts de Analysis de TagoIO para calcular el OEE a partir de los datos brutos de ciclos y escribir el resultado en una variable del dashboard. Las alertas pueden disparar un sistema de órdenes de trabajo a través de la API de TagoIO cuando una máquina entra en estado de fallo.

Agricultura

El Digi IX15 con conectividad LTE-M funciona en zonas con cobertura celular limitada. Despliégalo en una estación de bombeo o en un invernadero y envía:

Humedad del suelo a varias profundidades
Temperatura del aire y humedad relativa
Caudal de riego y estado de la válvula
Nivel de agua del tanque

Usa la función Blueprint Dashboard para crear un único diseño y aplicarlo a todas las estaciones de campo. Cada estación obtiene su propia vista de dashboard sin duplicar la configuración.

Equipos inteligentes (flotas y activos)

Los routers de la serie Digi WR y los módulos celulares XBee son habituales en equipos móviles. Envía a TagoIO:

Ubicación GPS
Horas de motor y consumo de combustible
Estados de sensores de puertas y compartimentos
Voltaje de batería en equipos eléctricos

TagoIO almacena los datos de ubicación y puede mostrarlos en un widget de mapa. Combínalos con datos de series temporales para correlacionar la ubicación con el consumo de combustible o los eventos de mantenimiento.

Ir más allá con IA

TagoIO tiene un servidor MCP que conecta asistentes de IA como Claude directamente con tus datos de IoT. Una vez que tus dispositivos Digi están enviando datos a TagoIO, puedes consultar esos datos en lenguaje natural: pide anomalías, genera scripts de análisis u obtén un resumen de lo que pasó en la planta la semana pasada. Detalles en docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration.

Resumen

Conectar los dispositivos de Digi International a TagoIO requiere tres cosas: un dispositivo en TagoIO con un token válido, una ruta de datos (webhook de DataStreams de DRM o MQTT directo) y un payload en el formato correcto. Todo lo que viene después, los dashboards, las alertas y el análisis, se construye dentro de TagoIO.

La integración funciona con cualquier dispositivo Digi que pueda llegar a internet. Empieza con un dispositivo, valida los datos en el Live Inspector y construye el dashboard desde ahí.

Documentación de Devices de TagoIO: docs.tago.io/docs/tagoio/devices
Integraciones de red: docs.tago.io/docs/tagoio/integrations
Plantillas de dashboard: docs.tago.io/docs/tagoio/dashboards
TagoTiP MQTT: docs.tago.io/docs/tagotip/transports/mqtt
TagoIO MCP: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration