Como conectar o Home Assistant ao Apple Home: Guia de 2026

 

Introdução

O Home Assistant e o Apple Home podem funcionar juntos, permitindo que você mantenha seus dispositivos e automações no Home Assistant enquanto controla dispositivos compatíveis pelo app Casa ou com a Siri.  

A melhor maneira de conectá-los depende da sua configuração. Dispositivos já gerenciados pelo Home Assistant podem ser disponibilizados no Apple Home por meio do HomeKit Bridge ou de uma Matter Bridge compatível, enquanto dispositivos que já são compatíveis com Matter podem ser compartilhados entre as duas plataformas usando o Matter multi-admin.  

Este guia compara essas opções, explica quando usar cada uma e fornece instruções passo a passo para conectar 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 por meio de integrações, painéis personalizáveis e automação flexível. O Apple Home oferece uma interface compartilhada para controlar acessórios compatíveis por meio de dispositivos Apple.  

Você não precisa necessariamente escolher entre eles. Uma configuração comum é usar o Home Assistant para integrações de dispositivos e automações mais avançadas, mantendo o Apple Home como uma interface familiar para o controle diário e a Siri.

Também é importante distinguir Apple Home de HomeKit. O Apple Home é o ecossistema e a interface de casa inteligente da Apple, enquanto o HomeKit é uma das tecnologias usadas para conectar acessórios compatíveis. O Apple Home também é compatível com dispositivos Matter.

3 maneiras de conectar o Home Assistant ao Apple Home

1. HomeKit Bridge: leve entidades do Home Assistant para o 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 no app Casa e para a Siri — mesmo quando os dispositivos originais não são compatíveis com o HomeKit.  

Ele não requer uma ponte física separada nem uma assinatura do Home Assistant Cloud. Isso o torna uma opção simples quando o Apple Home é seu destino principal.  Os controles disponíveis dependem dos tipos de entidade e dos recursos compatíveis com a integração.

Observação: 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: exporte entidades compatíveis do Home Assistant

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

Uma ponte Matter com suporte ao Home Assistant mapeia entidades compatíveis do Home Assistant para tipos de dispositivos e recursos Matter que o Apple Home pode reconhecer. Isso permite disponibilizar controles selecionados do Home Assistant no Apple Home e em outros ecossistemas Matter compatíveis.  

Por exemplo, SONOFF Zigbee Bridge Ultra (ZBBridge-U) e Bridge Max (Bridge-M) oferecem essa funcionalidade por meio de hardware dedicado. Depois de autorizar a ponte a acessar o Home Assistant, você pode selecionar as entidades compatíveis para disponibilizá-las por meio do Matter.  

👉 Veja Como conectar dispositivos do Home Assistant a fabrics Matter

Independentemente da implementação da ponte Matter usada, tanto a ponte quanto o Apple Home devem ser compatíveis com o tipo de dispositivo e os recursos necessários.  

Observação: a integração Matter integrada do Home Assistant tem uma função diferente - ela controla produtos Matter, mas não exporta entidades existentes do Home Assistant como dispositivos Matter.  

3. Multiadministrador do Matter: compartilhe um produto Matter existente

● Dispositivo Matter → Apple Home e Home Assistant

O multiadministrador do Matter permite que um dispositivo Matter compatível ou uma ponte Matter participe de vários fabrics Matter, como o Apple Home e o Home Assistant. Se o dispositivo já for compatível com Matter, use o fluxo de compartilhamento Matter da plataforma existente para adicioná-lo à segunda plataforma, mantendo a conexão original.  

O compartilhamento multiadministrador concede acesso; ele não converte entidades comuns do Home Assistant em dispositivos Matter nem sincroniza cômodos e automações. Quando compatível, o multiadministrador também pode ser usado com uma ponte Matter para disponibilizar os acessórios conectados à ponte em vários ecossistemas Matter.  

👉 Já está usando um dispositivo Matter no Apple Home? Siga o guia oficial do Home Assistant para compartilhá-lo com o Home Assistant.

Qual método de conexão você deve escolher?

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

● Escolha Matter Multi-Admin quando o produto já for compatível com Matter.  

● Considere uma ponte Matter compatível, como a ZBBridge-U ou a Bridge Max, quando quiser uma solução de hardware dedicada para disponibilizar controles compatíveis do Home Assistant por meio do Matter.  

Como conectar o Home Assistant ao Apple Home com a Ponte HomeKit  

Antes de começar, verifique se os dispositivos que você deseja disponibilizar já estão funcionando no Home Assistant. Durante o emparelhamento, mantenha o iPhone ou iPad e o host do Home Assistant na mesma rede local. Os nomes dos menus podem variar um pouco entre as versões do software.  

