Como ligar o Home Assistant à Apple Casa: Guia de 2026

 

Introdução

O Home Assistant e o Apple Home podem funcionar em conjunto, permitindo-lhe manter os seus dispositivos e automatizações no Home Assistant enquanto controla dispositivos compatíveis a partir da aplicação Casa ou com a Siri.  

A melhor forma de os ligar depende da sua configuração. Os dispositivos já geridos pelo Home Assistant podem ser disponibilizados no Apple Home através do HomeKit Bridge ou de uma Matter Bridge compatível, enquanto os dispositivos que já suportam Matter podem ser partilhados entre as duas plataformas através do Matter multi-admin.  

Este guia compara estas opções, explica quando utilizar cada uma e fornece instruções passo a passo para ligar o Home Assistant ao Apple Home com o HomeKit Bridge e o SONOFF Matter Bridge.  

Home Assistant vs Apple Home: qual é a diferença?

O Home Assistant reúne dispositivos e serviços através de integrações, painéis personalizáveis e automatizações flexíveis. O Apple Home fornece uma interface partilhada para controlar acessórios compatíveis através de dispositivos Apple.  

Não tem necessariamente de escolher entre os dois. Uma configuração comum consiste em utilizar o Home Assistant para integrações de dispositivos e automatizações mais avançadas, mantendo o Apple Home como uma interface familiar para o controlo diário e para a Siri.

Também é importante distinguir o Apple Home do HomeKit. O Apple Home é o ecossistema de casa inteligente e a interface de utilizador da Apple, enquanto o HomeKit é uma das tecnologias que utiliza para ligar acessórios compatíveis. O Apple Home também suporta dispositivos Matter.

3 formas de ligar o Home Assistant ao Apple Home

1. HomeKit Bridge: introduza entidades do Home Assistant no Apple Home

● Entidades do Home Assistant → HomeKit Bridge → Apple Home

O HomeKit Bridge é uma integração gratuita e integrada que disponibiliza entidades compatíveis do Home Assistant na aplicação Casa e à Siri - mesmo quando os dispositivos originais não suportam o HomeKit.  

Não requer uma ponte física separada nem uma subscrição do Home Assistant Cloud. Isto torna-o uma opção simples quando o Apple Home é o seu destino principal.  Os controlos disponíveis dependem dos tipos de entidade e das funcionalidades suportadas pela integração.

Nota: Uma entidade representa uma função no Home Assistant, como uma luz, um interruptor ou uma leitura de temperatura. 

2. Uma ponte Matter compatível: exportar entidades compatíveis do Home Assistant

● Entidades compatíveis do Home Assistant → ponte Matter → Apple Home

Uma ponte Matter com suporte para o Home Assistant mapeia entidades compatíveis do Home Assistant para tipos de dispositivos e capacidades Matter que a Apple Home consegue reconhecer. Isto permite disponibilizar controlos selecionados do Home Assistant na Apple Home e noutros ecossistemas Matter compatíveis.  

Por exemplo, SONOFF Zigbee Bridge Ultra (ZBBridge-U) e Bridge Max (Bridge-M) oferecem esta funcionalidade através de hardware dedicado. Depois de autorizar a ponte a aceder ao Home Assistant, pode selecionar as entidades compatíveis a disponibilizar através do Matter.  

👉 Consulte Como ligar dispositivos do Home Assistant a redes Matter

Independentemente da implementação de ponte Matter utilizada, tanto a ponte como a Apple Home têm de suportar o tipo de dispositivo e as funcionalidades necessárias.  

Nota: a integração Matter integrada no Home Assistant tem uma função diferente — controla produtos Matter, mas não exporta as entidades existentes do Home Assistant como dispositivos Matter.  

3. Multiadministrador Matter: partilhar um produto Matter existente

● Dispositivo Matter → Apple Home e Home Assistant

O multiadministrador Matter permite que um dispositivo Matter ou uma ponte Matter compatível se associe a várias redes Matter, como a Apple Home e o Home Assistant. Se o seu dispositivo já suportar Matter, utilize o processo de partilha Matter da plataforma existente para o adicionar à segunda plataforma, mantendo a ligação original.  

O multiadministrador partilha o acesso; não converte entidades normais do Home Assistant em dispositivos Matter nem sincroniza divisões e automações. Quando suportado, o multiadministrador também pode ser utilizado com uma ponte Matter para disponibilizar os respetivos acessórios ligados em vários ecossistemas Matter.  

