Integração do Home Assistant com a Alexa através da Matter Bridge: guia passo a passo

Introdução

Quer controlar um dispositivo do Home Assistant com um comando como “Alexa, liga a luz da sala”? Existem quatro formas práticas de disponibilizar dispositivos do Home Assistant na Alexa: Home Assistant Cloud, uma Alexa Smart Home Skill configurada manualmente, Emulated Hue ou uma bridge Matter.

Uma bridge Matter é útil quando pretende evitar tanto uma subscrição do Home Assistant Cloud como um endpoint do Home Assistant acessível publicamente. Traduz entidades suportadas do Home Assistant em endpoints Matter que a Alexa pode descobrir através de um controlador Matter compatível.

Este guia compara as quatro opções de integração Alexa do Home Assistant, explica o papel da Matter Bridge e mostra como disponibilizar entidades suportadas do Home Assistant na Alexa utilizando SONOFF ZBBridge-U e Bridge Max (Bridge-M).

1. O que faz realmente a integração Alexa do Home Assistant? 

A maioria das pessoas que procuram uma integração Alexa do Home Assistant pretende isto:

• Comando de voz da Alexa → entidade do Home Assistant → dispositivo inteligente

A sua luz, interruptor, cortina ou termóstato já está disponível no Home Assistant. Pretende que a Alexa o descubra e forneça um controlo de voz conveniente através de uma coluna Echo ou da aplicação Alexa.

Isto é diferente da integração Alexa Devices do Home Assistant, que adiciona dispositivos Echo e compatíveis com Alexa suportados ao Home Assistant para funcionalidades como anúncios, reprodução de som, comandos de texto e Não incomodar.

Neste guia, “integração Alexa do Home Assistant” significa disponibilizar dispositivos do Home Assistant na Alexa para descoberta e controlo por voz.

 

2. 4 formas de ligar o Home Assistant à Alexa

Existem quatro abordagens práticas para disponibilizar dispositivos do Home Assistant na Alexa: Home Assistant Cloud, uma Alexa Smart Home Skill manual, Emulated Hue e uma bridge Matter. As maiores diferenças são o custo da subscrição, a necessidade de o Home Assistant estar acessível publicamente, a complexidade da configuração e o suporte às capacidades dos dispositivos.

*O Home Assistant Cloud e a Smart Home Skill manual proporcionam geralmente capacidades mais abrangentes da Alexa. O Hue Emulado e o Bridge Matter dependem mais fortemente dos mapeamentos de dispositivos e capacidades suportados.  

Que método deve escolher?

● Home Assistant Cloud: ideal quando a facilidade de configuração e o suporte oficial são mais importantes do que evitar uma subscrição.

● Skill Alexa Smart Home manual: ideal para utilizadores avançados que pretendem capacidades mais abrangentes da Alexa sem o Home Assistant Cloud e que se sentem à vontade a manter a AWS e HTTPS público.

● Hue Emulado: adequado para um controlo básico por voz, mas o seu modelo de dispositivo ao estilo Hue e os requisitos de descoberta tornam-no menos flexível numa configuração nova. A documentação do próprio Home Assistant indica que os dispositivos são apresentados à Alexa, em grande medida, como luzes ao estilo Hue.

● Bridge Matter: útil quando pretende que o Home Assistant continue acessível apenas localmente, enquanto expõe tipos de dispositivo compatíveis à Alexa através do Matter.

Nota: também estão disponíveis bridges Matter de software. Projetos da comunidade, como o Home-Assistant-Matter-Hub e o Matterbridge, podem publicar entidades do Home Assistant no Matter sem hardware dedicado. Um bridge de hardware utiliza a mesma ideia básica, mas transfere o serviço do bridge para um dispositivo dedicado, em vez de o manter noutro suplemento ou contentor do Home Assistant.

A ligação por bridge Matter é agora uma opção prática para expor entidades compatíveis do Home Assistant à Alexa sem tornar o Home Assistant acessível publicamente. A sua principal limitação é a compatibilidade: tanto o bridge como a Alexa têm de suportar o tipo de dispositivo Matter e a capacidade correspondentes.  

 

3. Como é que um bridge Matter liga o Home Assistant à Alexa?

Um bridge Matter traduz entidades compatíveis do Home Assistant em endpoints Matter em bridge que a Alexa consegue compreender. O Home Assistant continua a ser o sistema que controla o dispositivo original; o bridge expõe apenas os tipos de dispositivo e as capacidades que consegue mapear para Matter.