Etapa 1: adicionar a Ponte HomeKit

No Home Assistant:

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

4. Siga as instruções de configuração e escolha os domínios ou entidades que você deseja disponibilizar no Apple Home.  

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

Etapa 2: confirmar a Ponte HomeKit  

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

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

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

Etapa 3: adicionar a ponte do Home Assistant ao Apple Home

No iPhone ou iPad:  

1. Abra o app Casa e selecione a casa que deseja usar.
2. Toque em + → Adicionar acessório.
3. Escaneie o código QR gerado pelo Home Assistant.  Se não conseguir escaneá-lo, selecione Mais opções ou a opção equivalente para quando não for possível escanear, escolha a ponte encontrada e digite o PIN.
4. Se aparecer um aviso sobre acessório não certificado, confirme que você está adicionando sua própria ponte do Home Assistant e escolha a opção de continuar.
5. Siga as instruções restantes para adicionar os acessórios e atribuí-los aos cômodos.  

Quando a configuração for concluída, os acessórios compatíveis do Home Assistant deverão aparecer no app Casa.  

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

Etapa 4: testar a conexão antes de adicionar mais dispositivos  

Use um dos dispositivos disponibilizados para confirmar que a conexão funciona nos dois sentidos:  

1. Controle-o pelo Apple Home e verifique se o Home Assistant é atualizado.
2. Controle-o pelo Home Assistant e verifique se o Apple Home é atualizado.
3. Teste o controle pela Siri usando o nome do acessório no Apple Home.

Quando tudo estiver funcionando, você poderá disponibilizar outras entidades compatíveis conforme necessário.

Para configurações maiores: o HomeKit é compatível com até 150 acessórios exclusivos por ponte. Se você exceder esse limite, divida os acessórios exportados entre várias pontes. Esse limite se refere aos acessórios do HomeKit, que não necessariamente correspondem individualmente aos dispositivos físicos.

👉 Consulte o limite de dispositivos da bridge do HomeKit.

Como conectar o Home Assistant ao Apple Home por meio de uma bridge Matter SONOFF

Uma bridge Matter SONOFF permite expor controles compatíveis do Home Assistant ao Apple Home, mantendo suas integrações e automações atuais do Home Assistant.  

Este tutorial usa a SONOFF ZBBridge-U como exemplo. A Bridge Max é compatível com o mesmo fluxo do Home Assistant para o Matter. 

Por que escolher uma bridge Matter SONOFF?  

Esta abordagem é útil quando você quer uma bridge de hardware dedicada para expor controles compatíveis do Home Assistant por meio do Matter ao Apple Home e a outros ecossistemas Matter.

Os principais benefícios são:

● Acesso multiplataforma: exponha os controles compatíveis por meio do Matter e adicione a bridge a ecossistemas compatíveis usando os fluxos de emparelhamento ou compartilhamento correspondentes.

● Manter sua configuração atual do Home Assistant: continue usando suas integrações e automações atuais sem mover os dispositivos originais para a bridge SONOFF.

● Configuração local: selecione as entidades pela interface web local da bridge sem instalar uma bridge Matter de software separada no host do Home Assistant.

O Home Assistant deve permanecer em execução e acessível. A bridge SONOFF exporta os controles compatíveis; ela não assume o controle das suas integrações ou automações do Home Assistant. Os recursos disponíveis dependem tanto dos mapeamentos da bridge quanto do suporte do Apple Home.

Antes de começar

Você precisará de:  

● Home Assistant com os dispositivos desejados funcionando corretamente.

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

● Um iPhone atualizado com o app Casa configurado.

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

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

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

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 serem expostas.  

Etapa 1: Abra a interface local da bridge

● Ligue a ZBBridge-U e conecte-a ao roteador usando um cabo Ethernet.  

● Em um navegador conectado à mesma rede, abra http://zbbridgeu.local/. Se esse endereço não for resolvido, use o endereço IP da bridge na lista de dispositivos do roteador.

● Conclua a configuração local inicial. 

👉 Usuários do Bridge Max devem seguir o guia de configuração local pela web do Bridge Max.

Etapa 2: Adicione a ponte Matter ao Apple Home

● Na interface da ponte, encontre Ponte Matter e selecione Iniciar pareamento. Você também pode abrir Ponte Matter no menu de navegação à esquerda e iniciar o pareamento na guia Pareamento. 

Observação: A ponte exibe um código QR do Matter e o código numérico de pareamento.

No iPhone:

1. Abra o app Casa e selecione a casa que deseja usar.
2. Toque em + → Adicionar acessório.
3. Escaneie o código QR do Matter da ponte.
4. Siga as instruções para concluir o pareamento.

