Integración domótica Bluesky, gratuita y de código abierto
Hable con Gladys por mensajes directos de Bluesky, publique desde escenas, reaccione a menciones.
Publicado por William-De71
- Mensajería
- Versión 0.1.0
- Requiere Gladys >=5.3.0
- ★ 0
Integración no oficial, sin relación con Bluesky Social PBC.
Presentación
La integración Bluesky conecta Gladys con una cuenta de Bluesky, idealmente una cuenta de la casa (p. ej. casa-gladys.bsky.social):
- cada usuario de Gladys vincula una vez su propia cuenta de Bluesky y luego habla con Gladys por mensajes directos a la cuenta de la casa; las notificaciones de Gladys también llegan allí;
- sus escenas reaccionan a menciones, respuestas, citas, nuevos seguidores, me gusta, republicaciones y mensajes directos, y pueden publicar un post, enviar un mensaje directo o eliminar un post;
- tres widgets del panel muestran la cuenta, las últimas notificaciones y los últimos mensajes directos.
Todo pasa por los servidores de Bluesky (transporte en la nube): la integración consulta Bluesky con regularidad (cada 10 a 60 segundos para los mensajes directos, cada 30 segundos para las notificaciones). Gladys no necesita URL pública ni Gladys Plus. Los posts son públicos; los mensajes directos quedan entre las cuentas.
Requisitos
- Gladys Assistant 5.3.0 o posterior.
- Una cuenta de Bluesky (en bsky.social o en un PDS autoalojado) y una contraseña de aplicación de esta cuenta con acceso a los mensajes directos.
- Acceso a Internet desde Gladys.
Crear la contraseña de aplicación
- Inicie sesión en la app de Bluesky con la cuenta de la casa.
- Abra Ajustes → Privacidad y seguridad → Contraseñas de aplicación → Añadir contraseña de aplicación.
- Llámela
Gladysy marque Permitir el acceso a tus mensajes directos: sin ello, Gladys no puede leer ni enviar mensajes directos. - Copie la contraseña (solo se muestra una vez).
- En los ajustes de chat de la cuenta (Chat → ⚙, «Permitir mensajes nuevos de»), elija Todos para que su familia pueda enviar un código de vinculación, o siga sus cuentas.
No introduzca nunca la contraseña principal de la cuenta: una cuenta protegida por un código enviado por correo la rechaza, y una contraseña de aplicación se puede revocar sola en cualquier momento.
Configuración
En Gladys, abra Integraciones → Bluesky → Configuración:
| Campo | Significado |
|---|---|
| Alias o correo de la cuenta | nombre.bsky.social (sin la @), su propio dominio o la dirección de correo de la cuenta |
| Contraseña de aplicación | la contraseña de aplicación creada arriba (guardada cifrada) |
| Servidor (avanzado) | déjelo vacío para bsky.social; para un PDS autoalojado, su dirección https:// |
| Leer los mensajes directos | desactivado: nadie puede hablar con Gladys ni vincular una cuenta; Gladys aún puede enviar |
| Enviar los mensajes directos a Gladys | desactivado: los mensajes de los usuarios vinculados solo llegan a las escenas |
| Comprobar los mensajes directos cada | 10, 15 (por defecto), 30 o 60 segundos |
| Vigilar las notificaciones | menciones, respuestas, citas, seguidores, me gusta y republicaciones para escenas y widgets |
| Idioma de la integración | la respuesta a un código de vinculación y el idioma por defecto de los posts de las escenas |
Pulse Probar la conexión: muestra la cuenta, sus seguidores, si los mensajes directos son legibles y el número de usuarios vinculados. La integración inicia sesión una vez y conserva su sesión: Bluesky limita los inicios de sesión a 300 al día.
Vincular su cuenta de Bluesky
- En la configuración de la integración, Vincular mi cuenta → Generar un código de vinculación.
- En la app de Bluesky, con su propia cuenta, envíe el código por mensaje directo a la cuenta de la casa en un plazo de 15 minutos.
- La cuenta de la casa responde que su cuenta está vinculada.
Para recibir los avisos de Gladys, su propia cuenta debe aceptar los mensajes de la cuenta de la casa (sígala o permita los mensajes de todos).
Uso
Hablar con Gladys
Escriba a la cuenta de la casa por mensaje directo: Gladys responde en la misma conversación, como con la integración de Telegram. Las respuestas largas se dividen en varios mensajes. Los mensajes directos de Bluesky no admiten imágenes: una imagen de cámara enviada por Gladys llega como un breve aviso.
Los mensajes de cuentas no vinculadas nunca llegan a Gladys ni reciben respuesta: siguen sin leer en la app para una persona y solo activan el disparador de escena Mensaje de cuenta no vinculada.
Widgets del panel
Ilustración generada, no una captura de pantalla: cuentas y mensajes inventados.
- Cuenta de Bluesky: seguidores, seguidos, posts, notificaciones sin leer, actividad del día, conexión y un botón Comprobar.
- Notificaciones Bluesky: las últimas 8 notificaciones con enlace a bsky.app; con Mostrar me gusta y republicaciones desactivado solo quedan menciones, respuestas, citas y seguidores.
- Mensajes Bluesky: mensajes recibidos y enviados hoy y los últimos 8 mensajes; su texto solo con Mostrar el texto de los mensajes (desactivado por defecto, ya que un panel puede compartirse).
Escenas
| Disparador | Cuándo |
|---|---|
| Mencionado en Bluesky | alguien menciona la cuenta en un post |
| Respuesta de Bluesky recibida | alguien responde a un post de la cuenta |
| Post de Bluesky citado | alguien cita un post de la cuenta |
| Nuevo seguidor de Bluesky | alguien empieza a seguir la cuenta |
| Me gusta de Bluesky recibido | a alguien le gusta un post de la cuenta |
| Republicación de Bluesky recibida | alguien republica un post de la cuenta |
| Mensaje de Bluesky recibido | un usuario vinculado envía un mensaje directo |
| Mensaje de cuenta no vinculada | otra cuenta envía un mensaje directo (nunca llega a Gladys) |
| Mensaje de Bluesky no enviado | un mensaje de Gladys no pudo entregarse (una vez por usuario) |
La primera lectura tras el inicio sirve de referencia: lo que ya estaba no activa nada. Las acciones son Publicar un post de Bluesky (texto, idioma, respuesta a un post, URL de imagen opcional y su descripción), Enviar un mensaje directo de Bluesky y Eliminar un post de Bluesky. El mismo post en menos de un minuto se publica una vez, y 30 posts por hora como máximo.
Ejemplos:
- Mencionado en Bluesky → Publicar un post de Bluesky con Responder a
{{triggerEvent.data.post_uri}}. - Cada noche → Publicar un post de Bluesky con la producción solar del día.
- Mensaje de cuenta no vinculada → una notificación en su teléfono con
{{triggerEvent.data.sender_handle}}.
Solución de problemas
- «Bluesky rechaza el identificador o la contraseña de aplicación»: compruebe el alias (sin la @) y cree una nueva contraseña de aplicación. Una contraseña rechazada no se reintenta sola: guarde de nuevo la configuración o pulse Probar la conexión.
- «Bluesky pide un código enviado por correo»: se introdujo la contraseña principal; use una contraseña de aplicación.
- «La contraseña de aplicación no permite mensajes directos»: cree una nueva contraseña de aplicación marcando Permitir el acceso a tus mensajes directos.
- Un usuario no recibe nada: su cuenta debe aceptar los mensajes de la cuenta de la casa; el disparador Mensaje de Bluesky no enviado indica la causa.
- El código de vinculación se rechaza: caduca a los 15 minutos; genere uno nuevo.
- «Bluesky pide esperar»: demasiadas solicitudes; la integración espera el tiempo que indica Bluesky.
- Informe de un problema con las versiones de Gladys y de la integración, el mensaje de Probar la conexión y los registros (
DEBUG=gladys-integration-sdk), nunca con la contraseña de aplicación: https://github.com/William-De71/gladys-bluesky/issues
Parámetros de configuración
Estos son los parámetros que Bluesky te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cuenta de Bluesky | section | No | Integración no oficial, sin relación con Bluesky Social PBC. Gladys usa una cuenta de Bluesky: idealmente una cuenta de la casa (p. ej. casa-gladys.bsky.social), ya que todos los que hablan con Gladys le escriben. 1. En la app de Bluesky, con esta cuenta, abra Ajustes → Privacidad y seguridad → Contraseñas de aplicación → Añadir contraseña de aplicación. 2. Llámela Gladys y marque «Permitir el acceso a tus mensajes directos» (sin ello, Gladys no puede leer ni enviar mensajes directos). 3. Copie la contraseña que se muestra una sola vez, péguela abajo con el alias de la cuenta y guarde. No introduzca nunca la contraseña principal de la cuenta. |
| Alias o correo de la cuenta | string | Sí | El alias sin la @ (nombre.bsky.social, o su propio dominio), o la dirección de correo de la cuenta. |
| Contraseña de aplicación | secret | Sí | Creada en Ajustes → Privacidad y seguridad → Contraseñas de aplicación, con acceso a los mensajes directos. Se guarda cifrada y no se vuelve a mostrar. |
| Servidor (avanzado) | string | No | Déjelo vacío para una cuenta creada en bsky.social. Para un PDS autoalojado, su dirección https://. |
| Hablar con Gladys | section | No | Cada usuario vincula una vez su propia cuenta de Bluesky: «Vincular mi cuenta» más abajo → «Generar un código de vinculación» y envía el código por mensaje directo a la cuenta de la casa. Después, todo lo que le escriba llega a Gladys, que responde allí. La cuenta de la casa debe aceptar sus mensajes (Chat → ⚙ ajustes → Permitir mensajes nuevos de: Todos, o seguirle), y él debe aceptar los de la casa para recibir los avisos de Gladys. Los mensajes de cuentas no vinculadas nunca llegan a Gladys: solo activan el disparador de escena previsto para ellos. |
| Leer los mensajes directos | boolean | No | Desactivado: nadie puede hablar con Gladys ni vincular una cuenta; Gladys aún puede enviar mensajes y avisos. |
| Enviar los mensajes directos a Gladys | boolean | No | Desactivado: los mensajes de los usuarios vinculados solo llegan a las escenas, Gladys no los responde. |
| Comprobar los mensajes directos cada | select | No | Bluesky no envía nada a un servidor doméstico: la integración pregunta con regularidad. Las notificaciones se leen cada 30 s (60 s con la opción de 60 s). |
| Vigilar las notificaciones | boolean | No | Menciones, respuestas, citas, nuevos seguidores, me gusta y republicaciones: los disparadores de escena y los widgets. Siguen sin leer en la app de Bluesky. |
| Idioma de la integración | select | No | Idioma de los pocos textos que la cuenta escribe por sí misma (respuesta a un código de vinculación) e idioma por defecto de los posts publicados por las escenas. |
Cómo instalar Bluesky en Gladys
- En Gladys, abre Integraciones: Bluesky aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/william-de71/gladys-bluesky:0.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/William-De71/gladys-bluesky.
Bluesky requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Bluesky es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene William-De71, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación