OAuth de termostatos Nest y Ecobee (operadores)

Activa OAuth de Nest y Ecobee en tu instalación de ProbeHarbor para que los hogares Pro conecten termostatos y den contexto interior a las alertas.

Primer plano de cables Ethernet Cat-5e blancos con conectores RJ45
El JSON de las sondas suele salir de la LAN por Ethernet o por un relay cercano, no directamente a internet. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

Los hogares Pro pueden conectar un termostato Nest o Ecobee para que la temperatura interior y la consigna aparezcan en el panel junto a las sondas del ático, el sótano ventilado y el taller, y para que las alertas de congelación incluyan ese contexto. Los usuarios se conectan desde Dashboard → Temperature; esta página es para quien administra el sitio y activa OAuth en una instalación propia o de producción.

Cuándo aparece el botón de conexión

La tarjeta del termostato permanece oculta hasta que la instalación tiene las credenciales de cliente del proveedor en los secretos del Worker. Una vez subidos los secretos, los administradores Pro ven Connect para cada proveedor configurado.

Nest (Google Device Access)

URI de redirección de producción (probeharbor.dev): cópiala tal cual en Google Cloud Console:

https://probeharbor.dev/api/integrations/nest/callback
  1. Crea un proyecto en la Device Access Console (pago único).
  2. Crea un cliente OAuth de Google Cloud (aplicación web) en el mismo proyecto de GCP vinculado a Device Access.
  3. Activa la Smart Device Management API en ese proyecto de GCP (OAuth puede funcionar sin ella, pero las lecturas en vivo devolverán 403 hasta que esté activada).
  4. Añade la URI de redirección anterior (instalación propia: https://YOUR_SITE/api/integrations/nest/callback).
  5. Define los secretos del Worker: NEST_CLIENT_ID, NEST_CLIENT_SECRET, NEST_PROJECT_ID (el UUID que aparece arriba en tu proyecto de Device Access, no el número de proyecto de Google Cloud).
  6. Añade las claves a .env y súbelas: pnpm secrets:push

Ecobee

URI de redirección de producción:

https://probeharbor.dev/api/integrations/ecobee/callback
  1. Regístrate en el portal para desarrolladores de Ecobee.
  2. Crea una app con la URI de redirección anterior (instalación propia: https://YOUR_SITE/api/integrations/ecobee/callback).
  3. Define el secreto del Worker: ECOBEE_CLIENT_ID (Ecobee no usa secreto de cliente).
  4. Añádelo a .env y ejecuta pnpm secrets:push.

Experiencia del usuario

Cada hogar guarda su propio token de actualización tras OAuth; no hay un token de termostato global compartido. Los administradores pueden desconectarlo desde el panel, y al hacerlo los tokens se revocan en la base de datos.

Consulta también: centro de integraciones, ProbeHarbor frente a Nest, frente a Ecobee.

Preguntas frecuentes

¿Qué termostatos se conectan con ProbeHarbor?
Nest (Google Device Access / SDM) cuando los secretos del Worker están configurados, y Ecobee cuando el registro de desarrolladores está abierto. Guía: probeharbor.dev/about/thermostat-oauth.

¿Hace falta Nest para las alertas de congelación?
No. Las alertas de congelación usan tus sondas. Nest/Ecobee añaden contexto interior de la vivienda en Overview cuando tu plan lo incluye (Pro).

¿Y si el registro de desarrolladores de Ecobee está cerrado?
Usa Home Assistant → ingesta → Indoor reference en Dashboard → Devices para que la temperatura ambiente de la casa se siga superponiendo en tu gráfico semanal.