👉 Já utiliza um dispositivo Matter na Apple Home? Siga o guia oficial do Home Assistant para o partilhar com o Home Assistant.

Que método de ligação deve escolher?

● Escolha HomeKit Bridge para uma configuração simples e focada na Apple.

● Escolha Matter Multi-Admin quando o produto já suportar Matter.  

● Considere uma bridge Matter compatível, como a ZBBridge-U ou a Bridge Max, quando pretender uma solução de hardware dedicada para expor controlos suportados do Home Assistant através do Matter.  

Como ligar o Home Assistant à Apple Casa com a HomeKit Bridge  

Antes de começar, certifique-se de que os dispositivos que pretende expor já funcionam no Home Assistant. Durante o emparelhamento, mantenha o iPhone ou iPad e o anfitrião do Home Assistant na mesma rede local. Os nomes dos menus podem variar ligeiramente consoante as versões do software.  

Passo 1: Adicionar a HomeKit Bridge

No Home Assistant:

1. Abra Definições → Dispositivos e serviços.
2. Selecione Adicionar integração.
3. Pesquise por HomeKit Bridge.

4. Siga as instruções de configuração e escolha os domínios ou as entidades que pretende expor à Apple Casa.  

Sugestão: Na primeira configuração, comece com algumas luzes ou interruptores. 

Passo 2: Confirmar a HomeKit Bridge  

1. Após a configuração, a integração HomeKit Bridge aparece em Definições → Dispositivos e serviços.

2. O Home Assistant gera um código QR e um PIN para o emparelhamento com a Apple Casa. Se as informações de emparelhamento não estiverem visíveis, verifique as Notificações no Home Assistant.

3. Utilize o código gerado pelo Home Assistant - não o código de emparelhamento do dispositivo original.  

Passo 3: Adicionar a bridge do Home Assistant à Apple Casa

No iPhone ou iPad:  

1. Abra a aplicação Casa e selecione a casa que pretende utilizar.
2. Toque em + → Adicionar acessório.
3. Leia o código QR gerado pelo Home Assistant.  Se não conseguir lê-lo, selecione Mais opções ou a opção equivalente para quando não é possível ler o código, escolha a bridge detetada e introduza o respetivo PIN.
4. Se aparecer um aviso sobre um acessório não certificado, confirme que está a adicionar a sua própria bridge do Home Assistant e, em seguida, escolha a opção para continuar.
5. Siga as instruções restantes para adicionar os acessórios e atribuí-los a divisões.  

Quando a configuração estiver concluída, os acessórios suportados do Home Assistant deverão aparecer na aplicação Casa.  

👉 Para obter mais detalhes sobre o emparelhamento, consulte o guia oficial de configuração da HomeKit Bridge.

Passo 4: Testar a ligação antes de adicionar mais dispositivos  

Utilize um dos dispositivos expostos para confirmar que a ligação funciona em ambas as direções:  

1. Controle-o a partir da Apple Casa e verifique se o Home Assistant é atualizado.
2. Controle-o a partir do Home Assistant e verifique se a Apple Casa é atualizada.
3. Teste o controlo pela Siri utilizando o nome do acessório na Apple Casa.

Quando tudo estiver a funcionar, pode expor outras entidades suportadas conforme necessário.

Para configurações maiores: o HomeKit suporta até 150 acessórios exclusivos por bridge. Se exceder esse limite, divida os acessórios exportados por várias bridges. Este limite refere-se aos acessórios do HomeKit, que não correspondem necessariamente, um para um, a dispositivos físicos.

👉 Consulte o limite de dispositivos da bridge HomeKit.

Como ligar o Home Assistant à Apple Home através de uma bridge Matter SONOFF

Uma bridge Matter SONOFF permite expor controlos compatíveis do Home Assistant à Apple Home, mantendo as suas integrações e automatizações existentes do Home Assistant.  

Este tutorial utiliza o SONOFF ZBBridge-U como exemplo. A Bridge Max suporta o mesmo fluxo de trabalho do Home Assistant para Matter. 

Porquê escolher uma bridge Matter SONOFF?  

Esta abordagem é útil quando pretende uma bridge de hardware dedicada para expor controlos compatíveis do Home Assistant através do Matter com a Apple Home e outros ecossistemas Matter.

