Saltar al contenido principal

Integración domótica Planka, gratuita y de código abierto

Integración Planka para Gladys Assistant

Tableros kanban de Planka: tarjetas de hoy y atrasadas, movimientos, tarjetas desde una escena.

Ver en GitHubTodas las integraciones

Lleve los tableros kanban de su Planka a Gladys: las tarjetas que vencen hoy, las atrasadas, el próximo vencimiento y el número de tarjetas de cada lista de un tablero. Una escena reacciona cuando una tarjeta llega a una lista (Hecho, Por revisar…) o vence, otra añade «comprar pan» desde un botón o mueve una tarjeta desde una etiqueta NFC, un toque en el panel marca un vencimiento, y Gladys puede leer las tarjetas del día cada mañana.

Sus comentarios son bienvenidos. Esta integración se ha probado con un servidor Planka real (imagen Docker ghcr.io/plankanban/planka 2.2.1, octubre de 2026), aún no en el uso diario. Si algo no funciona como se describe, dígalo en el foro de Gladys o en las issues.

Qué necesita​

  • Gladys Assistant 5.1.0 o posterior.
  • Un Planka 2 autoalojado (probado con la 2.2.1), accesible desde Gladys. Planka 1.x no es compatible: su API es diferente.
  • Una de estas dos cosas, para un usuario de Planka miembro de los tableros que seguir:
    • una clave de API (recomendado): un administrador la crea en Planka, Administración → Usuarios → menú del usuario → Clave API → Crear clave API. Cópiela: Planka solo la muestra una vez. Funciona también con el inicio de sesión de dos factores y el inicio de sesión único;
    • o el usuario (o el correo electrónico) y la contraseña del usuario. Debe haber iniciado sesión una vez en la interfaz web, para aceptar las condiciones que Planka pide en el primer inicio de sesión, y no usar el inicio de sesión de dos factores.

La integración ve los tableros que ve este usuario y actúa en su nombre. Un usuario que solo es lector de un tablero puede seguirlo, pero no añadir ni mover sus tarjetas.

Configuración​

  1. En Gladys, Integraciones → instale Planka.
  2. En la pantalla Configuración, rellene:
    • Dirección: la dirección de Planka como en el navegador, por ejemplo http://192.168.1.20:3000, o https://kanban.example.org detrás de un proxy inverso (se conserva un prefijo como /planka);
    • Clave de API, o Usuario o correo electrónico y Contraseña. Cuando la clave de API está rellenada, es la que se usa.
  3. Opciones:
    • Tableros seguidos: nombres separados por comas (Casa, Compras), o el número de un tablero (el de su dirección). Vacío: todos los tableros del usuario, 20 como máximo;
    • Aceptar certificados autofirmados: para una dirección https:// con un certificado autofirmado, solo en su propio servidor;
    • Intervalo de actualización: de 1 a 10 minutos (5 por defecto). Los vencimientos y la medianoche se siguen siempre a tiempo, sea cual sea el intervalo;
    • Idioma de los nombres de funciones: los nombres dados a las funciones al añadir un dispositivo (francés por defecto) y los textos enviados a las escenas.
  4. Guarde y luego Probar la conexión: lee Planka e indica el número de tarjetas abiertas y de tableros seguidos.
  5. En la pestaña Descubrimiento, añada los dispositivos que quiera.

Dispositivos​

Planka tablero para cada tablero seguido, con estas funciones:

FunciónQué indica
Tarjetas abiertaslas tarjetas de las listas activas (no las de una lista cerrada como Hecho, ni las archivadas)
Tarjetas para hoytarjetas abiertas cuyo vencimiento cae hoy, pasado o no, sin marcar
Tarjetas atrasadastarjetas abiertas cuyo vencimiento ha pasado, sin marcar
una por listael número de tarjetas de cada una de las cinco primeras listas activas, con el nombre de la lista
Próximo vencimientola tarjeta con el vencimiento futuro más cercano, y su fecha; Ninguna si no hay

