Cómo automatizar flujos de trabajo IoT con n8n y TagoIO

TagoIO gestiona los datos IoT muy bien: ingesta, almacenamiento, dashboards y alertas. Pero hay flujos de trabajo que van más allá de las Actions nativas de TagoIO: actualizar un CRM cuando el sensor de un envío supera los límites de temperatura, crear un ticket de Jira cuando una máquina se desconecta, sincronizar las lecturas diarias de energía con una hoja de cálculo o enviar un mensaje de WhatsApp cuando se dispara una alarma de CO2.

n8n es una plataforma de automatización de flujos de trabajo de código abierto. Conecta cientos de aplicaciones y servicios mediante un editor visual basado en nodos. Puedes ejecutarlo de forma autoalojada o usar n8n Cloud.

Combinar TagoIO y n8n te da dos capas de automatización complementarias: TagoIO para el enrutamiento de datos IoT y la lógica de dispositivos, y n8n para la automatización de procesos de negocio entre aplicaciones, activada por esos datos.

Lo que necesitas antes de empezar

Una cuenta de TagoIO (plan gratuito disponible)
Una instancia de n8n (autoalojada o n8n Cloud)
Un Profile Token de TagoIO con acceso a la API (genéralo en TagoIO en Account → Profile Tokens)

Visión general de la arquitectura

[sensores IoT] → [TagoIO: ingesta, almacenamiento, alertas]
                       ↓ (trigger por webhook o sondeo por API)
                    [flujo de n8n] → [Slack, Jira, Google Sheets, CRM, etc.]

n8n puede tanto leer de TagoIO (para obtener datos de dispositivos y procesarlos) como escribir en TagoIO (para enviar valores calculados de vuelta a los buckets de los dispositivos).

Patrón 1: Action de TagoIO → trigger de webhook en n8n

La integración más sencilla: cuando se dispara una Action de TagoIO (umbral superado, dispositivo desconectado, datos nuevos), llama a un webhook de n8n para iniciar un flujo de trabajo.

Paso 1: Crea un nodo de webhook en n8n