A arquitetura tem dois fluxos distintos:

Durante a configuração:

• Entidade compatível do Home Assistant → o Bridge Matter mapeia a capacidade → endpoint Matter em bridge → estrutura Matter da Alexa  

Durante o controlo por voz:

• Pedido de voz → Nuvem Alexa → controlador Echo ou eero Matter compatível → Bridge Matter → Home Assistant → dispositivo-alvo

A comunicação Matter entre o controlador Alexa e a bridge ocorre através da rede local, tal como a ligação da bridge ao Home Assistant. O reconhecimento de voz da Alexa continua normalmente a depender da nuvem da Amazon.  

👉 A Amazon mantém uma lista atualizada dos tipos de dispositivos Matter suportados pela Alexa.

O Home Assistant tem uma bridge Matter incorporada?

Não. A integração Matter incorporada no Home Assistant torna o Home Assistant num controlador Matter, não numa bridge Matter. Pode controlar dispositivos Matter e dispositivos expostos por bridges Matter de terceiros, mas não pode publicar entidades existentes arbitrárias do Home Assistant como dispositivos Matter. Para esse caso de utilização, é necessária uma bridge Matter de software ou de hardware separada.

Esta distinção também explica por que motivo o multi-admin Matter não substitui uma bridge.

Bridge Matter vs. multi-admin Matter

• O multi-admin Matter partilha um dispositivo Matter já nativo com outro tecido Matter. Por exemplo, uma tomada Matter ligada ao Home Assistant também pode ser comissionada na Alexa.
• Uma bridge Matter resolve um problema diferente: representa dispositivos não Matter suportados ou dispositivos geridos pela plataforma como endpoints Matter.

Por conseguinte:

• Dispositivo Matter nativo que pretende utilizar no HA e na Alexa → use multi-admin.
• Entidade HA não Matter existente que pretende controlar com a Alexa → use uma bridge Matter.

 

4. Bridge Matter da SONOFF para Home Assistant e Alexa

A SONOFF Zigbee Bridge Ultra (ZBBridge-U) e a Bridge Max (Bridge-M) disponibilizam implementações de hardware dedicadas do fluxo de trabalho da Bridge Matter descrito acima. Após a autorização local do Home Assistant, podem expor à Alexa e a outros ecossistemas Matter as entidades suportadas do Home Assistant — incluindo dispositivos suportados de outras marcas.

A principal razão para escolher esta abordagem em vez de uma bridge Matter de software é operacional, e não ao nível do protocolo: não precisa de executar e manter outro complemento ou contentor de bridge Matter no anfitrião do Home Assistant.

Nota de compatibilidade: Apenas os tipos de entidades e as funcionalidades que a bridge consegue mapear para Matter — e que a Alexa suporta — estarão disponíveis. Consulte a tabela de compatibilidade de dispositivos e funcionalidades da bridge antes da configuração.  

ZBBridge-U vs. Bridge Max: qual deve escolher?  

Tanto a ZBBridge-U como a Bridge Max suportam o fluxo de trabalho abordado neste guia: autorização do Home Assistant, configuração da Web local e sincronização da Bridge Matter com a Alexa. Não são simplesmente versões topo de gama e de entrada do mesmo produto; os seus pontos fortes são diferentes.  

● Escolha aZBBridge-U se a capacidade Zigbee e as funcionalidades adicionais de hub forem prioritárias. Suporta até 256 dispositivos Zigbee compatíveis e inclui consideravelmente mais memória e armazenamento.

● Escolha a Bridge Max se uma conectividade mais abrangente for mais importante. Suporta até 128 dispositivos Zigbee compatíveis, adiciona suporte para BTHome e disponibiliza Wi-Fi 6 de banda dupla de 2,4/5 GHz, além de Ethernet.  

Para o fluxo de trabalho da bridge Matter entre o Home Assistant e a Alexa descrito neste artigo, ambos os produtos disponibilizam as funções necessárias de Bridge Matter e Web local.

 

5. Como ligar o Home Assistant à Alexa através de uma bridge Matter SONOFF?

Os passos abaixo utilizam a ZBBridge-U, mas o mesmo fluxo de trabalho entre o Home Assistant e a Alexa está disponível na Bridge Max; o esquema dos menus pode variar ligeiramente consoante o firmware.  

Esta configuração tem duas partes:

1. Comissione a bridge Matter SONOFF na rede Matter da Alexa.
2. Ligue a bridge Matter ao Home Assistant e selecione as entidades suportadas que pretende que a Alexa detete.

Este guia apresenta o fluxo de trabalho específico da Alexa na íntegra.   Para consultar o mesmo fluxo de trabalho do Matter Bridge com outros ecossistemas, veja Como fazer a ponte entre dispositivos Home Assistant e redes Matter.  

Antes de começar

Precisa de:

• Home Assistant com os dispositivos e entidades pretendidos a funcionar corretamente
• Matter Bridge (ZBBridge-U ou Bridge Max) com o firmware atual  
• A aplicação Alexa atual no seu telemóvel  
• Um Echo ou eero compatível a funcionar como controlador Matter Alexa  
• A aplicação Alexa tem sessão iniciada na conta Amazon que gere esse controlador

Para a configuração inicial, mantenha a bridge, o telemóvel e o controlador Matter Alexa na mesma LAN. O Home Assistant também tem de estar acessível localmente pela bridge. As configurações avançadas com VLAN podem funcionar, mas o comissionamento Matter depende do IPv6 e da deteção multicast, podendo exigir configuração de rede adicional.  

A aplicação Alexa é utilizada para a configuração, mas não é, por si só, o controlador Matter. Consulte a lista atual da Amazon de dispositivos Echo e eero compatíveis com Matter.

Dica: Utilize nomes de entidades curtos e distintos antes da sincronização. Evite expor vários dispositivos com nomes Alexa quase idênticos, pois isso pode tornar ambígua a seleção por voz.  

Passo 1: Abrir a interface Web local

Ligue a ponte à alimentação e à rede local. A partir de um telemóvel ou computador ligado à mesma rede, abra:  http://zbbridgeu.local/. Se o endereço .local não for resolvido, utilize o endereço IP da ponte apresentado pelo router.  

👉 Os utilizadores do Bridge Max devem abrir o endereço Web local próprio da ponte ou seguir o guia de configuração Web local do Bridge Max.

Durante o primeiro início de sessão, siga as instruções para definir o fuso horário e criar uma palavra-passe local.  

Passo 2: Adicionar a ponte Matter à Alexa

Na página inicial da Web local, localize Ponte Matter e selecione Iniciar emparelhamento. Também pode abrir Ponte Matter no menu de navegação esquerdo e iniciar o emparelhamento no separador Emparelhamento.  

A ponte apresenta um código QR Matter e o código de emparelhamento numérico. A sessão de emparelhamento permanece ativa durante aproximadamente 15 minutos.  

Na aplicação Alexa:

1. Abra Dispositivos.
2. Selecione + → Adicionar dispositivo.
3. Escolha Matter.
4. Leia o código QR ou introduza o código de emparelhamento numérico.
5. Siga as instruções apresentadas no ecrã para concluir a configuração.

Os nomes dos menus da Alexa podem variar consoante a versão da aplicação e a região.

Após o emparelhamento, abra Ponte Matter → Estruturas Matter na interface Web local para confirmar que a ponte aderiu a uma estrutura Matter. A remoção dessa estrutura também fará com que os dispositivos ligados através da ponte apareçam como offline ou indisponíveis na Alexa.

Passo 3: Ligar a ponte ao Home Assistant

Na interface Web local da ponte, selecione: Home Assistant → Sincronizar entidades do Home Assistant com estruturas Matter. 

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

Se o seu servidor for encontrado, selecione-o e continue. Se a deteção 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 aprove o 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: Selecione as entidades do Home Assistant a disponibilizar à Alexa

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

A lista indica o estado de cada entidade:  

• Não sincronizado: suportado e disponível para seleção
• Sincronizado: já disponibilizado numa fabric Matter
• Não suportado: não pode atualmente ser associado pela bridge

Selecione apenas as entidades suportadas que pretende que a Alexa detete e, em seguida, selecione Guardar.

Evite disponibilizar entidades de diagnóstico ou de atualização. Evite também enviar o mesmo dispositivo para a Alexa através de uma skill do fabricante e da Matter Bridge, pois vários caminhos de integração podem criar dispositivos Alexa duplicados.  

Uma entidade visível no Home Assistant não fica automaticamente disponível para sincronização. O respetivo tipo de entidade tem de ser suportado pela bridge e ser associado a uma capacidade suportada pela Alexa. Consulte a tabela de compatibilidade de dispositivos e funcionalidades da bridge quando uma entidade ou um controlo esperado não estiver disponível.  

