# 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.

![Como conectar dispositivos da Digi International ao TagoIO](https://tago.io/og/pt-br/blog/how-to-connect-digi-international-devices-to-tagoio.png)

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](https://tago.io/pricing))
- 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](https://docs.tago.io/docs/tagotip/transports/mqtt). 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](https://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](https://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](https://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](https://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](https://docs.tago.io/docs/tagoio/devices/sending-data):

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

Se o DRM estiver enviando uma estrutura diferente, use um [Payload Parser](https://docs.tago.io/docs/tagoio/devices/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](https://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](https://docs.tago.io/docs/tagotip/transports/mqtt).

### 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âmetro | Valor |
|---|---|
| Host | `mqtt.tip.us-e1.tago.io` (EUA) ou `mqtt.tip.eu-w1.tago.io` (UE) |
| Porta | `1883` (dev) ou `8883` com TLS (produção) |
| Usuário | Primeiros 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:

```python
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](https://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](https://docs.tago.io/docs/tagoio/dashboards/)

Para aplicações que gerenciam vários dispositivos Digi em diferentes locais, use um [Blueprint Dashboard](https://docs.tago.io/docs/tagoio/dashboards/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](https://docs.tago.io/docs/tagoio/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](https://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](https://docs.tago.io/docs/tagoio/dashboards/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/tago-ai/tagoio-mcp-ai-powered-iot-data-integration](https://docs.tago.io/docs/tagoio/tago-ai/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í.

- Documentação de Devices do TagoIO: [docs.tago.io/docs/tagoio/devices](https://docs.tago.io/docs/tagoio/devices/)
- Integrações de Rede: [docs.tago.io/docs/tagoio/integrations](https://docs.tago.io/docs/tagoio/integrations/)
- Templates de Dashboard: [docs.tago.io/docs/tagoio/dashboards](https://docs.tago.io/docs/tagoio/dashboards/)
- TagoTiP MQTT: [docs.tago.io/docs/tagotip/transports/mqtt](https://docs.tago.io/docs/tagotip/transports/mqtt)
- TagoIO MCP: [docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration](https://docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration)

[llms.txt](https://tago.io/llms.txt)