As principais vantagens são:

● Acesso multiplataforma: exponha os controlos compatíveis através do Matter e adicione a bridge a ecossistemas compatíveis utilizando os respetivos fluxos de emparelhamento ou partilha.

● Manter a configuração existente do Home Assistant: continue a utilizar as suas integrações e automatizações atuais sem mover os dispositivos originais para a bridge SONOFF.

● Configuração local: selecione entidades através da interface Web local da bridge sem instalar uma bridge Matter de software separada no seu host do Home Assistant.

O Home Assistant tem de permanecer em execução e acessível. A bridge SONOFF exporta os controlos compatíveis; não assume as suas integrações nem automatizações do Home Assistant. As funcionalidades disponíveis dependem dos mapeamentos da bridge e do suporte da Apple Home.

Antes de começar

Necessita de:  

● Home Assistant com os dispositivos pretendidos a funcionar corretamente.

● Uma bridge SONOFF compatível com o firmware atual.

● Um iPhone atualizado com a aplicação Casa configurada.

● Um hub da Apple Home compatível, como um HomePod, HomePod mini ou Apple TV compatível.  

● A bridge SONOFF, o Home Assistant, o iPhone e o hub da Apple Home ligados à mesma rede local.  

Evite utilizar uma rede Wi-Fi de convidados ou o isolamento de clientes durante a configuração. O Matter requer comunicação IPv6 local funcional e descoberta multicast.  

🔔Consulte a matriz de dispositivos e funcionalidades SONOFF para confirmar se os dispositivos e as funções da Apple Home de que necessita são compatíveis.

A configuração tem duas etapas principais: emparelhar a bridge SONOFF com a Apple Home e, em seguida, autorizar o acesso ao Home Assistant e selecionar as entidades a expor.  

Passo 1: Abrir a interface local da bridge

● Ligue o ZBBridge-U e conecte-o ao router utilizando um cabo Ethernet.  

● Num navegador na mesma rede, abra http://zbbridgeu.local/. Se esse endereço não resolver, utilize o endereço IP da bridge na lista de dispositivos do router.

● Conclua a configuração local inicial. 

👉 Os utilizadores da Bridge Max devem seguir o guia de configuração da Bridge Max através da Web local.

Passo 2: Adicionar a bridge Matter à Apple Home

● Na interface da bridge, localize Bridge Matter e selecione Iniciar emparelhamento. Também pode abrir Bridge Matter no menu de navegação esquerdo e iniciar o emparelhamento no separador Emparelhamento. 

Nota: A bridge apresenta um código QR Matter e o código numérico de emparelhamento.

No seu iPhone:

1. Abra a aplicação Casa e selecione a casa que pretende utilizar.
2. Toque em + → Adicionar acessório.
3. Leia o código QR Matter da bridge.
4. Siga as instruções para concluir o emparelhamento.

Após o emparelhamento, volte à interface Web local da SONOFF e verifique as estruturas Matter ligadas. Clique em Ver mais para consultar e gerir informações detalhadas sobre as estruturas.

Passo 3: Autorizar o acesso ao Home Assistant

● Abra a secção do Home Assistant na interface da bridge e selecione Sincronizar entidades do Home Assistant com estruturas Matter.

● Selecione Começar. A bridge procura instâncias do Home Assistant disponíveis na rede local.  

Se o seu servidor for encontrado, selecione-o e continue. Se a descoberta automática falhar, selecione Configuração manual e introduza:

● O endereço IP local ou o nome de domínio do Home Assistant.

● A porta do Home Assistant - normalmente 8123, exceto se o tiver alterado.

Selecione Iniciar sessão no Home Assistant, introduza as suas credenciais do Home Assistant na página de autorização e conceda acesso.

Após a autorização, a bridge carrega os dispositivos e as entidades do Home Assistant que pode avaliar para sincronização Matter.

Passo 4: Selecionar os dispositivos a expor na Apple Home

● Na interface Web local da bridge, abra Home Assistant → Sincronizar entidades do Home Assistant com estruturas Matter → Gestão da sincronização.

Selecione apenas as entidades compatíveis que pretende que a Apple Home descubra e, em seguida, selecione Guardar.

Passo 5: Verificar os dispositivos na Apple Home

