Como automatizar fluxos de trabalho IoT com n8n e TagoIO

O TagoIO lida muito bem com dados de IoT: ingestão, armazenamento, dashboards e alertas. Mas existem fluxos de trabalho que vão além das Actions nativas do TagoIO: atualizar um CRM quando um sensor de carga ultrapassa os limites de temperatura, criar um ticket no Jira quando uma máquina fica offline, sincronizar leituras diárias de energia com uma planilha ou enviar uma mensagem de WhatsApp quando um alarme de CO2 dispara.

O n8n é uma plataforma open-source de automação de fluxos de trabalho. Ela conecta centenas de apps e serviços por meio de um editor visual baseado em nós. Você pode rodá-la em modo self-hosted ou usar o n8n Cloud.

Combinar TagoIO e n8n oferece duas camadas de automação complementares: o TagoIO para o roteamento de dados de IoT e a lógica de dispositivos, e o n8n para a automação de processos de negócio entre apps disparada por esses dados.

O que você precisa antes de começar

Uma conta TagoIO (plano gratuito disponível)
Uma instância do n8n (self-hosted ou n8n Cloud)
Um Profile Token do TagoIO com acesso à API (gere-o no TagoIO em Account → Profile Tokens)

Visão geral da arquitetura

[sensores IoT] → [TagoIO: ingestão, armazenamento, alertas]
                       ↓ (gatilho via webhook ou poll de API)
                    [fluxo do n8n] → [Slack, Jira, Google Sheets, CRM, etc.]

O n8n pode tanto ler do TagoIO (para buscar dados de dispositivos para processamento) quanto gravar no TagoIO (para enviar valores calculados de volta para os buckets dos dispositivos).

Padrão 1: Action do TagoIO → gatilho de webhook no n8n

A integração mais simples: quando uma Action do TagoIO dispara (violação de limite, dispositivo offline, novos dados), ela chama um webhook do n8n para iniciar um fluxo de trabalho.

Passo 1: Crie um nó de webhook no n8n

No n8n, crie um novo fluxo de trabalho.
Adicione um nó Webhook como gatilho.
Defina o Method como POST e anote a Production URL (por exemplo, https://your-n8n.instance/webhook/tagoio-alert).
Ative o nó.

Passo 2: Configure uma Action do TagoIO para chamar o webhook

No TagoIO, vá em Actions → Add Action.
Escolha o seu gatilho (por exemplo, Variable value condition: temperature > 35).
Defina o tipo de ação como HTTP Request.
Defina a URL como a URL do seu webhook do n8n.
Defina o método como POST e adicione um corpo JSON com o contexto relevante:

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

Salve a Action.

Agora, toda vez que a condição for atendida no TagoIO, o n8n recebe o evento e o seu fluxo de trabalho é executado.

Documentação de Actions: docs.tago.io/docs/tagoio/actions

Padrão 2: o n8n faz poll da API do TagoIO para obter dados de dispositivos

Para processamento em lote ou geração de relatórios, use o n8n para agendar uma chamada periódica à API do TagoIO e processar os resultados.

Busque os dados mais recentes de um dispositivo TagoIO

No n8n, adicione um nó HTTP Request:

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

Documentação da API do TagoIO: docs.tago.io/docs/tagoio/api

A resposta é um array JSON de pontos de dados. Encaminhe o resultado para os nós seguintes do n8n: filtre, transforme, grave no Google Sheets, crie um ticket no Jira ou publique no Slack.

Exemplo: relatório diário de energia para o Google Sheets

Schedule Trigger (executa todos os dias às 6h)
HTTP Request → API do TagoIO, busca as últimas 24 horas de leituras de energia
Code node → agrega os totais de kWh por dispositivo
Google Sheets → acrescenta uma linha com data, dispositivo e consumo total

Isso substitui uma tarefa manual de geração de relatórios por um resumo diário totalmente automatizado.

Padrão 3: grave dados calculados de volta no TagoIO a partir do n8n

Os fluxos de trabalho do n8n podem processar dados de fontes externas e enviar os resultados de volta para os buckets dos dispositivos no TagoIO, enriquecendo os seus dados de IoT com contexto de negócio.

Envie dados (POST) para um dispositivo TagoIO

Use um nó HTTP Request no 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"}
]

Esse padrão é útil quando você quer que os dashboards do TagoIO reflitam dados do seu ERP, CMMS ou sistema de tickets junto com as leituras ao vivo dos sensores.

Documentação de envio de dados: docs.tago.io/docs/tagoio/devices/sending-data

Padrão 4: sincronização bidirecional: TagoIO Analysis + n8n

Para cenários avançados, você pode disparar fluxos de trabalho do n8n a partir de scripts do TagoIO Analysis (JavaScript serverless que roda na nuvem):

// 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"
});

Documentação de Analysis: docs.tago.io/docs/tagoio/analysis

Isso permite que a lógica complexa do TagoIO (detecção de anomalias, correlações entre múltiplas variáveis, agregações em toda a frota) dispare fluxos de trabalho entre apps no n8n.

Exemplos reais de fluxos de trabalho

Criação de ticket de manutenção

Gatilho: a Action do TagoIO dispara quando o sensor de vibração ultrapassa o limite. Fluxo do n8n: cria um issue no Jira com o ID do dispositivo, timestamp, valor do sensor e link para o dashboard do TagoIO. Resultado: a equipe de manutenção recebe um ticket estruturado automaticamente, sem registro manual.

Notificação de violação de temperatura em uma carga

Gatilho: a Action do TagoIO dispara quando a temperatura ultrapassa 8°C em um dispositivo de cadeia fria. Fluxo do n8n: busca o registro da carga no CRM pelo ID do dispositivo → Publica uma mensagem no Slack no canal de logística → Envia um e-mail para o cliente. Resultado: rastreabilidade completa e comunicação com o cliente a partir de um único evento de IoT.

E-mail semanal de dashboard executivo

Gatilho: agendamento do n8n (toda segunda-feira às 8h). Fluxo do n8n: faz poll da API do TagoIO para os últimos 7 dias de dados de produção → Calcula as tendências semana a semana → Gera um e-mail HTML formatado → Envia via Gmail ou SendGrid. Resultado: a equipe executiva recebe um resumo semanal de IoT sem precisar entrar no TagoIO.

Indo além com IA

Combine n8n, TagoIO e Claude por meio do servidor MCP do TagoIO. Os seus dados do TagoIO ficam consultáveis em linguagem natural, e o n8n pode orquestrar fluxos de trabalho de múltiplas etapas que mesclam respostas de IA com ações de IoT.

Documentação de MCP: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration

Resumo

O n8n e o TagoIO são camadas complementares. O TagoIO gerencia os dados de IoT, os dispositivos e os alertas de primeiro nível. O n8n cuida dos fluxos de trabalho de negócio entre apps que esses eventos precisam disparar. Conecte-os com webhooks (TagoIO → n8n) ou poll agendado da API (n8n → TagoIO) e estenda os seus dados de IoT para cada sistema de negócio que a sua equipe já usa.

Actions do TagoIO: docs.tago.io/docs/tagoio/actions
Envio de dados: docs.tago.io/docs/tagoio/devices/sending-data
Scripts de Analysis: docs.tago.io/docs/tagoio/analysis
Referência da API do TagoIO: docs.tago.io/docs/tagoio/api
MCP: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration