OAuth de termostatos Nest e Ecobee (operadores)

Ative o OAuth do Nest e do Ecobee na sua instância do ProbeHarbor para que residências Pro conectem termostatos e tenham contexto interno nos alertas.

Close de cabos Ethernet Cat-5e brancos com conectores RJ45
O JSON das sondas normalmente sai da rede local por Ethernet ou por um relay próximo, não direto pela internet pública. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

Residências Pro podem conectar um termostato Nest ou Ecobee para que a temperatura interna e o setpoint apareçam no painel ao lado das sondas do sótão, do porão e da oficina, e para que os alertas de congelamento tragam esse contexto. Os usuários se conectam em Dashboard → Temperature; esta página é para quem administra o site e ativa o OAuth em uma instalação própria ou de produção.

Quando o botão de conexão aparece

O cartão do termostato fica oculto até a instalação ter as credenciais de cliente do provedor nos secrets do Worker. Depois que os secrets são enviados, os administradores Pro veem Connect para cada provedor configurado.

Nest (Google Device Access)

URI de redirecionamento de produção (probeharbor.dev): copie exatamente no Google Cloud Console:

https://probeharbor.dev/api/integrations/nest/callback
  1. Crie um projeto no Device Access Console (taxa única).
  2. Crie um cliente OAuth do Google Cloud (aplicativo da Web) no mesmo projeto do GCP vinculado ao Device Access.
  3. Ative a Smart Device Management API nesse projeto do GCP (o OAuth pode funcionar sem ela, mas as leituras ao vivo vão retornar 403 até que esteja ativada).
  4. Adicione a URI de redirecionamento acima (instalação própria: https://YOUR_SITE/api/integrations/nest/callback).
  5. Defina os secrets do Worker: NEST_CLIENT_ID, NEST_CLIENT_SECRET, NEST_PROJECT_ID (o UUID no topo do seu projeto do Device Access, não o número do projeto do Google Cloud).
  6. Adicione as chaves ao .env e envie: pnpm secrets:push

Ecobee

URI de redirecionamento de produção:

https://probeharbor.dev/api/integrations/ecobee/callback
  1. Cadastre-se no portal de desenvolvedores da Ecobee.
  2. Crie um app com a URI de redirecionamento acima (instalação própria: https://YOUR_SITE/api/integrations/ecobee/callback).
  3. Defina o secret do Worker: ECOBEE_CLIENT_ID (a Ecobee não usa client secret).
  4. Adicione ao .env e rode pnpm secrets:push.

Experiência do usuário

Cada residência guarda o próprio refresh token depois do OAuth; não existe um token de termostato global compartilhado. Os administradores podem desconectar pelo painel, e os tokens são revogados no banco de dados ao desconectar.

Veja também: central de integrações, ProbeHarbor vs Nest, vs Ecobee.

Perguntas frequentes

Quais termostatos se conectam ao ProbeHarbor?
Nest (Google Device Access / SDM) quando os secrets do Worker estão definidos, e Ecobee quando o cadastro de desenvolvedores está aberto. Guia: probeharbor.dev/about/thermostat-oauth.

O Nest é necessário para os alertas de congelamento?
Não. Os alertas de congelamento usam as suas sondas. Nest/Ecobee adicionam o contexto do interior da casa no Overview quando o plano permite (Pro).

E se o cadastro de desenvolvedores do Ecobee estiver fechado?
Use Home Assistant → ingestão → Indoor reference em Dashboard → Devices, para que a temperatura ambiente da casa continue aparecendo sobre o seu gráfico da semana.