How to

Como conectar dispositivos da Digi International ao TagoIO

Guia passo a passo para conectar gateways da Digi International e o Digi Remote Manager ao TagoIO. Inclui configuração de HTTPS, MQTT e DataStreams para aplicações em edifícios inteligentes, indústria, agricultura e equipamentos conectados.

Fabio Rosa ·
Como conectar dispositivos da Digi International ao TagoIO

A Digi International fabrica alguns dos gateways industriais e roteadores celulares mais confiáveis do mercado. Sua linha de dispositivos, do gateway IX15 LTE-M ao roteador serial IX30, conecta sensores e máquinas de campo à internet em ambientes onde confiabilidade não é opcional.

O TagoIO entrega a camada de aplicação: gestão de dispositivos, armazenamento de dados, dashboards em tempo real, alertas automatizados e uma API REST completa para construir em cima. As duas plataformas se complementam bem.

Mas levar dados de um dispositivo Digi para o TagoIO não é automático. Você precisa escolher o caminho de integração certo, formatar o payload corretamente e configurar os dois lados. Este guia cobre exatamente isso, com instruções passo a passo para cada abordagem e exemplos em quatro áreas de aplicação: edifícios inteligentes, monitoramento industrial, agricultura e equipamentos conectados.

O que você precisa antes de começar

  • Uma conta no TagoIO (plano gratuito disponível)
  • Um gateway Digi (IX15, IX20, IX30 ou similar) ou uma conta no Digi Remote Manager
  • Acesso de rede do dispositivo Digi à internet

Como a integração funciona

Existem dois caminhos principais para levar dados de dispositivos Digi ao TagoIO:

Caminho 1: DataStreams do Digi Remote Manager + webhook HTTPS Este é o caminho recomendado quando você já usa o DRM para gerenciar sua frota. O DRM coleta dados dos seus dispositivos Digi por meio de DataStreams e pode encaminhá-los para qualquer endpoint HTTPS, incluindo a API do TagoIO.

Caminho 2: MQTT direto do gateway Digi Se o seu gateway Digi roda um script Python ou tem um cliente MQTT embutido, você pode conectá-lo diretamente ao broker MQTT do TagoIO usando o TagoTiP. Isso dispensa o DRM por completo e oferece menor latência.

Os dois caminhos funcionam. Escolha o que se encaixa na sua configuração atual.

Caminho 1: DataStreams do Digi Remote Manager para o TagoIO

Passo 1: Crie um dispositivo no TagoIO

  1. Faça login em admin.tago.io.
  2. Clique em Devices na barra lateral esquerda.
  3. Clique em Add Device.
  4. Selecione HTTPS como tipo de conector.
  5. Dê um nome ao dispositivo (por exemplo, digi-ix15-building-a).
  6. Clique em Create Device.

Documentação completa de configuração de dispositivos: docs.tago.io/docs/tagoio/devices

Passo 2: Copie o token do dispositivo

Depois de criar o dispositivo, vá até a aba General e copie o Device Token. Você vai usá-lo para autenticar as requisições vindas do DRM.

Mais sobre tokens: docs.tago.io/docs/tagoio/devices/device-token

Passo 3: Configure uma assinatura de DataStream no Digi Remote Manager

No DRM, DataStreams são canais de dados nomeados nos quais o seu dispositivo Digi escreve (por exemplo, temperature, humidity, battery_level). Você pode assinar esses streams e enviar os dados para um endpoint HTTPS externo.

  1. Faça login na sua conta do DRM em devicecloud.digi.com.

  2. Navegue até Data Services > DataStreams.

  3. Localize os data streams vindos do seu dispositivo. Eles seguem o formato /dia/channel/<device-id>/<stream-name>.

  4. Vá até Monitor e crie uma nova Monitor subscription.

  5. Defina o tópico para os data streams que você quer encaminhar.

  6. Defina o método de entrega como HTTP POST.

  7. Defina a URL do endpoint como:

    https://api.tago.io/data

  8. Adicione o seguinte header HTTP:

    Device-Token: YOUR_DEVICE_TOKEN

O DRM passará a fazer POST dos dados para o TagoIO sempre que um novo valor chegar nos streams assinados.

Passo 4: Mapeie o payload do DRM para variáveis do TagoIO

O DRM envia dados no seu próprio formato XML ou JSON. O TagoIO espera o formato de dados padrão:

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

Se o DRM estiver enviando uma estrutura diferente, use um Payload Parser no TagoIO para transformar o payload de entrada antes que ele seja armazenado.

Para adicionar um parser:

  1. Abra o seu dispositivo no TagoIO.
  2. Vá até a aba Payload Parser.
  3. Escreva uma função JavaScript para extrair as variáveis do payload do DRM e retorná-las no formato do TagoIO.

Passo 5: Verifique os dados no Live Inspector

Abra a aba Live Inspector na página do seu dispositivo no TagoIO. Ela mostra cada requisição recebida em tempo real. Envie uma leitura de teste a partir do DRM e confirme que os dados aparecem ali antes de montar o seu dashboard.

Documentação do Live Inspector: docs.tago.io/docs/tagoio/devices/live-inspector

Caminho 2: MQTT direto do gateway Digi

Gateways Digi que rodam o firmware da Digi ou scripts Python podem se conectar diretamente ao TagoIO via MQTT usando o protocolo TagoTiP.

Passo 1: Crie um dispositivo TagoTiP no TagoIO

  1. No TagoIO, vá até Devices > Add Device.
  2. Busque por TagoTiP e selecione-o como conector.
  3. Dê um nome ao dispositivo e defina seu Serial Number (ele corresponde ao tópico MQTT).
  4. Salve o dispositivo e anote o Authorization Hash na aba General.

Passo 2: Conecte o cliente MQTT do gateway Digi