«Hoy» es el día en la zona horaria de Gladys. Una tarjeta con el vencimiento marcado, o en una lista cerrada (el tipo de lista «Hecho» de Planka), ya no vence. Los nombres de las funciones se fijan al añadir el dispositivo: una lista renombrada después conserva su nombre anterior en Gladys. Una lista nueva entre las cinco primeras hace que Gladys proponga actualizar el dispositivo en la pestaña Descubrimiento.

Panel​

El widget Tarjetas de hoy muestra dos mosaicos (para hoy, atrasadas), la lista de las tarjetas para esta noche, las atrasadas primero, con su hora, su lista y su tablero, y un botón para cada una de las cuatro más urgentes: un toque marca el vencimiento de la tarjeta en Planka. Elija un dispositivo de tablero en la configuración del widget para ver solo sus tarjetas; déjelo vacío para todos los tableros seguidos. Cuando nada vence, el widget lo dice e indica el próximo vencimiento.

Los contadores también pueden ir al panel como cualquier función de dispositivo.

Escenas​

Disparadores​

  • Tarjeta de Planka movida: una tarjeta llegó a otra lista de su tablero. Filtros: el tablero (un dispositivo de tablero), el nombre de la lista, exactamente como en Planka (Hecho). Información transmitida a las acciones: la tarjeta, su número, su tablero, su lista, la lista anterior, su vencimiento.
  • Tarjeta de Planka vencida: una tarjeta abierta alcanzó su vencimiento sin marcarlo.
  • Tarjeta de Planka atrasada: a medianoche, una tarjeta que vencía ese día sigue sin hacer. Una vez por tarjeta y vencimiento.

Filtros de los dos últimos: el tablero, el nombre de la tarjeta. Información transmitida a las acciones: la tarjeta, su número, su tablero, su lista, su vencimiento.

Un movimiento se ve en la lectura siguiente: dentro del intervalo de actualización. Una tarjeta creada, o traída de otro tablero, no es un movimiento. Una tarjeta hecha antes de su vencimiento no dispara nada, ni tampoco un vencimiento movido a mano antes de la lectura anterior. Un reinicio no dispara nada dos veces; un movimiento hecho mientras la integración estaba detenida se dispara al reiniciar, igual que un vencimiento de hace menos de una hora.

Acciones​

  • Añadir una tarjeta de Planka: un título; el tablero por su nombre (vacío: el primer tablero seguido); la lista por su nombre (vacío: su primera lista activa); un vencimiento opcional, en la hora de Gladys: 2026-10-24 18:00, 2026-10-24 (mediodía), o desde ahora +30m, +2h, +3d. La tarjeta va al final de la lista. Resultados: la tarjeta, su número, su tablero, su lista, su vencimiento.
  • Mover una tarjeta de Planka: la tarjeta por su nombre exacto (mayúsculas y acentos ignorados) o su número, la lista de destino por su nombre, y el tablero si dos tableros tienen una tarjeta con ese nombre. La tarjeta va al final de la lista; una tarjeta de una lista cerrada puede volver. Resultados: la tarjeta, su número, su tablero, su lista, la lista anterior.
  • Leer las tarjetas de Planka de hoy: las tarjetas para esta noche en una frase (3 tarjeta(s) para esta noche: …. 2 atrasada(s).), para todos los tableros seguidos o uno de ellos. Resultados: la frase, el número de tarjetas para esta noche y de tarjetas atrasadas. Envíe la frase en un mensaje, o haga que Gladys la diga.

Los campos aceptan variables de escena: {{triggerEvent.data.card}} mueve la tarjeta que disparó la escena.

Ideas de escenas​

  • A las 7:30, Leer las tarjetas de Planka de hoy y enviar la frase por Telegram.
  • Tarjeta de Planka movida a la lista Hecho del tablero Casa: enviar «bien hecho» a la familia, o apagar la luz de recordatorio.
  • Cuando la lavadora termina, Añadir una tarjeta de Planka Tender la ropa en Por hacer, con vencimiento +1h.
  • Una etiqueta NFC en los cubos de basura lanza Mover una tarjeta de Planka Sacar la basura a Hecho.

