ZHA ou Zigbee2MQTT no Home Assistant: Qual Escolher?

O LED azul do dongle pisca do mesmo jeito nos dois caminhos. Para o morador, tanto faz: ele quer abrir a porta e ver o sensor responder. Para quem administra a casa, muda quase tudo. ZHA e Zigbee2MQTT usam o mesmo rádio Zigbee, mas entregam experiências bem diferentes quando a rede começa a crescer.

A pergunta costuma chegar tarde. A pessoa instala uma integração qualquer, pareia 15 sensores, compra três interruptores Tuya em promoção e só então descobre que talvez o outro caminho lidasse melhor com aquele modelo específico. Não é tragédia. Mas migrar rede Zigbee depois de pronta quase sempre cobra seu preço: reparo, nomes, automações, rotas e paciência.

ZHA é a integração que menos atrapalha o começo#

ZHA é a escolha natural para quem quer Zigbee dentro do Home Assistant sem montar mais infraestrutura. Você conecta o coordenador, abre a integração Zigbee Home Automation, escolhe o rádio e começa a parear dispositivos. Não precisa instalar Mosquitto. Não precisa entender tópico MQTT. Não precisa manter outro painel.

Essa simplicidade não é fraqueza. Em casas com sensores Aqara comuns, tomadas IKEA, interruptores Zigbee bem suportados e poucos dispositivos exóticos, ZHA funciona de forma sólida. A interface segue o padrão do Home Assistant, os dispositivos entram como entidades normais, e as atualizações OTA aparecem pelo sistema de Update quando disponíveis.

O trecho oficial da integração ZHA deixa claro esse ponto: atualizações OTA aparecem como entidades de atualização, no mesmo fluxo usado pelo Home Assistant. Parafraseando a documentação, o usuário não precisa abrir uma central paralela só para ver que há firmware pendente. Para muita casa, esse nível de integração vale mais que um painel cheio de termos técnicos.

O problema é o teto. Quando um dispositivo aparece incompleto, quando a rede precisa de diagnóstico fino, quando um modelo Tuya tem firmware diferente do esperado, ZHA pode parecer econômico demais nas informações. Ele resolve a vida comum, mas nem sempre mostra o suficiente quando a vida comum quebra.

Zigbee2MQTT mostra mais do que o usuário médio queria ver#

Zigbee2MQTT segue outro espírito. Ele não tenta parecer parte invisível do Home Assistant. Ele é uma ponte entre Zigbee e MQTT, com interface própria, logs próprios, base de dispositivos própria e um jeito mais cru de mostrar o que acontece na rede. Para alguns, isso é excesso. Para outros, é o motivo de usar.

A documentação do projeto descreve a ideia central de forma direta: controlar dispositivos Zigbee sem bridge do fabricante, publicando eventos e aceitando comandos via MQTT. Em termos práticos, o dongle conversa com o sensor, o Zigbee2MQTT traduz, o broker distribui e o Home Assistant cria entidades. É uma peça a mais. Às vezes, essa peça salva a instalação.

O catálogo de dispositivos é o argumento mais forte. No Brasil, onde muito produto Zigbee chega por marketplace com marca genérica, firmware Tuya e nome de modelo que parece senha de roteador, Zigbee2MQTT costuma dar resposta antes. A comunidade adiciona conversores, documenta exposes e deixa claro quando um recurso funciona, quando é parcial e quando não tem jeito.

Só que visibilidade cobra manutenção. Você precisa cuidar de Mosquitto, do app Zigbee2MQTT, da integração MQTT, da serial do coordenador, dos backups e dos updates. Nada absurdo para usuário avançado. Para iniciante, é um cardápio de formas novas de errar.

A compatibilidade é onde a escolha deixa de ser teórica#

Se a sua rede usa dispositivos conhecidos, a diferença diminui. Sensor de porta Aqara, tomada IKEA, lâmpada Hue, módulos Sonoff populares e sensores de movimento comuns tendem a funcionar nos dois caminhos. O usuário aperta parear, o dispositivo aparece e a automação segue a vida.

A diferença aparece nos cantos. Um interruptor de seis botões com modo cena, um sensor mmWave Tuya TS0601 com parâmetros escondidos, uma tomada com medição de energia, um relé com múltiplos canais ou um dimmer que expõe atributos estranhos. Zigbee2MQTT costuma mostrar mais opções de configuração e dar mais pistas quando o modelo não foi mapeado direito.

ZHA também evoluiu. Seria preguiçoso dizer que ele é “básico” e parar por aí. Com quirk adequado, muita coisa funciona bem. Mas, no dia a dia da redação, Zigbee2MQTT ainda é o caminho que eu escolheria para uma casa que vai misturar marca nacional, importado barato, Aqara, IKEA, Sonoff, Tuya e dispositivo que muda de chip no meio do lote.

A rede pequena não precisa do mesmo remédio da rede grande#

Até 10 ou 15 dispositivos, ZHA tem uma vantagem brutal: ele fica quieto. Menos tela, menos log, menos peça, menos decisão. Para apartamento com sensores de porta, presença e alguns interruptores, essa quietude é boa. A rede Zigbee deve servir a casa, não virar hobby obrigatório.

Depois de 40 ou 50 dispositivos, a conversa muda. Roteadores alimentados, sensores a bateria, rotas, linkquality, canal, interferência, grupos, OTA e dispositivos com comportamento estranho começam a pesar. Nessa escala, o painel e os logs do Zigbee2MQTT ajudam a entender se o problema é o sensor, o caminho da malha, o coordenador, o firmware ou o excesso de otimismo do projeto.

Não existe número mágico. Existe sintoma. Se você nunca abre log, nunca precisa diagnosticar e tudo funciona, ZHA está ótimo. Se você vive tentando entender por que um sensor no corredor responde em 3 segundos enquanto o da cozinha responde na hora, Zigbee2MQTT dá ferramentas melhores.

OTA e firmware não deveriam decidir sozinhos#

Atualização OTA virou argumento de mesa de bar técnico. ZHA oferece atualizações integradas ao Home Assistant quando há suporte. Zigbee2MQTT também permite OTA para vários dispositivos, com painel e documentação por modelo. Na prática, o ponto principal não é quem tem botão de update. É se você precisa atualizar aquele dispositivo.

Firmware novo pode corrigir bug de consumo, melhorar pareamento ou resolver perda de conexão. Também pode mudar comportamento. Eu não atualizo rede Zigbee inteira por ansiedade. Atualizo quando há motivo: falha repetida, correção documentada, recurso necessário ou vulnerabilidade. O resto fica quieto.

Nos dois casos, backup antes. E, se possível, teste em dispositivo não crítico. Tomada de abajur aceita experimento. Módulo que controla freezer ou portão não é laboratório.

Migrar depois exige humildade#

A pior promessa que alguém pode fazer é dizer que migrar de ZHA para Zigbee2MQTT, ou o contrário, será sempre tranquilo. Depende do coordenador, do backup da rede, da chave Zigbee, do IEEE dos dispositivos, do modelo de cada sensor e do quanto suas automações dependem de nomes e entidades atuais.

Em muitos casos, o caminho mais seguro é aceitar o retrabalho: montar a nova integração, parear dispositivos por cômodo, renomear com padrão claro, testar automações e desativar a rede antiga por etapas. É chato, mas controlável. O que dá errado é migrar tudo às 22h, depois de apagar a rede antiga, com 30 sensores a bateria colados na parede.

Se você ainda não começou e sabe que vai querer rede grande, escolha agora. Zigbee não gosta de decisões reversíveis feitas tarde.

Manutenção é o critério que quase ninguém assume#

ZHA tem menos partes móveis. Isso reduz diagnóstico, mas também reduz ferramentas. Zigbee2MQTT tem mais partes móveis. Isso aumenta manutenção, mas entrega lupa. A escolha certa depende menos de “qual é melhor” e mais de quem vai cuidar quando algo falhar.

Se é você, entusiasta, que gosta de log e já usa MQTT para outras coisas, Zigbee2MQTT faz sentido. Se é um parente, cliente ou morador que só quer a casa funcionando, ZHA pode ser mais honesto. O melhor sistema é aquele que alguém consegue manter em uma terça-feira comum.

Para integradores, minha régua é dura: só use Zigbee2MQTT em projeto de cliente se você entrega backup, documentação, padrão de nomes, acesso controlado e plano de suporte. Instalar porque “é mais poderoso” e largar o cliente com Mosquitto quebrado é mau serviço.

A decisão final é menos dramática do que parece#

ZHA não é coisa de iniciante fraco. Zigbee2MQTT não é obrigação de usuário avançado. Eles são respostas diferentes para o mesmo problema: controlar Zigbee localmente no Home Assistant sem depender de hub de fabricante.

Minha recomendação direta: escolha ZHA para redes pequenas, dispositivos comuns e baixa manutenção. Escolha Zigbee2MQTT para redes médias ou grandes, dispositivos Tuya variados, necessidade de diagnóstico, uso já existente de MQTT ou projeto que vai crescer sem pedir licença.

O erro não está em escolher um ou outro. O erro está em fingir que os dois cobram o mesmo tipo de cuidado.

Se eu fosse montar minha própria casa com 60 dispositivos Zigbee em 2026, iria de Zigbee2MQTT. Se fosse configurar o apartamento de alguém com 12 sensores e 4 interruptores comuns, começaria por ZHA sem remorso. O padrão ouro, aqui, é escolher a ferramenta que você aguenta manter.