Configure o cliente MQTT no seu dispositivo Digi com estes parâmetros:

ParâmetroValor
Hostmqtt.tip.us-e1.tago.io (EUA) ou mqtt.tip.eu-w1.tago.io (UE)
Porta1883 (dev) ou 8883 com TLS (produção)
UsuárioPrimeiros 8 caracteres hexadecimais do seu Authorization Hash
SenhaÚltimos 8 caracteres hexadecimais do seu Authorization Hash
Tópico de publicação$tip/{serial}/push
Tópico de assinatura$tip/{serial}/ack

Passo 3: Publique os dados dos sensores

O formato de payload do TagoTiP é compacto e legível para humanos:

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

Para um Digi IX15 com um sensor de temperatura conectado, um script Python rodando no gateway ficaria assim:

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()

Documentação completa do TagoTiP: docs.tago.io/docs/tagotip/transports/mqtt

Passo 6: Monte o seu dashboard

Assim que os dados começarem a chegar no TagoIO, vá até Dashboards e clique em + para criar um novo.

O TagoIO oferece templates de dashboard prontos a partir dos quais você pode começar. Na caixa de diálogo de criação do dashboard, procure por Templates para encontrar layouts prontos para uso em aplicações comuns, incluindo monitoramento ambiental e rastreamento de ativos. Depois você adapta os widgets às variáveis de dados do seu Digi.

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

Para aplicações que gerenciam vários dispositivos Digi em diferentes locais, use um Blueprint Dashboard. Os blueprint dashboards usam tags para associar automaticamente um único layout de dashboard a vários dispositivos. Você cria o layout uma vez; cada dispositivo ganha sua própria visualização.

Passo 7: Configure alertas e ações automatizadas

Use as Actions do TagoIO para disparar notificações ou lógica quando os valores dos sensores cruzarem limites. Por exemplo, envie um e-mail ou SMS quando um sensor de temperatura em uma sala de servidores ultrapassar 30 C, ou dispare um script quando uma máquina ficar offline.

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

Exemplos de aplicação

Edifícios inteligentes

Gateways Digi IX15 ou IX20 se conectam a BACnet/IP, Modbus RTU ou entradas de sensores diretas dentro de um edifício. Variáveis comuns para enviar ao TagoIO:

  • Temperatura e umidade de HVAC por zona
  • Consumo de energia (kWh) por circuito
  • Contagem de sensores de ocupação
  • Detecção de vazamento de água (alerta binário)

No dashboard, use gráficos de série temporal para tendências de energia e widgets de card para as temperaturas atuais de cada zona. Configure alertas para avisar a equipe de manutenção predial quando uma zona sair da faixa de conforto.

Monitoramento industrial

Os roteadores Digi IX30 e IX40 têm portas seriais RS-232/RS-485 que se conectam a CLPs e equipamentos industriais legados. Envie ao TagoIO:

  • Contagem de ciclos de máquina e métricas de OEE
  • Corrente do motor e vibração
  • Velocidade e vazão de esteiras
  • Códigos de alarme dos registradores do CLP

Use scripts de Analysis do TagoIO para calcular o OEE a partir dos dados brutos de ciclo e gravar o resultado de volta em uma variável de dashboard. Os alertas podem disparar um sistema de ordens de serviço via API do TagoIO quando uma máquina entra em estado de falha.

Agricultura

O Digi IX15 com conectividade LTE-M funciona em áreas com cobertura celular limitada. Instale-o em uma estação de bombeamento ou estufa e envie:

  • Umidade do solo em várias profundidades
  • Temperatura do ar e umidade relativa
  • Vazão de irrigação e estado das válvulas
  • Nível de água do reservatório

Use o recurso Blueprint Dashboard para criar um único layout e aplicá-lo em todas as estações de campo. Cada estação ganha sua própria visualização de dashboard sem duplicar a configuração.

Equipamentos conectados (frota e ativos)

Os roteadores da série Digi WR e os módulos celulares XBee são comuns em equipamentos móveis. Envie ao TagoIO:

  • Localização por GPS
  • Horas de motor e consumo de combustível
  • Estado de sensores de portas e compartimentos
  • Tensão da bateria para equipamentos elétricos

O TagoIO armazena os dados de localização e pode exibi-los em um widget de mapa. Combine com dados de série temporal para correlacionar localização com consumo de combustível ou eventos de manutenção.

Indo além com IA

O TagoIO tem um servidor MCP que conecta assistentes de IA como o Claude diretamente aos seus dados de IoT. Assim que os seus dispositivos Digi estiverem enviando dados para o TagoIO, você pode consultar esses dados em linguagem natural: peça anomalias, gere scripts de análise ou obtenha um resumo do que aconteceu no chão de fábrica na semana passada. Detalhes em docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration.

Resumo

Conectar dispositivos da Digi International ao TagoIO exige três coisas: um dispositivo no TagoIO com um token válido, um caminho de dados (webhook de DataStreams do DRM ou MQTT direto) e um payload no formato certo. Tudo depois disso, dashboards, alertas e análises, é construído dentro do TagoIO.

A integração funciona com qualquer dispositivo Digi que consiga alcançar a internet. Comece com um dispositivo, valide os dados no Live Inspector e monte o dashboard a partir daí.

Posts Relacionados

Como conectar sensores LoRaWAN da Elsys ao TagoIO

Como conectar sensores LoRaWAN da Elsys ao TagoIO

Jun 3, 2026

Como conectar gateways LoRaWAN da Kerlink ao TagoIO

Como conectar gateways LoRaWAN da Kerlink ao TagoIO

Jun 2, 2026

Como conectar sensores Milesight à TagoIO

Como conectar sensores Milesight à TagoIO

Jun 2, 2026