● Aguarde um momento para que a Apple Home apresente os acessórios selecionados e, em seguida, reveja os respetivos nomes e divisões atribuídas.
● Teste as funções de que necessita, como ligar/desligar, regular a luminosidade, fazer leituras de temperatura ou ajustar as definições do termóstato. No caso dos sensores, verifique se as alterações de estado se refletem na Apple Home.
● Altere também o estado de um dispositivo no Home Assistant e confirme se a Apple Home é atualizada. Quando o controlo básico funcionar, experimente utilizar a Siri com o nome do acessório na Apple Home.
● Se faltar uma função, verifique se é compatível com a entidade do Home Assistant, o mapeamento da bridge SONOFF e a Apple Home.

Sempre que possível, utilize uma única via de ligação por acessório. Expor o mesmo dispositivo através da Bridge HomeKit e da bridge Matter pode criar acessórios duplicados e complicar as automações.

Problemas comuns ao ligar o Home Assistant à Apple Home

"Sem resposta" na Apple Home

Primeiro, verifique se o dispositivo continua a funcionar corretamente no Home Assistant.

Se não funcionar, resolva primeiro os problemas do dispositivo ou da integração original.

Se o dispositivo funcionar no Home Assistant mas apresentar Sem resposta no Apple Home, verifique a bridge e a ligação à rede local. Se todos os acessórios por trás da mesma bridge forem afetados, comece por verificar a bridge e não os dispositivos individuais.

👉 HomeKit Bridge: os dispositivos deixam de responder assim que são adicionados ao Apple Home

Bridge não encontrada ou falha no emparelhamento

Durante a configuração inicial, mantenha, sempre que possível, o seu dispositivo Apple, o anfitrião do Home Assistant e a bridge relevante na mesma rede local normal.

A rede Wi-Fi de convidados, o isolamento de clientes, as regras de VLAN, a filtragem de multicast ou a rede de contentores podem interferir com a deteção local.

• No caso da HomeKit Bridge, certifique-se de que está a utilizar o código QR ou PIN gerado pelo Home Assistant. Confirme também que a bridge não excede o limite de 150 acessórios do HomeKit.
• No caso de um dispositivo Matter que já esteja comissionado noutro ecossistema, utilize o fluxo de partilha do Matter em vez de presumir que o código de configuração original pode ser simplesmente reutilizado.

Entidades em falta ou não compatíveis

Verifique a ligação por camadas.

1. A entidade funciona corretamente no Home Assistant?
2. Selecionou-a para exportação?
3. A bridge escolhida suporta esse tipo de entidade?
4. O Apple Home consegue representar a capacidade resultante?

No caso da HomeKit Bridge, consulte também os domínios do Home Assistant compatíveis e os seus filtros de inclusão/exclusão.

No caso de uma SONOFF Matter Bridge, consulte a matriz de compatibilidade atual.

Voltar a emparelhar uma bridge não adiciona suporte para um tipo de entidade não compatível.

Perguntas frequentes

P1: O Home Assistant funciona com o Apple Home?

Sim. As entidades compatíveis do Home Assistant podem ser expostas ao Apple Home através da HomeKit Bridge ou de uma Matter Bridge compatível. Os dispositivos Matter existentes também podem ser partilhados entre ecossistemas quando a respetiva implementação de multiadministrador o permitir.

P2: A Siri pode controlar dispositivos do Home Assistant?

Sim. Assim que uma entidade compatível do Home Assistant for exposta ao Apple Home através da HomeKit Bridge ou de outra bridge compatível, a Siri poderá controlar as funções que o Apple Home reconhece.

P3: HomeKit Bridge ou Matter Bridge: qual devo utilizar?

Se o Apple Home for o seu destino principal e os seus dispositivos já funcionarem no Home Assistant, comece pela HomeKit Bridge.

Considere uma Matter Bridge quando quiser especificamente um caminho de exportação baseado em Matter, uma bridge de hardware dedicada ou uma arquitetura multi-ecossistema mais abrangente.

A disponibilidade das funcionalidades difere entre os dois métodos, por isso verifique os dispositivos e as funções de que realmente precisa, em vez de presumir que um método oferece tudo o que o outro oferece.

P4: O Multiadministrador Matter é o mesmo que uma Matter Bridge?

Não. O multiadministrador Matter permite que um dispositivo Matter existente entre em mais de um ecossistema Matter.

Uma Matter Bridge traduz dispositivos não-Matter compatíveis ou entidades do Home Assistant em endpoints Matter em ponte.