Após o pareamento, volte à interface web local da SONOFF e verifique as fabrics Matter conectadas. Clique em Ver mais para visualizar e gerenciar informações detalhadas das fabrics.

Etapa 3: Autorize o acesso ao Home Assistant

● Abra a seção do Home Assistant na ponte e escolha Sincronizar entidades do Home Assistant com as fabrics Matter.

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

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

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

● A porta do Home Assistant - normalmente 8123, a menos que você o tenha alterado.

Selecione Entrar no Home Assistant, insira suas credenciais do Home Assistant na página de autorização e conceda acesso.

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

Etapa 4: Selecione os dispositivos a serem expostos ao Apple Home

● Na interface web local da ponte, abra Home Assistant → Sincronizar entidades do Home Assistant com as fabrics Matter → Gerenciamento da sincronização.

Marque apenas as entidades compatíveis que você quer que o Apple Home descubra e selecione Salvar.

Etapa 5: Verifique os dispositivos no Apple Home

● Aguarde um momento para que o Apple Home exiba os acessórios selecionados e revise os nomes e os cômodos atribuídos.
● Teste as funções necessárias, como controle de ligar/desligar, brilho, leituras de temperatura ou configurações do termostato. Para sensores, verifique se as mudanças de estado são refletidas no Apple Home.
● Altere também o estado de um dispositivo no Home Assistant e confirme se o Apple Home é atualizado. Quando o controle básico funcionar, experimente usar a Siri com o nome do acessório no Apple Home.
● Se alguma função estiver ausente, verifique se ela é compatível com a entidade do Home Assistant, com o mapeamento da ponte SONOFF e com o Apple Home.

Quando possível, use uma rota de conexão por acessório. Expor o mesmo dispositivo pelo HomeKit Bridge e pela ponte Matter pode criar acessórios duplicados e complicar as automações.

Problemas comuns ao conectar o Home Assistant ao Apple Home

"Sem resposta" no Apple Home

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

Se não funcionar, solucione primeiro o problema do dispositivo ou da integração original.

Se o dispositivo funcionar no Home Assistant, mas exibir Sem resposta no Apple Home, verifique a ponte e a conexão de rede local. Se todos os acessórios por trás da mesma ponte forem afetados, comece verificando a ponte, e não os dispositivos individualmente.

👉 HomeKit Bridge: os dispositivos ficam sem resposta assim que são adicionados ao Apple Home

Ponte não encontrada ou falha no emparelhamento

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

O Wi-Fi de convidados, o isolamento de clientes, as regras de VLAN, a filtragem de multicast ou a rede do contêiner podem interferir na descoberta local.

• Para o HomeKit Bridge, certifique-se de usar o código QR ou PIN gerado pelo Home Assistant. Confirme também que a ponte não excede o limite de 150 acessórios do HomeKit.
• Para um dispositivo Matter que já foi comissionado em outro ecossistema, use o fluxo de compartilhamento do Matter em vez de presumir que o código de configuração original possa simplesmente ser reutilizado.

Entidades ausentes ou incompatíveis

Verifique a conexão por camadas.

1. A entidade funciona corretamente no Home Assistant?
2. Você a selecionou para exportação?
3. A ponte escolhida oferece suporte a esse tipo de entidade?
4. O Apple Home consegue representar o recurso resultante?

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

Para uma ponte Matter da SONOFF, consulte a matriz de compatibilidade atual.

Emparelhar uma ponte novamente não adiciona suporte a um tipo de entidade incompatível.

Perguntas frequentes

P1: O Home Assistant funciona com o Apple Home?

Sim. Entidades compatíveis do Home Assistant podem ser disponibilizadas no Apple Home pelo HomeKit Bridge ou por uma ponte Matter compatível. Dispositivos Matter existentes também podem ser compartilhados entre ecossistemas quando a implementação de multiadmin deles oferece suporte a isso.

P2: A Siri pode controlar dispositivos do Home Assistant?

Sim. Depois que uma entidade compatível do Home Assistant é disponibilizada no Apple Home pelo HomeKit Bridge ou por outra ponte compatível, a Siri pode controlar as funções que o Apple Home reconhece.

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

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

Considere uma ponte Matter quando você quiser especificamente um caminho de exportação baseado em Matter, uma ponte de hardware dedicada ou uma arquitetura mais ampla com vários ecossistemas.

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

P4: O Multiadmin do Matter é igual a uma ponte Matter?

Não. O multiadmin do Matter permite que um dispositivo Matter existente participe de mais de um ecossistema Matter.

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