Integração do Home Assistant com a Alexa via ponte Matter: guia passo a passo

Introdução

Quer controlar um dispositivo do Home Assistant com um comando como “Alexa, acenda a luz da sala”? Há quatro maneiras práticas de expor dispositivos do Home Assistant à Alexa: Home Assistant Cloud, uma Alexa Smart Home Skill configurada manualmente, Hue emulado ou uma ponte Matter.

Uma ponte Matter é útil quando você quer evitar tanto uma assinatura do Home Assistant Cloud quanto um endpoint do Home Assistant acessível publicamente. Ela traduz entidades compatíveis do Home Assistant em endpoints Matter que a Alexa pode descobrir por meio de um controlador Matter compatível.

Este guia compara as quatro opções de integração do Home Assistant com a Alexa, explica onde a ponte Matter se encaixa e mostra como expor entidades compatíveis do Home Assistant à Alexa usando SONOFF ZBBridge-U e Bridge Max (Bridge-M).

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

A maioria das pessoas que pesquisam sobre uma integração do Home Assistant com a Alexa quer isto:

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

Sua luz, interruptor, cortina ou termostato já está disponível no Home Assistant. Você quer que a Alexa o descubra e ofereça um controle de voz conveniente por meio de um alto-falante Echo ou do aplicativo Alexa.

Isso é diferente da integração Dispositivos Alexa do Home Assistant, que traz dispositivos Echo e compatíveis com Alexa para o Home Assistant, oferecendo recursos como anúncios, reprodução de áudio, comandos de texto e Não perturbe.

Neste guia, “integração do Home Assistant com a Alexa” significa expor dispositivos do Home Assistant à Alexa para descoberta e controle por voz.

 

2. 4 maneiras de conectar o Home Assistant à Alexa

Há quatro abordagens práticas para expor dispositivos do Home Assistant à Alexa: Home Assistant Cloud, uma Alexa Smart Home Skill configurada manualmente, Hue emulado e uma ponte Matter. As maiores diferenças são o custo da assinatura, a necessidade de o Home Assistant estar acessível publicamente, a complexidade da configuração e o suporte aos recursos dos dispositivos.

*O Home Assistant Cloud e a Skill manual de casa inteligente geralmente oferecem recursos mais amplos da Alexa. O Hue emulado e a ponte Matter dependem mais fortemente dos mapeamentos de dispositivos e recursos compatíveis.  

Qual método você deve escolher?

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

● Skill manual de casa inteligente da Alexa: ideal para usuários avançados que desejam recursos mais amplos da Alexa sem o Home Assistant Cloud e se sentem confortáveis em manter a AWS e o HTTPS público.

● Hue emulado: adequado para controle básico por voz, mas seu modelo de dispositivo no estilo Hue e os requisitos de descoberta o tornam menos flexível para uma nova configuração. A própria documentação do Home Assistant observa que os dispositivos são apresentados em grande parte à Alexa como luzes no estilo Hue.

● Ponte Matter: útil quando você quer que o Home Assistant permaneça acessível apenas localmente, enquanto expõe tipos de dispositivo compatíveis à Alexa por meio do Matter.

Observação: também existem pontes Matter de software. Projetos da comunidade, como Home-Assistant-Matter-Hub e Matterbridge, podem publicar entidades do Home Assistant no Matter sem hardware dedicado. Uma ponte de hardware usa a mesma ideia básica, mas transfere o serviço da ponte para um dispositivo dedicado, em vez de outro complemento ou contêiner do Home Assistant.

A ponte Matter agora é uma opção prática para expor entidades compatíveis do Home Assistant à Alexa sem tornar o Home Assistant publicamente acessível. Sua principal limitação é a compatibilidade: tanto a ponte quanto a Alexa precisam ser compatíveis com o tipo de dispositivo e o recurso Matter correspondentes.  

 

3. Como uma ponte Matter conecta o Home Assistant à Alexa?

Uma ponte Matter traduz entidades compatíveis do Home Assistant em endpoints Matter conectados que a Alexa consegue entender. O Home Assistant continua sendo o sistema que controla o dispositivo original; a ponte expõe apenas os tipos de dispositivo e recursos que consegue mapear para o Matter.

A arquitetura tem dois fluxos distintos:

Durante a configuração:

• Entidade compatível do Home Assistant → a ponte Matter mapeia o recurso → endpoint Matter conectado → malha Matter da Alexa  

Durante o controle por voz:

• Solicitação de voz → nuvem da Alexa → controlador Echo ou eero Matter compatível → ponte Matter → Home Assistant → dispositivo-alvo

A comunicação Matter entre o controlador Alexa e a ponte ocorre pela rede local, assim como a conexão da ponte com o Home Assistant. O reconhecimento de voz da Alexa normalmente ainda depende da nuvem da Amazon.  

