Guia Completo de Integração de Ocupação com Home Assistant

A cena repete-se em quase todos os edifícios que visitamos: uma sala de reuniões com sensor PIR no teto, luzes acesas, AVAC a plena carga — e ninguém lá dentro há quarenta minutos. Ou o inverso: seis pessoas sentadas, imóveis, numa sessão de trabalho, e o sistema apaga as luzes porque o PIR deixou de detetar movimento. Se a sua equipa gere um Home Assistant à escala de edifício, já viu ambos os casos. O problema não é a plataforma — é a qualidade do dado de ocupação que a alimenta.

Este guia trata a integração de ocupação Home Assistant como um projeto de engenharia, não como um tutorial de fim de semana. Vamos cobrir a arquitetura de dados, as entidades corretas, automações que fazem sentido em contexto comercial e os erros que só se descobrem depois do sistema estar em produção.

Deteção de presença não é contagem de ocupação

A primeira decisão de arquitetura é distinguir dois tipos de dado que muitas equipas misturam num único binary_sensor:

• Presença (binário): alguém está no espaço, sim ou não. Suficiente para iluminação de corredores e casas de banho.
• Ocupação (contagem): quantas pessoas estão no espaço, agora. Indispensável para AVAC modulante, ventilação por demanda, limites de capacidade e relatórios de utilização.

PIR e sensores de ondas milimétricas resolvem o primeiro caso com custo baixo. Para o segundo, precisa de sensores de contagem com IA na entrada de cada zona — e aqui a precisão importa contratualmente. Um sistema profissional deve garantir um mínimo de 96% de precisão, atingindo tipicamente 98–99% quando as condições de iluminação, o layout do espaço e o comportamento dos visitantes o permitem. Não aceite fornecedores que prometem 99% em qualquer cenário; quem já instalou sabe que uma porta com contraluz forte ou um átrio com fluxo cruzado degradam qualquer sensor.

Arquitetura: como o dado chega ao Home Assistant

Existem três caminhos práticos para levar contagens de ocupação até às entidades do Home Assistant:

• MQTT: o padrão de facto. A plataforma de contagem publica num tópico por zona (por exemplo, edificio/piso2/sala_reunioes/ocupacao) e o Home Assistant subscreve via MQTT Discovery ou configuração manual. Latência baixa, escala bem para dezenas de zonas.
• REST API com polling: mais simples de configurar, aceitável para dashboards e relatórios, mas o intervalo de polling (tipicamente 30–60 segundos) torna-o fraco para automações reativas.
• Webhooks: úteis para eventos discretos — atingir um limite de capacidade, por exemplo — sem tráfego constante.

Uma observação de quem já fez isto em produção: se usar MQTT com mensagens retidas, teste o comportamento após um reinício do Home Assistant. Uma contagem retida de há três horas pode disparar automações com dados obsoletos antes de o sensor publicar o valor atual. A solução é publicar um estado de disponibilidade (availability_topic) e configurar as entidades para ficarem unavailable até chegar dado fresco — cinco minutos de configuração que evitam chamadas noturnas do gestor do edifício.

Automações que justificam o investimento

Com contagens fiáveis por zona, as automações deixam de ser truques de demonstração e passam a ter retorno mensurável:

• Ventilação por demanda: module o caudal de ar por zona em função da contagem real, não de horários fixos. Em escritórios e universidades, é aqui que se elimina o desperdício dos sistemas sempre ligados.
• Alertas de capacidade: notificação automática quando uma zona atinge um limite predefinido — relevante para segurança, conformidade e gestão de eventos.
• Setback inteligente: zona vazia há 20 minutos passa a modo económico; a primeira entrada do dia repõe o setpoint. Use a contagem, não o PIR, para evitar falsos vazios.
• Limpeza baseada em utilização: ordene as rondas de limpeza pelas zonas com maior ocupação acumulada do dia, em vez de rotas fixas.

Os erros que aparecem depois do go-live

Três problemas surgem repetidamente em projetos reais e nenhum deles aparece nos tutoriais genéricos:

• Contaminação por pessoal: equipas de limpeza, segurança e manutenção circulam constantemente e inflacionam as contagens. Sensores com IA e exclusão de funcionários resolvem isto na origem — corrigir a posteriori com templates no Home Assistant é frágil e impreciso.
• Deriva de contagem: qualquer sistema entrada/saída acumula erro ao longo do dia. Defina um reset noturno automático e valide semanalmente as contagens de pico contra observação real durante o comissionamento.
• Zonas mal desenhadas: uma zona que abrange duas entradas com fluxos independentes produz dados inúteis. Desenhe as zonas em função das decisões que quer automatizar, não da planta arquitetónica.

Quando o Home Assistant chega — e quando precisa de mais

Para um edifício único, com uma equipa técnica que domina YAML e MQTT, o Home Assistant é uma camada de automação excelente e económica. Mas seja honesto sobre os limites: quando o projeto envolve múltiplos edifícios, integração formal com BMS existente, requisitos de auditoria ou SLAs de precisão, a arquitetura muda. É nesse ponto que plataformas como o VemFusion fazem sentido — ligando os dados de ocupação diretamente ao AVAC, ao BMS e aos sistemas de segurança com garantias contratuais — enquanto o VemSpace transforma o histórico de contagens em decisões de utilização de espaço: quantas salas de reuniões são realmente necessárias, que pisos podem ser consolidados, onde o always-on está a queimar orçamento. Em escritórios, universidades e edifícios públicos, é este histórico que sustenta os casos de negócio perante a administração — não os gráficos em tempo real.

A abordagem pragmática que recomendamos a integradores: use o Home Assistant como camada de orquestração local e prova de conceito, mas alimente-o com dados de contagem de nível profissional desde o primeiro dia. Trocar sensores baratos por sensores fiáveis a meio do projeto obriga a recalibrar todas as automações — e a reconquistar a confiança dos utilizadores que entretanto desligaram o sistema.

Está a planear uma integração de ocupação — seja num piloto com Home Assistant ou numa implementação multi-edifício com BMS? Fale com a equipa da Vemco sobre arquitetura de sensores, exclusão de pessoal e integração de dados em vemcogroup.com/contact-us. Trazemos a experiência de campo para que as suas automações funcionem com dados em que pode confiar.