Solución de problemas​

  • «Planka no responde»: compruebe la dirección y el puerto desde la máquina de Gladys (la dirección abre Planka en un navegador).
  • «Clave de API, usuario o contraseña rechazados»: la clave se regeneró o se eliminó, o la contraseña cambió. Cree una clave nueva.
  • «Inicie sesión una vez en la interfaz web de Planka para aceptar sus condiciones»: inicie sesión una vez con este usuario en el navegador, acepte las condiciones y vuelva a Probar la conexión.
  • «Inicio de sesión de dos factores: use una clave de API»: un usuario con dos factores no puede iniciar sesión desde Gladys con contraseña.
  • «No hay ninguna API de Planka 2 en esta dirección»: la dirección responde, pero no con la API de Planka 2: compruebe el puerto, el prefijo o la versión de Planka.
  • «La dirección redirige»: introduzca la dirección https://.
  • «Este usuario no tiene este permiso»: el usuario solo es lector del tablero.
  • Falta un tablero: el usuario debe ser miembro del tablero (o gestionar su proyecto); un nombre escrito en Tableros seguidos que no corresponde a ningún tablero se ignora, y Probar la conexión lo indica. Más allá de 20 tableros, indique los que seguir.
  • «Varias tarjetas tienen este nombre»: indique el tablero o el número de la tarjeta.
  • Registros: LOG_LEVEL=debug en el contenedor muestra cada lectura.

Límites​

  • Planka se lee cada 1 a 10 minutos (y en cada vencimiento y a medianoche): un cambio en Planka aparece en Gladys dentro de ese plazo. No se usan los webhooks de Planka ni su conexión en directo.
  • Una solicitud para los proyectos, más una por tablero seguido, en cada lectura.
  • La integración añade tarjetas, las mueve y marca sus vencimientos; no las edita, no las elimina ni las asigna, y no lee sus tareas, etiquetas ni comentarios.
  • Solo las cinco primeras listas activas de un tablero tienen un contador.
  • Probada con Planka 2.2.1. Planka 1.x no es compatible.
  • Gladys no guarda ningún dato de Planka fuera de /data/planka-state.json (la hora de la última lectura y la lista de cada tarjeta, para que ningún evento se dispare dos veces).
  • Sin relación con Planka ni con PLANKA Software GmbH.

Parámetros de configuración​

Estos son los parámetros que Planka te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Su PlankasectionNoUn Planka 2 autoalojado. Indique una clave de API (creada por un administrador), o el usuario y la contraseña de un usuario que ya haya iniciado sesión una vez en la interfaz web.
DirecciónstringSíDirección de Planka, como en el navegador, con https:// para HTTPS y :puerto si no es el predeterminado.
Clave de APIsecretNoRecomendado. Administración, Usuarios, menú del usuario, clave de API. Vacío: se usan el usuario y la contraseña de abajo.
Usuario o correo electrónicostringNoSin clave de API: un usuario de Planka sin inicio de sesión de dos factores.
ContraseñasecretNo
OpcionessectionNo
Tableros seguidosstringNoNombres separados por comas. Vacío: todos los tableros del usuario (20 como máximo). Un dispositivo por tablero seguido.
Aceptar certificados autofirmadosbooleanNoPara una dirección https:// con certificado autofirmado. Márquelo solo para su propio servidor.
Intervalo de actualizaciónselectNoFrecuencia de lectura de Planka (una solicitud por tablero). Los vencimientos y la medianoche se siguen siempre a tiempo.
Idioma de los nombres de funcionesselectNoNombres dados a las funciones al añadir un dispositivo y textos enviados a las escenas.

Cómo instalar Planka en Gladys​

  1. En Gladys, abre Integraciones: Planka aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-planka:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-planka.

Planka 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​

Planka 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en