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 e controlar dispositivos compatíveis a partir da aplicação Casa ou com o 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 utilizando o 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ção flexível. 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 o 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 utilizadas 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: Adicionar entidades do Home Assistant ao 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 ao 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-a uma opção simples quando o Apple Home é o seu destino principal.  Os controlos disponíveis dependem dos tipos de entidades 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 bridge Matter compatível: exportar entidades compatíveis do Home Assistant

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

Uma bridge Matter com suporte para 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, a SONOFF Zigbee Bridge Ultra (ZBBridge-U) e a Bridge Max (Bridge-M) oferecem esta funcionalidade através de hardware dedicado. Depois de autorizar a bridge a aceder ao Home Assistant, pode selecionar as entidades compatíveis a disponibilizar através de Matter.  

👉 Consulte Como interligar dispositivos Home Assistant a redes Matter

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

Nota: a integração Matter integrada do Home Assistant tem uma função diferente — controla produtos Matter, mas não exporta, por si só, 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 bridge 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 comuns do Home Assistant em dispositivos Matter nem sincroniza divisões e automações. Quando suportado, o multiadministrador também pode ser utilizado com uma bridge Matter para disponibilizar os respetivos acessórios interligados 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 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 Home 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. Procure por HomeKit Bridge.

4. Siga os passos de configuração e escolha os domínios ou as entidades que pretende expor à Apple Home.  

Dica: 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 Home. 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 Home Assistant Bridge à Apple Home

No iPhone ou iPad:  

1. No iPhone:
2. Toque em + → Adicionar acessório.
3. Leia o código QR gerado pelo Home Assistant.  Se não conseguir digitalizá-lo, selecione Mais opções ou a opção equivalente para quando não é possível digitalizar, 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 os restantes passos 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 informações 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 nos dois sentidos:  

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

Quando tudo funcionar, pode expor entidades suportadas adicionais conforme necessário.

Para instalações maiores: o HomeKit suporta até 150 acessórios únicos 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 ao Apple Home através de uma bridge Matter SONOFF

Uma bridge Matter SONOFF permite expor controlos suportados do Home Assistant ao Apple Home, mantendo as integrações e automatizações existentes do Home Assistant.  

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

Porquê escolher uma bridge Matter SONOFF?  

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

As principais vantagens são:

● Acesso multiplataforma: exponha os controlos suportados 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 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 anfitrião do Home Assistant.

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

Antes de começar

Irá precisar de:  

● Home Assistant com os dispositivos pretendidos a funcionar corretamente.

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

● Um iPhone atualizado com a app Casa configurada.

● Um hub 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 Apple Home ligados à mesma rede local.  

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

🔔Consulte a matriz de dispositivos e funcionalidades SONOFF para confirmar que os dispositivos e as funções do Apple Home de que necessita são suportados.

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

Passo 1: Abra a interface local da bridge

● Ligue o ZBBridge-U e ligue-o ao router através de um cabo Ethernet.  

● Num navegador ligado à 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 na 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 de emparelhamento numérico.

Abra a app Casa e selecione a casa que pretende utilizar.

1. No iPhone:
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 fabrics Matter ligadas. Clique em Ver mais para consultar e gerir informações detalhadas das fabrics.

Passo 3: Autorizar o acesso ao Home Assistant

● Abra a secção Home Assistant da bridge e escolha Sync Home Assistant Entities to Matter Fabrics.

● 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, escolha 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, a menos que o tenha 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 com Matter.

Passo 4: Selecionar os dispositivos a expor na Apple Home

● Na interface Web local da bridge, abra Home Assistant → Sync Home Assistant Entities to Matter Fabrics → Sync Management.

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

● Dê à Apple Home algum tempo para apresentar os acessórios selecionados e, em seguida, reveja os respetivos nomes e divisões atribuídas.
● Teste as funções de que necessita, como o controlo de ligar/desligar, o brilho, as leituras de temperatura ou as definições do termóstato. No caso dos sensores, verifique se as alterações de estado são refletidas 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 alguma função, verifique se é compatível com a entidade do Home Assistant, o mapeamento da bridge SONOFF e a Apple Home.

Quando for prático, utilize uma rota de ligação por acessório. Expor o mesmo dispositivo através da HomeKit Bridge e da bridge Matter pode criar acessórios duplicados e complicar as automatizações.

Problemas comuns ao ligar o Home Assistant à Apple Home

"Sem resposta" na Apple Home

Primeiro, verifique se o dispositivo ainda funciona corretamente no Home Assistant.

Caso contrário, 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 detrá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 emparelhamento falha

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 multicast ou a rede de contentores podem interferir com a descoberta local.

• Para a HomeKit Bridge, certifique-se de que está a utilizar o código QR ou o PIN gerado pelo Home Assistant. Confirme também que a bridge não excede o limite de 150 acessórios do HomeKit.
• Para um dispositivo Matter que já tenha sido comissionado noutro ecossistema, utilize o fluxo de partilha do Matter em vez de presumir que o código de configuração original pode simplesmente ser 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 é compatível com esse tipo de entidade?
4. O Apple Home consegue representar a capacidade resultante?

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

Para uma Bridge Matter SONOFF, 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 é compatível com o Apple Home?

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

P2: A Siri pode controlar dispositivos do Home Assistant?

Sim. Assim que uma entidade compatível do Home Assistant for disponibilizada no 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 Bridge Matter: 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 Bridge Matter quando pretende especificamente uma via de exportação baseada em Matter, uma bridge de hardware dedicada ou uma arquitetura mais abrangente para vários ecossistemas.

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 Matter Multi-Admin é o mesmo que uma Bridge Matter?

Não. A funcionalidade multi-admin do Matter permite que um dispositivo Matter existente entre em mais do que um ecossistema Matter.

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