Credenciales de la API de Home Assistant

Para conectar tu Home Assistant a Botize necesitas tres datos: una URL pública de tu instalación, el puerto (opcional) y un token de acceso de larga duración. A continuación te mostramos cómo obtenerlos paso a paso. Si no tienes opción de exponer tu IP pública en casa, te recomendamos usar Nabu Casa (Home Assistant Cloud) para conseguir una URL accesible desde internet sin abrir puertos en tu router.

Opción recomendada: obtener una URL pública con Nabu Casa

1. 1

   Nabu Casa (Home Assistant Cloud) es el servicio oficial mantenido por los creadores de Home Assistant. Ofrece una URL pública con HTTPS para tu instalación sin necesidad de exponer tu IP ni abrir puertos. Es la opción ideal si estás en casa detrás de un router que no puedes configurar. Tiene un coste de suscripción (consulta el precio actual en https://www.nabucasa.com/pricing).

2. 2

   Si todavía no tienes cuenta de Home Assistant Cloud, créala desde tu Home Assistant en 'Ajustes' (Settings) > 'Home Assistant Cloud' y sigue el alta. Necesitarás verificar tu email.

3. 3

   Una vez con la cuenta activa, vuelve a 'Ajustes' (Settings) > 'Home Assistant Cloud'.

4. 4

   En la sección 'Acceso remoto' (Remote Control), activa el interruptor. La primera vez puede tardar hasta un minuto en preparar el certificado.

5. 5

   Verás una URL del tipo 'https://xxxxx.ui.nabu.casa'. Cópiala: ese será el valor del campo 'Home Assistant Public IP or URL' en Botize.

6. 6

   Con Nabu Casa el campo 'Port' en Botize debe quedarse vacío (la URL ya usa HTTPS estándar).

Alternativa: usar tu IP pública o tu URL propia

1. 1

   Si prefieres no usar Nabu Casa, necesitas que tu Home Assistant sea alcanzable desde internet. Esto implica tener una IP pública (o un dominio con DNS dinámico) y haber configurado un redireccionamiento de puertos en tu router hacia el equipo donde corre Home Assistant. Ten en cuenta que exponer tu instalación directamente requiere protegerla bien (HTTPS, contraseñas robustas y, si es posible, un proxy inverso).

2. 2

   Comprueba en qué puerto escucha tu Home Assistant. Por defecto es el 8123. Puedes verlo o cambiarlo en la configuración de la integración 'http' (https://www.home-assistant.io/integrations/http).

3. 3

   En el campo 'Home Assistant Public IP or URL' de Botize introduce tu IP pública o el dominio (por ejemplo 'http://mi-dominio.com' o 'https://mi-dominio.com'). No incluyas el puerto aquí.

4. 4

   En el campo 'Port' de Botize introduce el puerto en el que tu Home Assistant es accesible desde internet (por defecto 8123). Si tu URL ya apunta al puerto estándar (80 o 443) a través de un proxy inverso, deja este campo vacío.

Obtener el token de acceso de larga duración

1. 1

   Accede a tu Home Assistant desde un navegador con tu usuario habitual.

2. 2

   Haz clic en tu nombre de usuario (esquina inferior izquierda) o entra directamente en la URL '/profile' de tu instalación (por ejemplo 'https://xxxxx.ui.nabu.casa/profile').

3. 3

   Dentro del perfil, ve a la pestaña 'Seguridad' (en versiones recientes) o desplázate hasta el final de la página.

4. 4

   Localiza la sección 'Tokens de acceso de larga duración' ('Long-Lived Access Tokens') y pulsa el botón 'Crear token' ('Create Token').

5. 5

   Asigna un nombre descriptivo, por ejemplo 'Botize', y confirma.

6. 6

   Home Assistant te mostrará el token UNA SOLA VEZ. Cópialo entero yguárdalo en un lugar seguro: si lo cierras sin copiarlo, no podrás volver a verlo y tendrás que generar uno nuevo. El token tiene una validez de 10 años.

Conectar tu cuenta en Botize

1. 1

   En el campo 'Home Assistant Public IP or URL' pega la URL obtenida (la de Nabu Casa o tu IP/dominio público).

2. 2

   En el campo 'Port' indica el puerto si lo necesitas (por defecto 8123 para acceso por IP local). Déjalo vacío si usas Nabu Casa o si tu URL ya apunta a 80/443 vía proxy inverso.

3. 3

   En el campo 'Token' pega el token de larga duración que generaste en el paso anterior.

4. 4

   Pulsa 'Autorizar' para finalizar la conexión. Botize hará una llamada de prueba a tu Home Assistant; si los datos son correctos, la cuenta quedará vinculada.