# Conecte seus equipamentos. Transforme seus dados em serviços de manutenção.

> Você traz a automação e conhece o cliente. O Wertek AI traz a plataforma para monitorar ativos, registrar observações, gerenciar ordens de serviço e oferecer um serviço recorrente.

Para integradores · Wertek AI · https://wertek.ai/pt/integrators/

**Entrada:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **Saída para:** SCADA / HMI · Historiador

**Somente leitura: Wertek AI não escreve no seu PLC.**

## Seus protocolos entram. Seu SCADA lê a condição com uma chave de acesso somente leitura.

Clique em qualquer linha para ver o que é, como se conecta e seu estado.

**Wertek AI:** Ativo · Condição · Alerta · Ordem de serviço · Relatório

### Entrada

#### OT · Chão de fábrica

- **[Gateway Wertek AI](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP, com mapas de registradores para 32 dispositivos de 17 marcas (Eastron, Schneider, Siemens, Circutor, ABB, Janitza, Carlo Gavazzi…) e bancos de capacitores. Os equipamentos já reportam assim.
- **Dispositivos que publicam por MQTT** *(Com provisionamento)* — Banner DXM (vibração sem fio, com modem 4G), kits Acrel e medidores de energia. Os equipamentos já reportam assim.
- **Seu próprio fluxo por HTTP com uma chave** *(Via Node-RED / Ignition / gateway)* — Node-RED, Ignition, n8n, Python ou JavaScript/TypeScript; receitas para Modbus TCP, MQTT e OPC UA, validadas com valores simulados.
- **OPC UA do Bently Nevada System 1** *(Beta)* — Conector de leitura.
- **[Em campo, com o celular](https://wertek.ai/pt/mobile/)** — Observações com fotos, vídeo com VibeDiag, análise acústica e leituras manuais (horas, ciclos, kWh…).

> S7, EtherNet/IP e OPC UA genérico: sem driver próprio; você os acessa por Node-RED, Ignition ou um gateway.

#### IT · Sistemas empresariais

- **Manutenção e ERP** — Trazem suas ordens de serviço: SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **Arquivos** — Ativos de CSV ou Excel, revisados antes de serem aplicados; sinais WAV, UFF58 e CSV.

### Saída

#### OT · Chão de fábrica

- **Historiadores da planta** — Wertek AI grava suas medições e a saúde dos ativos no historiador, junto aos seus dados de processo: AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **SCADA, HMI ou Node-RED com uma chave de leitura** — Ignition, Node-RED ou um script lê ativos, medições com seu resultado e recomendação, e energia, para mostrar a condição junto às tags de processo. A chave de leitura é criada a partir do plano Monitoring.

> Wertek AI não escreve no seu PLC: publica fatos e estados, e você decide qual tag alterar.

#### IT · Sistemas empresariais

- **API com uma chave** — Ativos, medições, sinal e FFT, e energia; exportação em JSON. A chave de leitura é criada a partir do plano Monitoring.
- **Downloads** — CSV, XLSX, Parquet, WAV e PDF: medições, observações, ordens de serviço, consumo e relatório de conformidade com o código de rede elétrica.
- **Alertas** — Push e email, e ao vivo no aplicativo.
- **Relatórios periódicos por email** — Energia e conformidade com o código de rede elétrica, condição e resumo mensal dos centros de consumo.
- **[Manutenção e ERP](https://wertek.ai/pt/integrations/)** — Conectores, cada um com seu estado auditado: MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## HTTP com uma chave: o caminho para qualquer dispositivo

1. **Crie sua conta gratuita.** Em app.wertek.ai. Uma chave apenas com a permissão de ingestão funciona em qualquer plano. [Criar conta](https://app.wertek.ai/signup)
2. **Crie o ativo e designe o ponto de medição.** No aplicativo, cadastre o ativo e designe a posição que você alimentará: seu código, suas variáveis com a unidade UCUM e sua cadência. Você também pode designá-la com a chave: POST /iaes/assets/{asset_id}/measurement-points. Designar consome um ponto de medição: faça isso uma vez por posição, não a cada envio.
3. **Crie a chave de ingestão.** Em Configurações → Chaves de API (Settings → API Keys), com a permissão de ingestão. Mantenha-a em segredo: em uma variável de ambiente, nunca no código ou em uma tag.
4. **Envie a leitura.** Um evento asset.measurement por leitura, sozinho ou em uma lista de até 100, para POST https://api.wertek.ai/iaes/ingest. A resposta contém um código por evento; o que é armazenado aparece no histórico do ativo, na posição designada.

### Como designar um ponto de medição

1. **Em Measurement points (ou no ativo), clique em «Designate position».** Designar usa um ponto de medição do conjunto da sua organização: faça isso uma vez por posição, não a cada envio.
2. **Preencha o código, o modelo e a cadência.** O código é o `location` que sua integração enviará (em minúsculas, sem espaços). O modelo traz as variáveis da família com sua unidade UCUM; você pode adicionar variáveis personalizadas. A cadência contratada, em segundos, indica a frequência de envio de uma leitura.

   ![Janela «Designate a measurement position»: código, modelo, variáveis e cadência](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **A posição aparece na lista e começa a receber leituras.** Cada evento enviado com esse código e a chave de ingestão é armazenado no histórico do ativo, nessa posição.

### O evento (reading.json)

```json
{
  "spec_version": "2.0",
  "event_id": "6f1c2b7e-3d4a-4e8b-9a10-5c2d7e9f1a34",
  "correlation_id": "0b8e4c21-7f3a-4d6e-8c95-1a2b3c4d5e6f",
  "event_type": "asset.measurement",
  "timestamp": "2026-11-11T14:32:00Z",
  "source": "plant_x.plc_12",
  "dataschema": "https://iaes.dev/schema/v2/asset.measurement",
  "asset": {
    "asset_id": "PUMP-07"
  },
  "data": {
    "measurement_type": "temperature",
    "value": 23.5,
    "unit": "Cel",
    "location": "zona_1"
  }
}
```

Validado com o SDK IAES 2.0.2 publicado, a versão usada pela ingestão.

- `data.location` — o código da posição designada
- `data.measurement_type` — a chave da variável
- `data.unit` — a unidade do contrato (comparada, nunca convertida)
- `data.value` — um número; booleanos são enviados como 0 ou 1
- `timestamp` — o horário da medição, em UTC — não o horário de envio
- `event_id` — novo a cada leitura; é a chave de idempotência

### curl

```bash
curl -X POST https://api.wertek.ai/iaes/ingest \
  -H "X-API-Key: $WERTEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d @reading.json
```

### Python

```python
# pip install requests          (the validator: pip install "iaes[validate]==2.0.2")
import json, os, uuid
from datetime import datetime, timezone
import requests

event = json.load(open("reading.json"))
event["event_id"] = str(uuid.uuid4())         # new for each reading
event["correlation_id"] = str(uuid.uuid4())   # one per batch
event["timestamp"] = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")  # when it was measured

r = requests.post(
    "https://api.wertek.ai/iaes/ingest",
    json=[event],
    headers={"X-API-Key": os.environ["WERTEK_API_KEY"]},
    timeout=30,
)
print(r.status_code, r.json())
```

### Node-RED

```bash
cd ~/.node-red
npm install node-red-contrib-iaes@2.0.2
```

Importe o fluxo da receita (pump-process-to-wertek.flow.json); o nó iaes-publish usa a mesma chave.

### Receitas

- **Node-RED.** Receita validada em software: seu script de aceitação é executado contra a API com valores simulados. Nós IAES 2.0.2 importados e executados em um Node-RED 5.0.6 real (Docker, 2026-11-12): 5/5 eventos válidos. [Receita, fluxo e script de aceitação](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** Receita verificada contra a API em 2026-10-05, sem script automático de aceitação. Nós IAES 2.0.2 importados e executados em um n8n 2.8.4 real (2026-11-12): 5/5 eventos válidos. [Receita e fluxo de trabalho](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **Qualquer cliente HTTP.** A receita básica: leia o contrato do ativo, designe a posição, envie e leia a resposta evento por evento. [Receita e script de aceitação](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### E MQTT?

Hoje MQTT significa canais para equipamentos específicos — Banner DXM, kits Acrel e medidores de energia — cada um com seu próprio tópico e credencial, configurados com provisionamento. Não há tópico universal: para qualquer outro dispositivo, o caminho é HTTP com uma chave.

## O que protege seus dados na entrada e o que você controla

O que o código faz hoje, e nada além disso.

- **Chaves de ingestão.** Uma chave começa com wk_ e é exibida uma vez, quando você a cria. Wertek AI armazena apenas seu hash SHA-256 e um prefixo de 12 caracteres para reconhecê-la.
- **Permissões, expiração e revogação.** Cada chave tem suas permissões (telemetry.view, telemetry.export, iaes.ingest), pode ser limitada a ativos específicos, pode expirar em 1 a 365 dias e pode ser revogada. Apenas um proprietário ou administrador gerencia chaves.
- **Vinculada à sua organização.** Um evento é aceito apenas para ativos da organização da chave: uma chave não pode gravar em ativos de outra organização.
- **Em trânsito.** A API é disponibilizada por HTTPS. Para MQTT, use a porta 8883 com TLS.
- **Arquivos por links assinados.** Capturas e documentos são entregues por links assinados com HMAC-SHA256 que expiram.
- **Dados armazenados.** Nossos provedores (Supabase para o banco de dados e Cloudflare R2 para arquivos) criptografam os dados que armazenam.
- **Limites e uso.** Até 300 requisições por minuto por credencial de máquina (429 acima disso) e 100 eventos por lote. A API de telemetria registra o uso de cada chave e seu último uso.

### Recomendado para integradores

- MQTT: porta 8883 com TLS.
- Não recomendamos enviar dados sem criptografia. Se um dispositivo não suporta TLS, fale conosco: ele pode ser avaliado com outras proteções.
- Uma chave por planta, com a permissão mínima (iaes.ingest para enviar dados) e uma expiração.
- Mantenha a chave em uma variável de ambiente ou em um repositório de segredos, nunca no código ou no fluxo.
- Revogue a chave quando um dispositivo ou uma planta sair.

## Pacotes publicados, com seu código aberto

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. Sete nós: measurement, health, work-order, validate, sparkplug, publish e route. Versão publicada: 2.0.2 · [Código-fonte](https://github.com/wertek-ai/iaes/tree/nodered-v2.0.2/node-red) · [npm](https://www.npmjs.com/package/node-red-contrib-iaes)
- **n8n** — `npm install n8n-nodes-iaes@2.0.2`. Nó da comunidade para n8n. Versão publicada: 2.0.2 · [Código-fonte](https://github.com/wertek-ai/iaes/tree/n8n-v2.0.2/n8n-nodes) · [npm](https://www.npmjs.com/package/n8n-nodes-iaes)
- **JavaScript / TypeScript** — `npm install @iaes/sdk@2.0.2`. Cliente, modelos e validação do evento (a validação usa ajv). Versão publicada: 2.0.2 · [Código-fonte](https://github.com/wertek-ai/iaes/tree/sdk-v2.0.2/npm) · [npm](https://www.npmjs.com/package/@iaes/sdk)
- **Python** — `pip install "iaes[validate]==2.0.2"`. Modelos e validação: o mesmo validador usado pela ingestão do Wertek AI. Versão publicada: 2.0.2 · [Código-fonte](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**Prévia.** Arduino Opta: iaes-opta-runtime emite IAES 1.4, e a ingestão do Wertek AI exige 2.x. É uma prévia, não para produção. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES: crie o fluxo uma vez.** Um formato aberto de eventos, reutilizado com cada cliente, e o que seu cliente recebe na Wertek AI. [Ver IAES para integradores](https://wertek.ai/pt/integrators/iaes/index.md)

O padrão: IAES 2.0, aberto (CC BY 4.0). [iaes.dev](https://iaes.dev/) · [DOI 10.5281/zenodo.22663498](https://doi.org/10.5281/zenodo.22663498)

## Mais que um lugar para armazenar dados

- **O ativo e seu histórico.** Cada leitura fica no histórico do ativo, na posição que você designou.
- **Observações.** A equipe do cliente registra o que encontra em campo, com fotos, pela web ou pelo celular.
- **Ordens de serviço.** Para agir sobre o que foi encontrado e manter o registro de cada intervenção. A partir do Technical.
- **O aplicativo móvel.** Para trabalho em campo, no Android e no iPhone.

## Receber os dados é gratuito; monitorá-los não.

Você paga pelo ponto de medição monitorado, não pelo ativo.

- 1 ponto de medição: USD 36 por ano
- Pacote de 5 pontos de medição: USD 120 por ano

Preços do catálogo atual do Wertek AI, consultados na publicação desta página. [Ver todos os planos](https://wertek.ai/pricing.html)

## Seu cliente governa o ativo; você vê o que ele autoriza

- O ativo e seu histórico pertencem a quem o governa: seu cliente. O que você registra mantém sua autoria.
- Você vê o que seu cliente autoriza: por planta, área ou ativo, com janelas de tempo.
- Por padrão, seu cliente paga pelos pontos de medição.
- Se vocês encerrarem a parceria, o ativo e seu histórico técnico ficam com seu cliente; seu acesso termina quando é revogado.

[Sobre o Growth Program](https://wertek.ai/growth-program.html)

## O que a ingestão aceita

| | |
|---|---|
| Rota | POST https://api.wertek.ai/iaes/ingest |
| Cabeçalho | X-API-Key, com a permissão iaes.ingest |
| Evento | IAES, spec_version 2.x |
| Lote | até 100 eventos por requisição |
| Limite | 300 requisições por minuto por chave |
| Cadência | uma leitura que chega antes de 90 % da cadência contratada é descartada (código 504) |
| Contrato do ativo | GET /iaes/assets/{asset_id}/measurement-points, com a chave |
| Esquema e códigos | GET /iaes/schema e /iaes/schema/codes, com a chave |
| Resposta | um código por evento: 1xx armazenado · 2xx armazenado com aviso · 4xx corrija a mensagem · 5xx tente novamente |

## Perguntas frequentes

**Preciso de um plano?** Você não precisa de um plano para enviar dados; cada ponto de medição monitorado é pago conforme o catálogo. O plano ativa alertas que chegam a alguém, ordens de serviço e mais histórico.

**Onde funciona?** A ingestão é um serviço em nuvem do Wertek AI. O gateway do Wertek AI roda na sua rede: lê os equipamentos e envia as leituras.

**A ingestão escreve no meu PLC?** Não. A ingestão apenas recebe dados.

**E se eu enviar mais rápido que a cadência?** Uma leitura que chega antes de 90 % da cadência contratada é descartada com o código 504. Ajuste os envios à cadência do ponto de medição.