Passo 5: Confirme os dispositivos e teste o controlo por voz da Alexa

Aguarde alguns instantes para que a Alexa atualize os endpoints interligados. Se necessário, inicie a deteção de dispositivos a partir da aplicação Alexa. Atribua os dispositivos detetados às divisões adequadas da Alexa e comece com um pedido básico, como «Alexa, liga o candeeiro da secretária.»  

Se o controlo de ligar/desligar funcionar, teste outras capacidades suportadas, como o brilho, a temperatura da cor, a posição das cortinas ou o valor definido do termóstato.

Utiliza dispositivos Zigbee? Estes passos partem do princípio de que os dispositivos que pretende disponibilizar já estão disponíveis no Home Assistant. Se os dispositivos geridos pelo ZBBridge-U ou Bridge Max ainda não tiverem sido sincronizados com o Home Assistant, consulte primeiro Como sincronizar subdispositivos Zigbee com o Home Assistant através de MQTT.

 

6. Resolução de problemas da bridge Alexa Matter do Home Assistant

A Alexa não consegue encontrar a bridge Matter

Confirme se dispõe de um controlador Echo ou eero Matter compatível. Verifique o tráfego IPv6 e multicast, evite redes Wi-Fi de convidado ou o isolamento de clientes e inicie uma nova sessão de emparelhamento Matter antes de voltar a ler o código.

A Alexa encontra dispositivos duplicados

Um dispositivo pode chegar à Alexa através de uma skill do fabricante, de um comissionamento Matter direto e da Ponte Matter do Home Assistant em simultâneo. Decida qual percurso deve ser a fonte principal, desative ou remova os outros e, em seguida, execute novamente a deteção. Se optar intencionalmente por manter vários percursos, atribua-lhes nomes claros para evitar que as rotinas e atribuições de divisões da Alexa tenham como alvo o endpoint errado.

Falta um dispositivo ou uma funcionalidade do Home Assistant na Alexa  

Um dispositivo pode falhar em vários pontos entre o Home Assistant e a Alexa. Verifique o percurso pela seguinte ordem:

1. Confirme que o dispositivo funciona no Home Assistant. Se a própria entidade estiver indisponível ou não puder ser controlada no Home Assistant, corrija primeiro essa integração.
2. Verifique se a ponte consegue ver a entidade. Abra a página de sincronização do Home Assistant na Local Web e confirme se o dispositivo/entidade aparece.
3. Verifique o estado da sincronização. Se apresentar Não suportado, a ponte não consegue atualmente mapear essa entidade ou capacidade para Matter. Se apresentar Não sincronizado, selecione-a e guarde a configuração.
4. Consulte a tabela de compatibilidade da SONOFF. Um tipo de entidade do Home Assistant pode incluir várias capacidades, e a ponte poderá disponibilizar apenas o subconjunto compatível com Matter.
5. Verifique o suporte Matter da Alexa. Mesmo que a ponte consiga criar o endpoint Matter, a Alexa poderá não disponibilizar todos os tipos de dispositivo, clusters ou funcionalidades Matter.
6. Atualize a deteção da Alexa. Se a entidade tiver sido sincronizada com sucesso, mas não aparecer, execute novamente a deteção de dispositivos e verifique se foi adicionada com outro nome de dispositivo ou noutra divisão.

Por exemplo, uma tomada inteligente pode disponibilizar corretamente o controlo de ligar/desligar, enquanto as medições de potência ou energia continuam indisponíveis. A distinção importante é que o suporte do dispositivo e o suporte de funcionalidades não são a mesma coisa.

 

Perguntas frequentes sobre a integração da Alexa com o Home Assistant

Q1: O Home Assistant pode ligar-se à Alexa sem o Nabu Casa?

Sim. As opções incluem uma Alexa Smart Home Skill configurada manualmente, o Emulated Hue para casos de utilização limitados e soluções de ponte Matter.

Q2: A Alexa controla localmente os dispositivos Matter?

O comando Matter entre um controlador Alexa Matter compatível e o dispositivo ou ponte Matter é local. O processamento de voz da Alexa continua normalmente a depender da nuvem da Amazon.

Q3: Preciso de um Echo para a Ponte Matter do Home Assistant?

É necessário um controlador Alexa Matter compatível, como um dispositivo Echo ou eero suportado. A aplicação móvel Alexa, por si só, não é o controlador Matter.