Para enviar un comando a un dispositivo IoT y saber que llegó, guárdelo como una solicitud con un id, haga que el dispositivo responda con ese mismo id y siga su estado hasta que termine. La pestaña Commands de Hermetry (2.2.0, 22 de octubre de 2026) muestra cómo cada comando pasa de Queued a Sent y Delivered, y luego a Successful, Failed o Timed out.
Un envío sin confirmación sirve para una lectura. Para un comando que arranca una bomba o reinicia una pasarela, el operador necesita una respuesta clara: ¿llegó y funcionó?
¿Qué le dice cada estado del comando?
Cada estado responde a una parte de esa pregunta. Hermetry guarda cada comando como una solicitud y la hace pasar por estos estados:
| Estado | Significado |
|---|---|
| Queued | Guardado, a la espera del dispositivo |
| Sent | Enviado al dispositivo |
| Delivered | El dispositivo lo recibió |
| Successful | El dispositivo respondió con éxito |
| Failed | El dispositivo respondió con un error |
| Timed out | No llegó ninguna respuesta a tiempo |
| Expired | Caducó antes de poder entregarse |
| Cancelled | Alguien lo canceló |
Timed out es el estado que la gente interpreta mal. Significa que no llegó ninguna respuesta, no que el comando no se ejecutara, y Hermetry lo muestra como «No answer: the outcome is unknown». Yo revisaría el dispositivo antes de volver a enviar el mismo comando.
¿Cómo envía un comando desde la página del dispositivo?
Use la pestaña Commands del dispositivo, que ofrece los comandos del catálogo del perfil del dispositivo. El catálogo se configura por perfil, junto con el resto de ajustes del perfil.
- Abra el dispositivo y su pestaña Commands.
- Elija un comando en Choose a command y rellene sus Parameters.
- Defina el Answer timeout (seconds), de 1 a 600; si no lo define, se aplica el valor predeterminado del comando o del perfil, y si no existe, 10 segundos.
- Para un dispositivo que puede estar desconectado, active Deliver when the device comes back (persistent) y defina Give up after (24 hours por defecto, como máximo 7 days).
- Seleccione Send. Un comando de alto impacto pide primero una confirmación.
Sin persistent, un comando a un dispositivo desconectado falla de inmediato, y la pestaña lo advierte antes de enviarlo. Después, History muestra cada comando con su estado, quién o qué lo envió y su duración, durante 90 days.
¿Qué debe hacer el dispositivo para cerrar el ciclo?
Suscribirse, responder con el mismo id y no ejecutar nunca dos veces el mismo id. Por MQTT, el dispositivo se suscribe a v1/rpc/req/+ y responde a un comando de dos vías en el tópico de respuesta correspondiente:
PUBLISH v1/rpc/req/42
{"method": "sys.ping", "params": {"host": "192.0.2.10", "count": 3}}
PUBLISH v1/rpc/res/42
{"ok": true, "result": {"sent": 3, "received": 3, "avg_ms": 18.2}}
Un comando puede llegar dos veces, así que el dispositivo debería recordar al menos los últimos 32 ids de solicitud durante 10 minutos. Los comandos solo se entregan tras la suscripción en la conexión actual, lo que significa volver a suscribirse después de cada conexión, y solo viajan por sesiones TLS, salvo que el perfil permita un comando en claro. Un trabajo largo se acepta de inmediato con un job_id y su resultado se informa más tarde en el atributo rpc_result. Los fundamentos de los tópicos están en MQTT for industrial devices.
¿Cómo sabe que el comando hizo lo que pidió?
Successful significa que el dispositivo respondió con éxito; no demuestra que la válvula se haya movido. Compruebe el efecto con la telemetría propia del dispositivo, y si nada cambió físicamente, revise el lado del dispositivo.
Otros sistemas pueden seguir el mismo resultado sin consultar: el evento de webhook rpc.completed se dispara cuando un comando termina Successful, y rpc.failed cuando termina en Failed, Timed out o Expired. Los comandos de alto impacto y los raw se escriben en el registro de auditoría al crearse y al terminar. La referencia completa de estados está en sending commands to devices, y los comandos atascados se tratan en commands do not reach the device.
Preguntas frecuentes
¿Puedo enviar un comando a un dispositivo Hermetry desde mi propio software?
Sí, con la API de comandos: POST /api/iot/devices/{deviceId}/rpc con un method y parameters. Un comando de dos vías, no persistente, con un timeout de como máximo 30 segundos espera a su final y responde 200; cualquier otra llamada responde 202 de inmediato, y el resultado se consulta después por el id del comando.
¿Cuántos comandos puedo enviar a un dispositivo?
Por defecto, 10 comandos por dispositivo y minuto, y 600 por organización y minuto. Los parámetros pueden ser de hasta 16 KiB de JSON y una respuesta de hasta 64 KiB. Los comandos que los flujos envían a un dispositivo tienen un límite aparte, de 30 por minuto por defecto.
¿Puedo cancelar un comando después de enviarlo?
Sí, mientras esté en Queued o Sent. Abra el comando en History de la pestaña Commands y seleccione Cancel command; a través de la API, haga POST a la ruta de cancelación del comando. Un comando cancelado termina en el estado Cancelled, y una cancelación por API queda registrada en auditoría.

