# Guia do Google Home e Alexa (via Homebridge) — passo a passo fácil

**O que é, em uma frase:** coloca os dispositivos do Nexus também no **Google Home**
e na **Alexa**, aproveitando o **Homebridge** que você já configurou.

**Fique tranquilo:** é um **extra** — não mexe no Nexus.

**Pré-requisito:** ter o **Homebridge + plugin `homebridge-nexus` funcionando** (os
dispositivos do Nexus já aparecendo no app **Casa** da Apple). Se ainda não tem, faça
antes o `deploy/INTEGRACAO-HOMEBRIDGE.md`.

Há **dois caminhos**. **Prefira o Caminho A (Matter)** — é moderno, funciona na sua
rede e **não tem assinatura**.

---

## Caminho A (recomendado) — Matter

O **Homebridge 2** fala o padrão **Matter**, que leva seus dispositivos ao Google
Home **e** à Alexa (e SmartThings) de uma vez, local e sem mensalidade.

1. Garanta que está no **Homebridge 2** e ative o **Matter** (pelo **Config UI X** —
   plugin **homebridge-matter** ou o Matter nativo do Homebridge 2).
2. Ative a exposição por Matter — vai aparecer um **código de pareamento** no formato
   `xxxx-xxx-xxxx`. Anote.
3. No app **Google Home** (celular): **Adicionar → Dispositivo → Matter** e digite/leia
   o código.
4. No app **Alexa** (celular): **Adicionar dispositivo → Outros (Matter)** e use o
   **mesmo código**.

✅ **Deu certo se:** os dispositivos do Nexus aparecem no **Google Home** e na
**Alexa**, e você consegue ligar/desligar por voz.

---

## Caminho B (alternativo) — pontes de nuvem (mais antigo)

Funciona sem Matter, mas depende da nuvem das pontes (e o Google agora cobra assinatura).

**Google — plugin `homebridge-gsh`:**
1. No **Config UI X**, procure "Google Home" e instale **homebridge-gsh**.
2. Nas configurações do plugin, clique **Link Account** e entre com Google/GitHub.
3. Observações: **exige assinatura** (desde mai/2025) e o Homebridge precisa rodar em
   **insecure mode**.

**Alexa — plugin `homebridge-alexa`:**
1. No **Config UI X**, instale **homebridge-alexa** (NorthernMan54).
2. No app da Alexa, habilite a skill **"Homebridge"** e faça **Link Account** com a
   mesma conta do plugin.
3. Tipos suportados: luz, tomada, interruptor, ventilador, sensor, persiana e **porta
   de garagem**. **Não** suporta fechadura (Lock).

---

## Portões nos assistentes (se você expôs os portões)

- **Matter / Google:** o portão pode ficar como **fechadura** (padrão
  `doorAccessoryType: "lock"` no plugin).
- **Alexa (nuvem):** use **`doorAccessoryType: "garage"`** — a skill não tem fechadura,
  mas tem porta de garagem (o plugin aciona por pulso e "fecha" depois de alguns segundos).
- **Segurança:** só exponha portões (`exposeDoors: true` + escopo `doors:open`) se
  entender o risco — **qualquer pessoa na sua conta Google/Alexa poderá abrir o portão
  por voz**. O mais seguro é **não** expor portões e deixar só os on/off.

---

## Deu algum problema?

- **Nada aparece no Google/Alexa:** confirme primeiro que o **Homebridge + Nexus**
  estão ok (dispositivos no app Casa da Apple). O Google/Alexa vêm **depois** disso.
- **O Matter não pareia:** você precisa do **Homebridge 2** com o Matter ativo, e do
  código de pareamento correto.
- **Comando de voz não entende o nome:** renomeie o acessório no app do assistente
  (ex.: "luz da garagem").

---

## Dicas e fontes

- Mantenha o Homebridge e o Nexus na **mesma rede**; nada do Nexus precisa ficar
  exposto na internet nesses caminhos.
- Fontes: homebridge-gsh <https://github.com/homebridge-plugins/homebridge-gsh> ·
  homebridge-alexa <https://github.com/NorthernMan54/homebridge-alexa> ·
  Homebridge 2 + Matter <https://github.com/homebridge-plugins/homebridge-matter/wiki/Enabling-Matter>