👉 A Amazon mantém uma lista atualizada de tipos de dispositivos Matter compatíveis com a Alexa.

O Home Assistant tem uma ponte Matter integrada?

Não. A integração Matter integrada do Home Assistant torna o Home Assistant um controlador Matter, não uma ponte Matter. Ela pode controlar dispositivos Matter e dispositivos expostos por pontes Matter de terceiros, mas não pode publicar entidades existentes arbitrárias do Home Assistant como dispositivos Matter. É necessária uma ponte Matter de software ou hardware separada para esse caso de uso.

Essa distinção também explica por que o multiadministrador Matter não substitui uma ponte.

Ponte Matter vs. Multiadministrador Matter

• O multiadministrador Matter compartilha um dispositivo Matter nativo já existente com outro tecido Matter. Por exemplo, uma tomada Matter conectada ao Home Assistant também pode ser comissionada na Alexa.
• Uma ponte Matter resolve um problema diferente: ela representa dispositivos compatíveis que não são Matter ou que são gerenciados pela plataforma como endpoints Matter.

Portanto:

• Dispositivo Matter nativo que você deseja usar tanto no HA quanto na Alexa → use multiadministrador.
• Entidade HA não Matter existente que você deseja controlar pela Alexa → use uma ponte Matter.

 

4. Ponte Matter da SONOFF para Home Assistant e Alexa

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

O principal motivo para escolher essa abordagem em vez de uma ponte Matter de software é operacional, e não relacionado ao protocolo: você não precisa executar e manter outro complemento ou contêiner de ponte Matter no host do Home Assistant.

Observação sobre compatibilidade: somente os tipos de entidade e recursos que a ponte pode mapear para o Matter — e que a Alexa oferece suporte — estarão disponíveis. Consulte a tabela de compatibilidade de dispositivos e recursos da ponte antes da configuração.  

ZBBridge-U ou Bridge Max: qual você deve escolher?  

A ZBBridge-U e a Bridge Max são compatíveis com o fluxo abordado neste guia: autorização do Home Assistant, configuração do Web local e sincronização da Matter Bridge com a Alexa. Elas não são simplesmente versões mais e menos avançadas do mesmo produto; seus pontos fortes são diferentes.  

● Escolha a ZBBridge-U se a escala do Zigbee e os recursos adicionais de hub forem a prioridade. Ela é compatível com até 256 dispositivos Zigbee compatíveis e inclui muito mais memória e armazenamento.

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

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

 

5. Como conectar o Home Assistant à Alexa por meio de uma Matter Bridge da SONOFF?

As etapas abaixo usam a ZBBridge-U, mas o mesmo fluxo do Home Assistant para a Alexa está disponível na Bridge Max; o layout dos menus pode variar ligeiramente conforme o firmware.  

Esta configuração tem duas partes:

1. Faça o comissionamento da bridge Matter da SONOFF na rede Matter da Alexa.
2. Conecte a bridge Matter ao Home Assistant e selecione as entidades compatíveis que você deseja que a Alexa descubra.

Este guia apresenta o fluxo específico da Alexa em detalhes.   Para ver o mesmo fluxo da Matter Bridge com outros ecossistemas, consulte Como conectar dispositivos do Home Assistant a redes Matter.  

Antes de começar

Você precisa de:

• Home Assistant com os dispositivos e as entidades desejados funcionando corretamente
• Matter Bridge (ZBBridge-U ou Bridge Max) com o firmware atualizado  
• O aplicativo Alexa atualizado no seu telefone  
• Um Echo ou eero compatível atuando como controlador Matter da Alexa  
• O aplicativo Alexa está conectado à conta da Amazon que gerencia esse controlador

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

O aplicativo Alexa é usado para a configuração, mas não é o controlador Matter. Consulte a lista atual de dispositivos Echo e eero compatíveis com Matter da Amazon.

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

Etapa 1: Abrir a interface Web local

Ligue a ponte e conecte-a à sua rede local. Em um telefone ou computador conectado à mesma rede, abra:  http://zbbridgeu.local/. Se o endereço .local não for resolvido, use o endereço IP da ponte exibido pelo roteador.  

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

Durante o primeiro login, siga as instruções para definir o fuso horário e criar uma senha local.  

Etapa 2: Adicionar a ponte Matter ao Alexa

Na página inicial da Web local, localize Ponte Matter e selecione Iniciar pareamento. Você também pode abrir Ponte Matter no menu de navegação à esquerda e iniciar o pareamento na aba Pareamento.  

A ponte exibe um código QR do Matter e o código numérico de pareamento. A sessão de pareamento permanece ativa por aproximadamente 15 minutos.  

No aplicativo Alexa:

1. Abra Dispositivos.
2. Selecione + → Adicionar dispositivo.
3. Escolha Matter.
4. Escaneie o código QR ou insira o código numérico de pareamento.
5. Siga as instruções na tela para concluir a configuração.

Os nomes dos menus do Alexa podem variar de acordo com a versão do aplicativo e a região.

Após o pareamento, abra Ponte Matter → Tecidos Matter na interface Web local para confirmar que a ponte entrou em um tecido Matter. Remover esse tecido também fará com que os dispositivos conectados a ele apareçam offline ou indisponíveis no Alexa.

Etapa 3: Conectar a ponte ao Home Assistant

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

Selecione Começar. A ponte verifica a rede local em busca de instâncias disponíveis do Home Assistant.  

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 nome de domínio do Home Assistant.
• A porta do Home Assistant — normalmente 8123, a menos que você tenha alterado.

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

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

Etapa 4: selecione as entidades do Home Assistant a serem expostas à Alexa

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

A lista mostra o status de cada entidade:  

• Não sincronizado: compatível e disponível para seleção
• Sincronizado: já exposto a uma estrutura Matter
• Não compatível: atualmente não pode ser mapeado pela ponte

Marque apenas as entidades compatíveis que você deseja que a Alexa descubra e selecione Salvar.

Evite expor entidades de diagnóstico ou atualização. Evite também enviar o mesmo dispositivo para a Alexa por meio de uma skill do fabricante e da ponte Matter, 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 tipo de entidade deve ser compatível com a ponte e corresponder a um recurso compatível com a Alexa. Consulte a tabela de compatibilidade de dispositivos e recursos da ponte quando uma entidade ou um controle esperado não estiver disponível.  

Etapa 5: confirme os dispositivos e teste o controle de voz da Alexa

Aguarde um momento para que a Alexa atualize os endpoints conectados pela ponte. Se necessário, inicie a descoberta de dispositivos pelo aplicativo Alexa. Atribua os dispositivos encontrados aos cômodos apropriados da Alexa e comece com uma solicitação básica, como "Alexa, acenda a luminária da mesa."  

Se o controle de ligar/desligar funcionar, teste outros recursos compatíveis, como brilho, temperatura da cor, posição da cortina ou ponto de ajuste do termostato.

Usando dispositivos Zigbee? Estas etapas pressupõem que os dispositivos que você deseja expor já estejam disponíveis no Home Assistant. Se os dispositivos gerenciados 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 via MQTT.

 

6. Solução de problemas da ponte Matter do Alexa para o Home Assistant

A Alexa não consegue encontrar a ponte Matter

Confirme se você tem um controlador Echo ou eero Matter compatível. Verifique o IPv6 e o tráfego multicast, evite o Wi-Fi para convidados ou o isolamento de clientes e inicie uma nova sessão de pareamento Matter antes de ler o código novamente.

Alexa encontra dispositivos duplicados

Um dispositivo pode chegar à Alexa por meio de uma skill do fabricante, do comissionamento Matter direto e da ponte Matter do Home Assistant ao mesmo tempo. Decida qual caminho deve ser a fonte principal, desative ou remova os outros e execute a descoberta novamente. Se você mantiver intencionalmente vários caminhos, renomeie-os de forma clara para evitar que as rotinas e atribuições de cômodos da Alexa direcionem comandos ao endpoint errado.

Um dispositivo ou recurso do Home Assistant está ausente na Alexa  

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

1. Confirme se 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 identificar a entidade. Abra a página de sincronização do Home Assistant no Local Web e confirme se o dispositivo ou a entidade aparece.
3. Verifique o status de sincronização. Se aparecer Não compatível, a ponte não consegue mapear atualmente essa entidade ou recurso para o Matter. Se aparecer Não sincronizado, selecione-o e salve a configuração.
4. Verifique a tabela de compatibilidade da SONOFF. Um tipo de entidade do Home Assistant pode conter vários recursos, e a ponte pode disponibilizar apenas o subconjunto compatível com Matter.
5. Verifique o suporte da Alexa ao Matter. Mesmo que a ponte consiga criar o endpoint Matter, a Alexa pode não disponibilizar todos os tipos de dispositivo, clusters ou recursos do Matter.
6. Atualize a descoberta da Alexa. Se a entidade tiver sido sincronizada com sucesso, mas não aparecer, execute a descoberta de dispositivos novamente e verifique se ela foi adicionada com outro nome de dispositivo ou cômodo.

Por exemplo, uma tomada inteligente pode disponibilizar o controle de ligar/desligar com sucesso, enquanto as medições de potência ou energia permanecem indisponíveis. A distinção importante é que o suporte ao dispositivo e o suporte a recursos não são a mesma coisa.

 

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

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

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

Q2: A Alexa controla dispositivos Matter localmente?

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

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

Você precisa de um controlador Alexa Matter compatível, como um dispositivo Echo ou eero compatível. O aplicativo móvel Alexa, por si só, não é o controlador Matter.