Saltar al contenido

Ayudante Programación Home Assistant: Tu Guía 2026

28/09/2022

Actualizado el 02 de febrero de 2026

La automatización del hogar se basa en ejecutar acciones en el momento preciso, y para ello, una programación fiable es fundamental. En Home Assistant, el Ayudante de Programación (Schedule Helper) es la herramienta nativa y más directa para crear horarios semanales complejos que sirvan como disparadores o condiciones en tus automatizaciones. Si buscas una forma sencilla de decirle a tu casa qué hacer y cuándo, sin necesidad de código complejo, has llegado al lugar correcto. Esta guía definitiva de 2026 te mostrará cómo dominar el Home Assistant Schedule.

¿Qué es y para qué sirve el Ayudante de Programación?

Imagina que quieres que la calefacción se encienda solo por las tardes entre semana, que las luces del jardín se activen al anochecer y se apaguen a medianoche, o que el sistema de riego funcione 30 minutos al amanecer los lunes, miércoles y viernes. Gestionar todo esto con automatizaciones individuales basadas en tiempo puede volverse caótico.

El ayudante de programación centraliza toda esta lógica en una única entidad. Crea un «calendario» visual donde defines franjas horarias para cada día de la semana. Home Assistant se encarga del resto, generando una entidad que estará en estado on durante los periodos activos y off fuera de ellos. Luego, solo tienes que usar el estado de esta entidad en tus automatizaciones, simplificando enormemente la gestión de tu automatización del hogar.

Cómo Configurar Horarios en Home Assistant (Paso a Paso)

Existen dos métodos para configurar horarios: a través de la interfaz gráfica (la forma más sencilla y recomendada para el 99% de los casos) o mediante código YAML para quienes prefieren tener toda su configuración en ficheros.

Método Recomendado: Interfaz de Usuario (UI)

La forma preferida en 2026 para configurar horarios en Home Assistant es a través de su intuitiva interfaz. Sigue estos simples pasos:

  1. Navega a Ajustes > Dispositivos y Servicios en tu instancia de Home Assistant.
  2. Selecciona la pestaña superior de Ayudantes. Puedes encontrar una guía completa sobre ellos en nuestro artículo sobre Ayudantes de Home Assistant.
  3. Haz clic en el botón azul «+ Crear Ayudante» en la esquina inferior derecha.
  4. En la lista, busca y selecciona la opción «Programar».
  5. Asigna un nombre descriptivo (ej. «Horario Termostato Salón») y, si lo deseas, un icono.
  6. Configura tus franjas horarias. Puedes añadir múltiples periodos para un mismo día (ej. por la mañana y por la tarde). Haz clic en «Añadir» para crear más rangos.
  7. Una vez configurado, haz clic en «Crear». Tu nueva entidad schedule.horario_termostato_salon estará lista para ser usada.

Para poder agregar ayudantes, tu fichero configuration.yaml debe contener la línea default_config:, que viene incluida por defecto en todas las instalaciones nuevas de Home Assistant.

Método Alternativo: Configuración con YAML

Si prefieres gestionar tu configuración como código, puedes definir tus horarios directamente en el archivo configuration.yaml. Este método es ideal para backups avanzados o para replicar configuraciones rápidamente. La estructura es muy legible.

Aquí te muestro un ejemplo práctico de YAML Home Assistant para un horario de termostato:

# Ejemplo de configuración en configuration.yaml
schedule:
  thermostat_schedule:
    name: "Horario del Termostato Principal"
    monday:
      # Lunes por la tarde
      - from: "17:00:00"
        to: "21:00:00"
    tuesday:
      - from: "17:00:00"
        to: "21:00:00"
    wednesday:
      - from: "17:00:00"
        to: "21:00:00"
    thursday:
      - from: "17:00:00"
        to: "21:00:00"
    friday:
      - from: "17:00:00"
        to: "23:00:00"
    saturday:
      # Sábado por la mañana y tarde/noche
      - from: "07:00:00"
        to: "10:00:00"
      - from: "16:00:00"
        to: "23:00:00"
    sunday:
      # Domingo casi todo el día
      - from: "07:00:00"
        to: "21:00:00"

Tras añadir o modificar el código, recuerda recargar la configuración desde Herramientas para desarrolladores > YAML > Recargar Programaciones.

Ejemplos Prácticos de Automatización con Horarios

Crear el horario es solo el primer paso. La verdadera magia ocurre cuando lo usas en tus automatizaciones.

Caso de UsoEjemplo de Automatización
Iluminación ExteriorCrea un horario «Noche Jardín» de 19:00 a 00:00. La automatización se dispara cuando el estado de schedule.noche_jardin cambia a on y enciende las luces. Otro disparador para cuando cambia a off las apaga.
Riego AutomáticoUn horario «Riego Verano» activo de 06:00 a 06:30 los días de riego. La automatización se activa si schedule.riego_verano está en on y la previsión de lluvia es inferior al 20%.
Modo «No Molestar»Establece un horario «Descanso Nocturno» de 23:00 a 07:00. Usa este ayudante como condición para evitar que se envíen notificaciones no críticas durante la noche.
Aspirador RobotConfigura un horario «Limpieza Diaria» para las 10:00 de lunes a viernes. La automatización enviará el robot a limpiar solo si schedule.limpieza_diaria está en on y no hay nadie en casa.

Troubleshooting: Solución a Problemas Comunes

Aunque es una integración muy robusta, a veces pueden surgir problemas. Aquí te dejo las soluciones más habituales.

  • El horario no se activa cuando debería:
    • Zona Horaria: Verifica que la zona horaria de Home Assistant sea la correcta en Ajustes > Sistema > General. Un error aquí es la causa más común.
    • Logs del sistema: Revisa los registros en Ajustes > Sistema > Registros en busca de errores relacionados con la entidad schedule.
    • Disparador incorrecto: Asegúrate de que tu automatización se dispara con el estado correcto ('on') y no solo por un cambio de estado genérico.
  • Errores en la configuración YAML:
    • Indentación: YAML es muy estricto con los espacios. Un espacio de más o de menos puede invalidar toda la configuración. Usa un editor como Visual Studio Code con la extensión de Home Assistant para evitarlo.
    • Formato de hora: Asegúrate de usar el formato "HH:MM:SS" entre comillas.
    • Verificación: Antes de reiniciar, ve a Herramientas para desarrolladores > YAML y haz clic en «Verificar Configuración» para detectar errores de sintaxis.

Servicios del Ayudante de Programación

Esta integración ofrece un servicio principal muy útil, sobre todo si trabajas con YAML.

schedule.reload

Este servicio te permite recargar todas las configuraciones de horarios definidas en tu configuration.yaml sin necesidad de reiniciar Home Assistant por completo. Es perfecto para aplicar cambios de forma rápida mientras pruebas tu configuración.

Alternativas Avanzadas al Ayudante de Programación

Para la gran mayoría de necesidades, el ayudante nativo es más que suficiente. Sin embargo, si tus requerimientos de programación son extremadamente complejos y necesitas lógica condicional avanzada, existen alternativas más potentes que puedes instalar desde la tienda de Apps (anteriormente conocidos como Add-ons).

  • Node-RED: Si prefieres una programación visual basada en flujos, Node-RED es una herramienta increíblemente poderosa. Permite crear lógicas complejas, bucles y ramificaciones que van más allá de un simple horario on/off.
  • AppDaemon: Para los que se sienten cómodos programando, AppDaemon permite escribir automatizaciones y lógicas de programación directamente en Python. Ofrece una flexibilidad casi ilimitada, pero requiere conocimientos de programación.

Conclusión

En 2026, el Ayudante de Programación de Home Assistant se ha consolidado como la solución por defecto para gestionar cualquier tipo de horario en la automatización del hogar. Su simplicidad a través de la interfaz gráfica lo hace accesible para cualquier usuario, mientras que la opción de configuración por YAML ofrece la flexibilidad que los usuarios avanzados demandan.

Mi recomendación es empezar siempre con este ayudante. Es potente, fiable y está perfectamente integrado en el ecosistema. Solo si tus necesidades superan sus capacidades, deberías explorar herramientas más complejas como Node-RED. Con esta guía, ya tienes todo lo necesario para empezar a programar tu hogar inteligente de manera eficiente y ordenada.