Antes de empezar

Plan: la telemetría IoT está incluida desde el plan Finca en adelante (y en todos los planes superiores). Si tu plan no la incluye, al entrar a IoT & Automatización Cepaos te muestra qué plan la incluye y su precio en tu mercado.
Permisos: conectar equipos y gateways requiere rol Propietario o Admin.
Qué vas a conectar: si tu equipo (o la nube de su fabricante) puede enviar datos por internet por sí mismo, seguí el camino A. Si es un PLC o un equipo industrial sin conexión propia, seguí el camino B. ¿Dudás entre equipo y sensor? Leé el artículo «¿Equipo o sensor?» de este centro de ayuda.

Camino A — el equipo ya envía datos por internet

Menú IoT & Automatización → Equipos → Equipos conectados y tocá + Conectar equipo.
Elegí el tipo de equipo (prensa, bomba, embotelladora, estación meteorológica…) y, si aparece, el perfil de tu modelo.
Poné un nombre, como lo conoce tu equipo de trabajo. Fabricante, ubicación e ID de máquina son opcionales; con el fabricante Cepaos te sugiere pasos de instalación.
Al crear el equipo, Cepaos muestra la clave (API key) una sola vez. En «Para tu técnico» tenés la dirección a la que el equipo debe enviar los datos, un mensaje de ejemplo para ese tipo de equipo, una prueba rápida con curl, un archivo de configuración para descargar y un código QR. Guardá la clave en un lugar seguro: si la perdés, no se puede volver a ver; solo podés rotarla (se genera una nueva y la anterior deja de funcionar).
Tu técnico configura el equipo para enviar cada lectura como POST a esa dirección, con el encabezado Authorization: Bearer más la clave, y un JSON con al menos eventType (y, si corresponde, value y unit).
Abrí la ficha del equipo. Mientras no llegue nada verás una sala de espera que se actualiza sola cada 10 segundos; cuando entra el primer dato, aparece con su hora y su contenido para que confirmes que el formato es el correcto.

Camino B — equipos sin conexión propia: Cepaos Gateway

El gateway es una Raspberry Pi o mini-PC que vive en la bodega y traduce los protocolos industriales a datos que Cepaos entiende.

Prepará el aparato: desde Raspberry Pi 3 en adelante (recomendado Pi 4 con 2 GB o más) o una mini-PC, con Raspberry Pi OS Lite de 64 bits o Ubuntu Server 22.04 o superior, conectada por cable a la red de la bodega y con salida a internet.
Menú IoT & Automatización → Equipos → Gateway y tocá Conectar gateway. Poné un nombre y, si querés, la ubicación.
Cepaos genera un comando de instalación con un token que se muestra una sola vez, vale 24 horas y se consume en la primera conexión. Pegalo en la terminal de la Pi (por SSH o con teclado y pantalla). El script instala el agente como servicio y lo arranca; tarda unos 2 minutos.
En la página del gateway el estado pasa a «Online» cuando el agente se conecta. Si en 5 minutos no aparece, revisá los registros en la Pi con journalctl -u cepaos-gateway -f.
El gateway busca dispositivos en la red y los muestra en «Dispositivos descubiertos» (vuelve a buscar cada 5 minutos). Tocá Adoptar, poné un nombre y el dispositivo queda creado como equipo conectado.

Protocolos: Modbus TCP y MQTT ya se validaron con hardware real. Modbus RTU, OPC-UA y Siemens S7 están implementados pero todavía no se validaron con hardware real: escribinos antes de depender de ellos en producción.

Cuando ya llegan datos

Panel general (IoT & Automatización → Equipos → Panel general): estado de todos tus equipos de un vistazo.
Ficha del equipo: lecturas, historial y vista en vivo.
Alertas: la campana arriba a la derecha en las páginas de IoT abre el centro de alertas (comandos fallidos, errores que reporta el equipo, análisis de laboratorio fuera de rango, embotellados sin conciliar). Podés marcarlas como leídas o resolverlas.
Email: activá «Alertas IoT críticas por email» en tus preferencias de notificaciones (Ajustes). Solo se envía por alertas críticas nuevas; las repetidas se agrupan para no llenarte la casilla.

Opcional: control remoto (Bodega Conectada)

Recibir datos no requiere nada más. Enviar órdenes a un equipo (pausar, reanudar, iniciar un ciclo, según lo que soporte) sí: necesita el addon Bodega Conectada, que ves en Ajustes → Módulos con su precio y el botón para contratarlo (en algunos planes se incluye por contrato con ventas).

La primera vez que mandes un comando de riesgo medio o alto a un equipo, Cepaos te pide aceptar el acuerdo de uso para ese equipo.
Los comandos de riesgo alto no se ejecutan hasta que un segundo administrador los aprueba (o, si el equipo tiene su ficha con QR, hasta confirmar presencia física escaneándolo). Los pendientes están en IoT & Automatización → Equipos → Control remoto.

Si algo no funciona

El equipo figura sin señal: revisá alimentación y red. Si está detrás de un gateway, revisá primero el gateway.
El equipo recibe error 401: la clave no es la correcta, se rotó o el equipo fue archivado.
Error 422 o 400: el JSON no tiene el formato esperado (falta eventType o no es un JSON válido). Compará con el mensaje de ejemplo de «Para tu técnico».
Error 413: el mensaje supera los 8 KB; enviá lecturas más chicas.