Antes de começar

Plano: a telemetria IoT está incluída a partir do plano Quinta (e em todos os planos superiores). Se o seu plano não a inclui, ao abrir IoT & Automação o Cepaos mostra qual plano a inclui e o preço no seu mercado.
Permissões: conectar equipamentos e gateways exige a função Proprietário ou Admin.
O que você vai conectar: se o seu equipamento (ou a nuvem do fabricante) consegue enviar dados pela internet sozinho, siga o caminho A. Se for um CLP ou uma máquina industrial sem conexão própria, siga o caminho B. Em dúvida entre equipamento e sensor? Leia o artigo «Equipamento ou sensor?» desta central de ajuda.

Caminho A — o equipamento já envia dados pela internet

Abra IoT & Automação → Equipamentos → Equipamentos conectados e clique em + Conectar equipamento.
Escolha o tipo de equipamento (prensa, bomba, envasadora, estação meteorológica…) e, se aparecer, o perfil do seu modelo.
Informe um nome que sua equipe reconheça. Fabricante, localização e ID da máquina são opcionais; com o fabricante, o Cepaos sugere passos de instalação.
Ao criar o equipamento, o Cepaos mostra a chave de API uma única vez. Em «Para seu técnico» você encontra o endereço para onde o equipamento deve enviar os dados, uma mensagem de exemplo para esse tipo de equipamento, um teste rápido com curl, um arquivo de configuração para baixar e um QR code. Guarde a chave em lugar seguro: se você a perder, ela não pode ser exibida de novo; só é possível rotacioná-la (uma nova é gerada e a anterior deixa de funcionar).
Seu técnico configura o equipamento para enviar cada leitura como POST para esse endereço, com o cabeçalho Authorization: Bearer seguido da chave e um JSON com pelo menos eventType (e, quando fizer sentido, value e unit).
Abra a ficha do equipamento. Enquanto nada chegar, você verá uma sala de espera que se atualiza sozinha a cada 10 segundos; quando o primeiro dado chega, ele aparece com horário e conteúdo para você confirmar que o formato está correto.

Caminho B — equipamentos sem conexão própria: Cepaos Gateway

O gateway é um Raspberry Pi ou mini-PC que fica na adega e traduz os protocolos industriais em dados que o Cepaos entende.

Prepare o aparelho: Raspberry Pi 3 ou mais recente (recomendado Pi 4 com 2 GB ou mais) ou um mini-PC, com Raspberry Pi OS Lite 64 bits ou Ubuntu Server 22.04 ou superior, ligado por cabo à rede da adega e com acesso à internet.
Abra IoT & Automação → Equipamentos → Gateway e clique em Conectar gateway. Informe um nome e, se quiser, a localização.
O Cepaos gera um comando de instalação com um token exibido uma única vez, válido por 24 horas e consumido na primeira conexão. Cole-o no terminal do Pi (por SSH ou com teclado e monitor). O script instala o agente como serviço e o inicia; leva cerca de 2 minutos.
Na página do gateway, o status muda para «Online» quando o agente se conecta. Se nada aparecer em 5 minutos, confira os logs no Pi com journalctl -u cepaos-gateway -f.
O gateway varre a rede e lista o que encontra em «Dispositivos descobertos» (nova varredura a cada 5 minutos). Clique em Adotar, dê um nome e o dispositivo vira um equipamento conectado.

Protocolos: Modbus TCP e MQTT já foram validados com hardware real. Modbus RTU, OPC-UA e Siemens S7 estão implementados, mas ainda não foram validados com hardware real: fale com a gente antes de depender deles em produção.

Quando os dados começam a chegar

Painel geral (IoT & Automação → Equipamentos → Painel geral): o status de todos os seus equipamentos de relance.
Ficha do equipamento: leituras, histórico e visão ao vivo.
Alertas: o sino no canto superior direito das páginas de IoT abre a central de alertas (comandos que falharam, erros informados pelo equipamento, análises de laboratório fora da faixa, envases não conciliados). Você pode marcá-los como lidos ou resolvê-los.
E-mail: ative «Alertas IoT críticos por e-mail» nas suas preferências de notificação (Configurações). Só são enviados e-mails para alertas críticos novos; os repetidos são agrupados.

Opcional: controle remoto (Adega Conectada)

Para receber dados não é preciso mais nada. Para enviar comandos a uma máquina (pausar, retomar, iniciar um ciclo, conforme o que ela suportar) é necessário o complemento Adega Conectada, que aparece em Configurações → Módulos com o preço e o botão para contratar (em alguns planos ele vem incluído por contrato com nossa equipe comercial).

Na primeira vez que você enviar um comando de risco médio ou alto a uma máquina, o Cepaos pede que você aceite o acordo de uso para essa máquina.
Comandos de risco alto só são executados depois que um segundo administrador os aprova (ou, se a máquina tiver sua ficha com QR, depois de confirmar a presença física escaneando-o). Os pendentes ficam em IoT & Automação → Equipamentos → Controle remoto.

Se algo não funcionar

O equipamento aparece sem sinal: verifique energia e rede. Se ele estiver atrás de um gateway, verifique primeiro o gateway.
O equipamento recebe erro 401: a chave está errada, foi rotacionada ou o equipamento foi arquivado.
Erro 422 ou 400: o JSON não está no formato esperado (falta eventType ou não é um JSON válido). Compare com a mensagem de exemplo em «Para seu técnico».
Erro 413: a mensagem passa de 8 KB; envie leituras menores.