En n8n, crea un nuevo flujo de trabajo.
Añade un nodo Webhook como trigger.
Configura el método como POST y anota la Production URL (por ejemplo, https://your-n8n.instance/webhook/tagoio-alert).
Activa el nodo.

Paso 2: Configura una Action de TagoIO para llamar al webhook

En TagoIO, ve a Actions → Add Action.
Elige tu trigger (por ejemplo, Variable value condition: temperature > 35).
Establece el tipo de acción como HTTP Request.
Configura la URL con la de tu webhook de n8n.
Establece el método como POST y añade un cuerpo JSON con el contexto relevante:

{
  "device_id": "$DEVICE_ID$",
  "variable": "$VARIABLE$",
  "value": "$VALUE$",
  "timestamp": "$TIMESTAMP$"
}

Guarda la Action.

Ahora, cada vez que se cumpla la condición en TagoIO, n8n recibirá el evento y tu flujo de trabajo se ejecutará.

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

Patrón 2: n8n sondea la API de TagoIO para obtener datos de dispositivos

Para el procesamiento por lotes o la generación de informes, usa n8n para programar una llamada periódica a la API de TagoIO y procesar los resultados.

Obtén los últimos datos de un dispositivo de TagoIO

En n8n, añade un nodo HTTP Request:

Method: GET
URL: https://api.tago.io/data?variable=temperature&qty=100
Headers:
- Authorization: YOUR_PROFILE_TOKEN
- Content-Type: application/json

Documentación de la API de TagoIO: docs.tago.io/docs/tagoio/api

La respuesta es un arreglo JSON de puntos de datos. Pasa el resultado a los nodos posteriores de n8n: filtra, transforma, escribe en Google Sheets, crea un ticket de Jira o publica en Slack.

Ejemplo: Informe diario de energía en Google Sheets

Schedule Trigger (se ejecuta todos los días a las 6 AM)
HTTP Request → API de TagoIO, obtiene las últimas 24 horas de lecturas de energía
Code node → agrega los totales de kWh por dispositivo
Google Sheets → añade una fila con la fecha, el dispositivo y el consumo total

Esto reemplaza una tarea manual de informes con un resumen diario totalmente automatizado.

Patrón 3: Escribe datos calculados de vuelta en TagoIO desde n8n

Los flujos de trabajo de n8n pueden procesar datos de fuentes externas y enviar los resultados de vuelta a los buckets de dispositivos de TagoIO, enriqueciendo tus datos IoT con contexto de negocio.

Envía datos a un dispositivo de TagoIO con POST

Usa un nodo HTTP Request en n8n:

Method: POST
URL: https://api.tago.io/data
Headers: Device-Token: YOUR_DEVICE_TOKEN
Body (JSON):

[
  {"variable": "work_order_open", "value": 1},
  {"variable": "maintenance_due", "value": "2026-06-15"}
]

Este patrón es útil cuando quieres que los dashboards de TagoIO reflejen datos de tu ERP, CMMS o sistema de tickets junto con las lecturas de sensores en vivo.

Documentación sobre envío de datos: docs.tago.io/docs/tagoio/devices/sending-data

Patrón 4: Sincronización bidireccional: Analysis de TagoIO + n8n

Para escenarios avanzados, puedes activar flujos de trabajo de n8n desde scripts de Analysis de TagoIO (JavaScript serverless que se ejecuta en la nube):

// TagoIO Analysis script
const axios = require("axios");
const N8N_WEBHOOK_URL = "https://your-n8n.instance/webhook/analysis-trigger";
await axios.post(N8N_WEBHOOK_URL, {
  event: "anomaly_detected",
  device: "sensor-plant-floor-A",
  details: "Vibration exceeded 4g threshold for 3 consecutive readings"
});

Documentación de Analysis: docs.tago.io/docs/tagoio/analysis

Esto permite que la lógica compleja de TagoIO (detección de anomalías, correlaciones entre múltiples variables, agregaciones de toda la flota) active flujos de trabajo entre aplicaciones en n8n.

Ejemplos de flujos de trabajo del mundo real

Creación de tickets de mantenimiento

Trigger: una Action de TagoIO se dispara cuando el sensor de vibración supera el umbral. Flujo de n8n: crea una incidencia en Jira con el ID del dispositivo, la marca de tiempo, el valor del sensor y un enlace al dashboard de TagoIO. Resultado: el equipo de mantenimiento recibe un ticket estructurado de forma automática, sin registro manual.

Notificación de superación de temperatura en un envío

Trigger: una Action de TagoIO se dispara cuando la temperatura supera los 8°C en un dispositivo de cadena de frío. Flujo de n8n: busca el registro del envío en el CRM por el ID del dispositivo → publica un mensaje de Slack en el canal de logística → envía un correo al cliente. Resultado: trazabilidad completa y comunicación con el cliente a partir de un solo evento IoT.

Correo semanal con el dashboard ejecutivo

Trigger: Schedule de n8n (todos los lunes a las 8 AM). Flujo de n8n: sondea la API de TagoIO para obtener los últimos 7 días de datos de producción → calcula las tendencias semana a semana → genera un correo HTML con formato → lo envía vía Gmail o SendGrid. Resultado: el equipo ejecutivo recibe un resumen IoT semanal sin tener que iniciar sesión en TagoIO.

Ir más allá con la IA

Combina n8n, TagoIO y Claude a través del servidor MCP de TagoIO. Tus datos de TagoIO se pueden consultar en lenguaje natural, y n8n puede orquestar flujos de trabajo de varios pasos que mezclan respuestas de la IA con acciones IoT.

Documentación de MCP: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration

Resumen

n8n y TagoIO son capas complementarias. TagoIO gestiona los datos IoT, los dispositivos y las alertas de primer nivel. n8n se encarga de los flujos de trabajo de negocio entre aplicaciones que esos eventos necesitan activar. Conéctalos con webhooks (TagoIO → n8n) o con sondeos programados de la API (n8n → TagoIO), y extiende tus datos IoT a todos los sistemas de negocio que tu equipo ya usa.

Actions de TagoIO: docs.tago.io/docs/tagoio/actions
Envío de datos: docs.tago.io/docs/tagoio/devices/sending-data
Scripts de Analysis: docs.tago.io/docs/tagoio/analysis
Referencia de la API de TagoIO: docs.tago.io/docs/tagoio/api
MCP: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration