Integración domótica Gotify, gratuita y de código abierto
Mensajes de Gladys y notificaciones de escenas en su móvil a través de su servidor Gotify.
Publicado por guim31
- Mensajería
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Reciba los mensajes de Gladys en su móvil a través de su propio servidor Gotify, el servidor de notificaciones push autoalojado (aplicación Android, cliente web): los mensajes de sus escenas, las respuestas de Gladys y sus mensajes del sistema, además de notificaciones con título, prioridad, enlace e imagen desde sus escenas. Todo se queda en su red local.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha probado con un servidor Gotify 3.1.1 real, pero ni con las aplicaciones Gotify para móvil ni en una instalación real de Gladys. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Un servidor Gotify al que Gladys pueda acceder en su red, por ejemplo la
imagen Docker
gotify/server(probado con Gotify 3.1.1). - La aplicación Gotify en los móviles que reciben las notificaciones (Android, desde F-Droid o Google Play), o la interfaz web de Gotify abierta en un navegador. Gotify no tiene aplicación oficial para iOS.
- Un token de aplicación por cada cuenta Gotify que recibe mensajes. En la interfaz web de Gotify, abra la pestaña Apps, haga clic en Create application, póngale un nombre (Gladys, por ejemplo) y copie su token. Un token de aplicación envía mensajes; un token de cliente (pestaña Clients) los lee y no sirve aquí.
Configuración
Instale la integración desde Integraciones → Instalar desde GitHub con la
dirección https://github.com/guim31/gladys-gotify y complete su pantalla de
configuración:
- Dirección del servidor Gotify: la dirección con la que abre Gotify,
puerto incluido, por ejemplo
http://192.168.1.10:8080. También sirve un Gotify publicado bajo una ruta detrás de un proxy inverso (https://example.org/gotify). - Token de aplicación compartido: lo usan la acción de escena, la prueba y los usuarios que no indican su propio token. Opcional si cada usuario completa «Mi cuenta».
- Prioridad predeterminada: la prioridad de los mensajes que no fijan ninguna. Predeterminada de la aplicación Gotify la deja en manos de la aplicación (su prioridad predeterminada se ajusta en la interfaz web de Gotify).
- Dar formato Markdown a los mensajes (activado por defecto): Gladys escribe negritas, listas y enlaces en Markdown, y las aplicaciones Gotify los muestran.
- Aceptar un certificado autofirmado: solo para una dirección
https://cuyo certificado haya creado usted mismo. Si no, déjelo desactivado. - Idioma de los textos de la integración: la nota añadida a un mensaje cuya imagen no ha podido enviarse, y los errores de la acción de escena.
Después haga clic en Enviar una notificación de prueba: la integración comprueba el servidor y envía una notificación con el token compartido.
Mi cuenta: cada usuario de Gladys, administrador o no, decide en el bloque «Mi cuenta» de la página de la integración si recibe los mensajes que Gladys le envía:
- Su token de aplicación: el token de una aplicación de SU cuenta Gotify, para que los mensajes lleguen solo a su móvil. Déjelo vacío para usar el token compartido.
- Prioridad de sus mensajes: su propia prioridad, o Predeterminada de la integración.
Guarde al menos uno de los dos: un usuario que no ha guardado nada no recibe nada. Eliminar mis valores detiene los mensajes.
Lo que envía Gladys
Cada mensaje que Gladys envía a un usuario pasa por Gotify cuando ese usuario ha guardado «Mi cuenta»: la acción de escena Enviar mensaje, las respuestas de Gladys y sus mensajes del sistema (Gladys actualizada, copia de seguridad fallida, batería baja…). En la acción Enviar mensaje, las versiones recientes de Gladys permiten elegir el canal: todos los canales, solo Gotify o solo Gladys.
- El texto se envía en Markdown, sin título: Gotify muestra en su lugar el nombre de la aplicación.
- Gotify no admite archivos adjuntos: la imagen de Enviar una imagen de cámara se omite, y una línea bajo el texto lo indica.
- La prioridad es la de «Mi cuenta» o, si no, la prioridad predeterminada.
Lo que hace la prioridad en la aplicación Android de Gotify:
| Prioridad | Notificación |
|---|---|
| 0 | mínima: silenciosa, sin icono en la barra de estado |
| 1 a 3 | baja: silenciosa |
| 4 a 7 | normal: con sonido |
| 8 a 10 | alta: con sonido y un aviso emergente sobre otras apps |
El cliente web y las demás aplicaciones pueden mostrar las prioridades de otra manera.
Panel de control
El widget Gotify muestra:
- si el servidor responde, y su versión;
- las notificaciones enviadas hoy, y los fallos con el último motivo;
- las últimas notificaciones enviadas por escenas (título, fecha, prioridad o «No enviada»). Al tocar se abre el texto completo. Los mensajes que Gladys envía a un solo usuario se cuentan pero nunca se listan: el panel lo ve todo el hogar;
- un botón Enviar una prueba, que hace lo mismo que la prueba de la configuración.
Escenas
Desencadenantes
- Servidor Gotify sin conexión: el servidor ha dejado de responder. Debe fallar dos comprobaciones con 30 segundos de diferencia (se hace una comprobación cada 5 minutos, y justo después de un envío fallido). Variable: el error.
- Servidor Gotify de nuevo en línea: el servidor vuelve a responder tras estar sin conexión. Variable: la versión de Gotify.
- Notificación Gotify no enviada: no se ha podido enviar un mensaje. Filtros: el motivo (servidor inaccesible, token ausente o rechazado, configuración incompleta, mensaje rechazado) y quién lo envió (un mensaje de Gladys o la acción de escena Gotify). Variables: motivo, origen, error. Para evitar bucles, se activa como máximo una vez por motivo cada 15 minutos.
El primer estado conocido tras la instalación, o tras cambiar la dirección, no se anuncia: solo un cambio.
Acciones
Enviar una notificación Gotify, con el token compartido:
- Título (opcional): si no, el nombre de la aplicación.
- Mensaje (obligatorio): en Markdown cuando la opción está activada. Las variables de escena funcionan aquí, como en todos los campos.
- Prioridad: una de la lista, o Predeterminada de la integración.
- Enlace al tocar (opcional): una dirección
http://ohttps://que el móvil abre al tocar la notificación. - Dirección de una imagen (Android) (opcional): una imagen
https://mostrada en la notificación desplegada de la aplicación Android. Su móvil la descarga: debe ser accesible desde el móvil, no solo desde Gladys.
La acción entrega tres valores a las acciones siguientes de la escena:
Notificación enviada (sí / no), Número del mensaje Gotify y Error
(vacío si se ha enviado). Un campo incorrecto (un mensaje vacío, un enlace que
no es http(s)) hace fallar la acción, y el registro de la escena indica el
motivo.
Ideas de escenas
- Alarma: cuando salta la alarma, Enviar una notificación Gotify con el título «Alarma», prioridad 8 y un enlace a la página de su cámara.
- Plan B: con Notificación Gotify no enviada y el motivo «Servidor inaccesible», envíe el mensaje por otro canal (SMS, correo electrónico). No responda con otra notificación Gotify.
- Vigilar el servidor: con Servidor Gotify sin conexión, ponga una lámpara en rojo; con Servidor Gotify de nuevo en línea, apáguela.
Solución de problemas
La pantalla de configuración muestra el estado del servidor. Los mensajes:
- el servidor Gotify no responde: compruebe la dirección y el puerto, y que
el contenedor de Gotify esté en marcha. Gladys ejecuta la integración en su
propia red Docker:
localhostes la propia integración, use la dirección IP de la máquina. - certificado rechazado: marque Aceptar un certificado autofirmado, o
use la dirección
http://en su red local. - la dirección redirige: Gotify ha respondido con una redirección,
normalmente de
http://ahttps://. Introduzca la direcciónhttps://. - no hay ningún servidor Gotify en esta dirección: ahí responde otro servicio.
- Gotify ha rechazado el token de aplicación: el token es incorrecto, o la aplicación se ha eliminado en Gotify.
- es un token de cliente: copie el token de la pestaña Apps, no de la pestaña Clients.
- ningún token de aplicación: ni «Mi cuenta» ni la configuración tienen uno.
¿Un usuario no recibe nada? Compruebe que ha guardado «Mi cuenta» y que la acción Enviar mensaje de la escena no envía solo a otro canal. Los registros de la integración (Integraciones → Gotify → Registros) dan los detalles; nunca muestran un token.
Limitaciones
- Solo envío: Gotify no tiene respuestas. No puede hablar con Gladys desde Gotify.
- Ni imágenes ni archivos en los mensajes: Gotify solo transporta texto. La acción de escena puede mostrar una imagen desde una dirección (solo Android).
- Los mensajes de Gladys no tienen título propio.
- Probada con un servidor Gotify 3.1.1 real, pero ni con las aplicaciones para móvil ni en una instalación real de Gladys.
- Gotify no limita el número de mensajes; su móvil puede agrupar o silenciar una avalancha de notificaciones.
Esta integración no está afiliada al proyecto Gotify.
Parámetros de configuración
Estos son los parámetros que Gotify te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar su servidor Gotify | section | No | En la interfaz web de Gotify, abra la pestaña Apps y cree una aplicación (llámela Gladys, por ejemplo) y pegue su token a continuación. Cada usuario de Gladys también puede indicar su propio token en el bloque «Mi cuenta». |
| Dirección del servidor Gotify | string | Sí | La dirección con la que abre Gotify, puerto incluido. |
| Token de aplicación compartido | secret | No | Lo usan la acción de escena, la prueba y los usuarios que no indican su propio token. |
| Prioridad predeterminada | select | No | En la aplicación Android de Gotify: por debajo de 1 silenciosa y discreta, de 1 a 3 silenciosa, de 4 a 7 con sonido, 8 o más con aviso emergente. |
| Dar formato Markdown a los mensajes | boolean | No | Gladys escribe negritas, listas y enlaces en Markdown: las aplicaciones Gotify los muestran. |
| Aceptar un certificado autofirmado | boolean | No | Solo para una dirección https:// cuyo certificado haya creado usted mismo. |
| Idioma de los textos de la integración | select | No | Para las notas añadidas a los mensajes y los errores de la acción de escena. |
Cómo instalar Gotify en Gladys
- En Gladys, abre Integraciones: Gotify 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/guim31/gladys-gotify:1.0.1), 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/guim31/gladys-gotify.
Gotify requiere Gladys >=5.1.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
Gotify 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 guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación