Esta guía explica cómo añadir altavoces Sonos a Home Assistant, controlarlos desde un panel y utilizarlos para avisos de voz. Parte de la guía original para Home Assistant 2025.12.2; los requisitos de red se han contrastado con la documentación actual de Home Assistant y Sonos.
Preparación
Configure primero el altavoz en la aplicación Sonos y compruebe que reproduce música. Home Assistant y Sonos deben poder comunicarse por la red local. En la aplicación Sonos, active UPnP en « Cuenta » → « Privacidad y seguridad » → « UPnP ». La ruta puede cambiar ligeramente según la versión.
Si Home Assistant se ejecuta en Docker o en una máquina virtual, asegúrese de que el descubrimiento local funciona a través de la red. Cuando haya subredes o cortafuegos, compruebe la conectividad necesaria antes de cambiar el modo de red.
1. Añadir Sonos
Abra « Ajustes » → « Dispositivos y servicios ». Si Sonos aparece en « Descubierto », pulse « Configurar », confirme y asigne los altavoces a sus habitaciones.
Si no aparece, pulse « Añadir integración » y busque « Sonos ». Si se solicita un host, introduzca la dirección IP de uno de los altavoces. Puede localizarla en el router o en la información del sistema de la aplicación Sonos. Termine la configuración y revise los dispositivos detectados.
2. Control desde el panel
Edite el panel deseado, añada una tarjeta de control multimedia y seleccione la entidad Sonos, por ejemplo media_player.salon. Guarde la tarjeta. Podrá controlar la reproducción, la pausa y el volumen. Otras funciones, como la agrupación, dependen del modelo y de la integración.
3. Automatizaciones y voz
Para iniciar música al llegar a casa, cree una automatización que se active cuando una entidad de persona cambie a « En casa ». Como acción, seleccione « Reproducir contenido multimedia », elija el altavoz Sonos e indique una URL a la que el propio altavoz pueda acceder.
Para los avisos hablados, configure primero una integración de texto a voz. En « Herramientas de desarrollo » → « Acciones », seleccione tts.speak, escriba el mensaje y elija el reproductor Sonos. La dirección local de Home Assistant debe ser accesible para el altavoz. En equipos compatibles, la opción Sonos announce permite superponer un aviso a la música y recuperar después su volumen.
Solución de problemas
Si no se detecta Sonos, revise la red local, UPnP y el descubrimiento. Si la entidad aparece como « No disponible », compruebe alimentación y conexión. Para recibir cambios de estado con rapidez, los altavoces deben poder conectarse a Home Assistant en el puerto TCP 1400; para voz y anuncios, Home Assistant debe poder conectarse a los altavoces en el puerto TCP 1443. Un cortafuegos puede impedirlo.
Si dispone de varias interfaces o de una red compleja, consulte las opciones avanzadas de la documentación oficial de Sonos para Home Assistant.
