Blog

integración de ocupación en Home Assistant — Cómo implementar la integración de ocupación en Home Assistant | Vemco Group

Escrito por Admin | Aug 28, 2026, 10:14:33 AM

La mayoría de los proyectos de ocupación en Home Assistant fracasan por una razón que nadie menciona en los tutoriales: confunden presencia con conteo. Un sensor PIR de 12 euros le dirá que hay alguien en la sala. No le dirá si hay 3 personas o 47, y esa diferencia es exactamente lo que determina si su sistema HVAC ventila lo justo o quema presupuesto ventilando una sala vacía al 80% de capacidad. Si su equipo gestiona oficinas, campus universitarios o edificios públicos, la integración de ocupación en Home Assistant solo genera retorno cuando la fuente de datos cuenta personas con precisión verificable, no cuando detecta movimiento.

Empiece por la fuente de datos, no por la automatización

Home Assistant es un excelente orquestador, pero es tan bueno como los datos que recibe. Antes de escribir una sola automatización, defina qué nivel de exactitud necesita cada zona. Para una sala de reuniones pequeña, un sensor mmWave puede bastar. Para plantas completas, auditorios o vestíbulos, necesita sensores de conteo con IA que distingan entradas y salidas reales. Los sistemas profesionales de conteo, como los que Vemco despliega desde 2005, trabajan con un mínimo contractual del 96% de exactitud, alcanzando típicamente entre el 98% y el 99% cuando la iluminación, la distribución del espacio y el comportamiento de los visitantes lo permiten. Ese matiz importa: cualquier proveedor que le garantice un 99% plano sin condiciones está vendiendo humo, y su integración heredará ese error acumulado zona por zona.

Un detalle que separa una instalación seria de un experimento: la exclusión de personal. Si su equipo de limpieza cruza el lobby 40 veces al día, sus datos de ocupación quedan contaminados y sus automatizaciones de climatización reaccionan a fantasmas. Los sensores de IA con exclusión de personal filtran ese ruido antes de que llegue a Home Assistant.

Arquitectura de integración: tres rutas viables

Existen tres formas prácticas de llevar datos de conteo a Home Assistant, cada una con implicaciones operativas distintas:

  • MQTT: la opción preferida para conteo en tiempo real. Cada sensor o pasarela publica el aforo neto por zona en un tópico, y Home Assistant lo consume mediante sensores MQTT con state_class: measurement. Latencia baja, escalable a cientos de zonas.
  • API REST con sondeo: útil cuando la plataforma de conteo expone un endpoint de ocupación actual. Configure el intervalo de sondeo según la criticidad: 30 segundos para alertas de aforo, 5 minutos para análisis de utilización.
  • Webhooks entrantes: ideales para eventos discretos, como el cruce de un umbral de aforo predefinido. Home Assistant recibe el evento y dispara la automatización sin sondear nada.

En despliegues mixtos, la combinación ganadora suele ser MQTT para el flujo continuo de datos y webhooks para alertas de límite. Los sistemas de ocupación en tiempo real con alertas en un límite predefinido —como los que Vemco opera en oficinas y edificios públicos— encajan de forma natural en este segundo patrón: el umbral se gestiona en la plataforma de conteo y Home Assistant solo ejecuta la respuesta.

Diseño de entidades: piense en zonas, no en dispositivos

Un error habitual de los integradores es mapear cada sensor físico a una entidad y construir automatizaciones directamente sobre ellas. Cuando el cliente reubica un sensor o añade una segunda entrada a una sala, todo se rompe. La estructura correcta es una capa intermedia:

  • Sensores crudos por dispositivo (entradas, salidas, conteo neto).
  • Sensores de plantilla por zona que agregan los dispositivos: sensor.ocupacion_planta_2, sensor.ocupacion_auditorio.
  • Sensores binarios derivados con histéresis: la zona se considera "ocupada" por encima de 3 personas y "libre" por debajo de 1, nunca con un único umbral, para evitar oscilaciones que hagan parpadear el HVAC.

Y aquí va una observación que solo aprende quien ha mantenido estas instalaciones en producción: el recorder de Home Assistant sufre con datos de ocupación de alta frecuencia. Un edificio con 60 zonas publicando cada 10 segundos genera cientos de miles de estados diarios, y la base de datos SQLite por defecto colapsa en semanas. Excluya los sensores crudos del recorder, conserve solo las entidades de zona, migre a MariaDB o PostgreSQL, y ajuste la retención a lo que realmente analiza. Nadie se lo dice en la documentación introductoria, y es la causa número uno de instalaciones que "se vuelven lentas sin motivo".

Automatizaciones que justifican el presupuesto

Con la capa de zonas estable, las automatizaciones de mayor impacto económico son predecibles y medibles:

  • Ventilación por demanda: module el caudal según el conteo real, no según horarios fijos. Las universidades y edificios públicos que sustituyen sistemas siempre encendidos por control basado en ocupación eliminan el desperdicio de climatizar aulas y salas vacías.
  • Apagado escalonado: cuando una zona baja a cero ocupantes y se mantiene así 15 minutos, reduzca iluminación y consigna de temperatura por fases, no de golpe, para no penalizar retornos breves.
  • Alertas de aforo: notificación al equipo de seguridad o señalización dinámica cuando una zona cruza su límite predefinido.
  • Limpieza basada en uso: genere órdenes de trabajo solo para las zonas que superaron un umbral de tráfico diario.

Cuándo Home Assistant no basta: el puente hacia el BMS

Sea honesto con el cliente sobre los límites. Home Assistant funciona muy bien como capa de automatización ligera y prototipado, pero en edificios corporativos el HVAC, el BMS y la seguridad ya tienen sus propios sistemas de control certificados. En esos casos, el patrón correcto no es reemplazarlos sino alimentarlos con datos de ocupación fiables. Plataformas como VemFusion conectan directamente los datos de ocupación con HVAC, BMS y sistemas de seguridad, mientras que VemSpace cubre el análisis de utilización de espacios y la optimización de instalaciones a largo plazo. Home Assistant puede convivir con ambos: consuma el mismo flujo MQTT para automatizaciones locales y visualización, y deje que la integración con el BMS corra por el canal profesional. Esa arquitectura dual evita el escenario donde un reinicio de Home Assistant deja la ventilación de un auditorio a ciegas.

Un consejo final de despliegue: valide la exactitud del conteo antes de activar cualquier automatización de coste. Dedique una semana a comparar el conteo automático con verificaciones manuales por muestreo en las zonas críticas. Si la desviación supera lo pactado, corrija la posición del sensor o la iluminación antes de conectar nada al HVAC. Automatizar sobre datos incorrectos no ahorra dinero: lo redistribuye hacia las quejas de confort.

¿Está planificando una integración de ocupación en Home Assistant o necesita conectar datos de conteo verificados a su BMS, HVAC o sistemas de seguridad? El equipo de Vemco lleva desde 2005 desplegando conteo con IA y exclusión de personal en oficinas, universidades y edificios públicos. Cuéntenos su caso en vemcogroup.com/contact-us y le ayudaremos a definir la arquitectura de sensores y la ruta de integración adecuada para su edificio.