Heladera Samsung → SmartThings → Home Assistant

Investigado el 29-sep-2026 (pedido delegado 50a075bb). El HA local no se tocó.

Estado de hoy (verificado)

• HA corre en la MacBook Pro, versión 2026.9.2, en http://127.0.0.1:8123 (responde 200).

Config en ~/homeassistant/config. HACS está instalado.

• No hay integración SmartThings cargada (sólo onvif, sonoff, samsungtv, generic, etc.).
• external_url e internal_url están vacías. Con la integración nueva no hace falta

(ver abajo).

• No sabemos si la heladera ya está dada de alta en la app SmartThings: se le preguntó a Gabriel

el 29-sep y todavía no contestó.

Qué hay que pedirle a Gabriel (en concreto)

No hace falta ningún token ni link. La integración oficial usa desde 2025.3 un login OAuth con

la cuenta Samsung: ya no existe el Personal Access Token (Samsung lo discontinuó; los que se crean

ahora vencen a las 24 h), y tampoco se cargan client ID ni client secret, porque los pone Home

Assistant.

Lo que se le pide:

1. Que la heladera esté en su app SmartThings, con la cuenta Samsung busso.gabriel@gmail.com

(es la que tiene; el 29-sep 07:38 entró desde el iPhone según el mail de Samsung). Si no está:

app SmartThings → «+» → Agregar dispositivo → Heladera, con la heladera en la red Palta

(2,4 GHz). Tiene que verse y responder en la app antes de seguir.

1. Cinco minutos frente a la MacBook Pro (o que nos pase la clave de la cuenta Samsung y el

código 2FA en el momento) para hacer el login OAuth: el navegador abre la página de Samsung,

él entra con su cuenta y toca Permitir. Ese permiso es lo único que "se pide": autoriza a

Home Assistant a leer y controlar sus dispositivos (r:devices, x:devices, r:locations,

r:scenes, x:scenes y afines; la pantalla los muestra juntos, se aceptan todos).

1. Decidir lo de la suscripción (ver abajo): desde octubre 2026 Samsung cobra el acceso

a la API.

⚠️ Desde octubre 2026 la API de SmartThings es paga

Samsung anunció el 23-jun-2026 que el acceso gratis a la API se termina en octubre 2026:

para usarla desde Home Assistant hace falta el Personal Plan de USD 4,99 por mes (lo cobra

Samsung, no Nabu Casa). La doc de Home Assistant lo dice textual. Samsung no publicó todavía los

límites de cada plan ni el link exacto para suscribirse; el blog manda a "completar un formulario".

O sea: si se integra hoy, anda gratis unos días y en octubre deja de andar sin la suscripción.

Antes de hacerlo, que Gabriel decida si paga los USD 5 por mes.

Alternativa sin pagar: no hay. Las heladeras Samsung Family Hub / Bespoke no tienen API local

documentada; todo pasa por la nube de SmartThings.

Paso a paso (cuando Gabriel dé el OK)

1. Confirmar que la heladera aparece y responde en la app SmartThings (paso 1 de arriba).
2. En la MacBook Pro, abrir http://127.0.0.1:8123 → Configuración → Dispositivos y servicios →

Agregar integración → SmartThings.

1. HA abre el login de Samsung (pasa por my.home-assistant.io/redirect/oauth). Si el redirect

pide la URL de la instancia, poner http://127.0.0.1:8123 (tiene que hacerse desde un

navegador en esa misma Mac, porque HA escucha en localhost).

1. Gabriel entra con busso.gabriel@gmail.com, confirma el 2FA y toca Permitir.
2. Elegir la ubicación (location) de SmartThings donde está la heladera. HA crea los dispositivos.
3. Los eventos llegan por SSE (HA se conecta a SmartThings): **no hace falta abrir puertos,

external URL ni Nabu Casa**.

1. Revisar las entidades de la heladera y, si se quiere, sumarlas a plant-casa.

Qué se puede ver y controlar de la heladera

Según la lista de capacidades de la integración (depende del modelo):

• Temperatura de heladera y freezer (sensores) y temperatura objetivo (entidad número,

thermostatCoolingSetpoint de cada compartimento).

• Power Cool y Power Freeze (switches, samsungce.powerCool / samsungce.powerFreeze).
• Puerta abierta/cerrada (sensor de contacto), en los modelos que lo exponen.
• Consumo de energía, si el modelo lo informa.
• Lo que sólo existe en la app (cámaras internas del Family Hub, fábrica de hielo en algunos

modelos, pantalla) puede no aparecer: la doc avisa que no todas las funciones salen por la API.

Falta el modelo exacto de la heladera para saber cuáles tiene (está en la etiqueta interna o en

la app: dispositivo → ⋮ → Información).

Fuentes

• Doc oficial HA: https://www.home-assistant.io/integrations/smartthings/
• Anuncio SmartThings (OAuth, sin PAT, sin puertos, eventos SSE):

https://community.smartthings.com/t/new-integration-between-home-assistant-and-smartthings/296251

• Blog SmartThings sobre la API paga (23-jun-2026):

https://blog.smartthings.com/smartthings-updates/a-new-enhanced-smartthings-api-experience/

• How-To Geek sobre el impacto en Home Assistant:

https://www.howtogeek.com/samsung-smartthings-api-price-for-access/

🔗 Conexiones Neuronales

• Eje: desarrollo-de-capacidades
• Eje: equipo-rrhh|Equipo · Personas & RR.HH.
• Eje: elevar-conciencia

Datos/casa-heladera-samsung-smartthings-home-assistant