Integración domótica Agora Famille, gratuita y de código abierto
Comedor, actividades extraescolares, facturas y mensajes del portal Agora Famille.
Publicado por prohand
- Dispositivos
- Versión 2.0.1
- Requiere Gladys >=5.3.0
- ★ 0
Esta integración conecta Gladys con el portal familiar Agora Famille (editado por Agora Plus) de su municipio francés: comedor escolar, actividades antes y después de clase, centros de ocio, facturas y mensajes del ayuntamiento.
Lee el portal como lo haría su navegador, con su propia cuenta, y le ofrece en Gladys:
- un dispositivo por niño: lo reservado hoy y mañana, y si come en el comedor;
- un dispositivo cuenta familiar: el saldo pendiente, la próxima factura, el último mensaje;
- disparadores de escena (nueva factura, factura a punto de vencer, nuevo mensaje, reserva aceptada o rechazada);
- acciones de escena de lectura (comprobar un día, volver a leer el portal);
- un widget del panel.
Antes de empezar
- Se necesita Gladys 5.3 o posterior.
- Necesita una cuenta activa en el portal Agora Famille de su municipio: el correo y la contraseña con los que inicia sesión.
- La integración es de tipo cloud: necesita internet para llegar al portal.
Configuración
En Gladys: Integraciones → Agora Famille → Configuración.
| Campo | Qué poner |
|---|---|
| Dirección del portal | La dirección de su portal tal como la muestra su navegador, p. ej. https://portalssl.agoraplus.fr/miciudad/pck_home.home_view#/. Basta también con el nombre del municipio (miciudad). |
| Usuario (correo) | El correo de su cuenta familiar. |
| Contraseña | La contraseña del portal. Gladys la guarda como secreto y nunca aparece en los registros. |
| Intervalo de lectura (min) | Cada cuánto se lee el portal (60 min por defecto, 15 min como mínimo). |
| Días de planificación seguidos | Cuántos días por adelantado se leen y vigilan (14 por defecto). |
| Aviso de factura (días) | El disparador «factura a punto de vencer» se activa estos días antes del vencimiento (3 por defecto, 0 lo desactiva). |
| Facturas transmitidas al Trésor public | Números de las facturas que el municipio transmitió al Trésor public, separados por comas (p. ej. 164513). Vea más abajo. |
| Registros detallados | Registra cada petición al portal, para diagnosticar. Nunca la contraseña. |
Pulse después Probar la conexión: la respuesta indica sus hijos, el número de días de planificación leídos, las facturas por pagar y los mensajes sin leer. Si falla, dice qué paso falló (inicio de sesión, hijos, planificación, facturas, mensajes).
Abra luego la pestaña Descubrir para crear los dispositivos.
Dispositivos
Agora Famille (la cuenta)
| Función | Contenido |
|---|---|
| Balance due | Lo que queda por pagar, en euros (todas las facturas impagadas). |
| Next invoice | La próxima factura por pagar: importe, vencimiento, concepto. |
| Last message | El asunto del último mensaje del municipio. |
Un dispositivo por niño
| Función | Contenido |
|---|---|
| Today | Las actividades reservadas hoy («Cantine, Garderie du soir»). |
| Tomorrow | Las actividades reservadas mañana. |
| Canteen today | 1 si el niño come hoy en el comedor, 0 si no. |
| Canteen tomorrow | 1 si el niño come mañana en el comedor, 0 si no. |
Un día solicitado y aún no validado por el municipio cuenta como reservado. Los textos están en francés, como las actividades del portal.
La comida se reconoce por su nombre: «cantine», «repas», «restauration», «déjeuner», «pause méridienne»… Cada municipio nombra sus actividades a su manera.
La insignia cloud de cada dispositivo pasa a inaccesible mientras no se puede leer el portal.
Escenas (Gladys 5.1+)
Disparadores
| Disparador | Cuándo | Variables |
|---|---|---|
| Se emite una nueva factura | Aparece una factura impagada. | label, amount, due_date, invoice_id |
| Una factura vence pronto | Una factura impagada vence dentro de los días fijados. Una sola vez. | label, amount, due_date, days_left, invoice_id |
| Se recibe un mensaje | El municipio envió un mensaje. | subject, sender, date |
| Una reserva cambia | Un día reservado o solicitado cambia de estado (aceptado, rechazado, cancelado…). Filtrable por niño y por estado. | child_name, activity, date, status, previous_status, meal |
Las variables se usan en las acciones siguientes, p. ej.
{{triggerEvent.data.amount}}.
La primera lectura del portal no dispara nada: todo parecería nuevo. Los
cambios se cuentan a partir de ahí, también tras un reinicio (la integración
guarda la última lectura en /data).
Acciones
| Acción | Qué hace | Salidas |
|---|---|---|
| Leer el portal familiar | Lee el portal ahora mismo. | success, balance, unpaid_invoices, unread_messages |
| Comprobar el día de un niño | Si el niño está reservado ese día (0 = hoy, 1 = mañana…) y para qué. | has_meal, booked_count, activities, date |
La integración solo lee el portal: nunca reserva ni cancela nada. Las reservas y las ausencias se hacen en el portal.
Ejemplos
- Cada tarde a las 19 h: Comprobar el día de cada niño para mañana y,
si
has_meales falso, enviar «Mañana Léa no tiene comedor». - Una factura vence pronto → enviar «Factura de {{triggerEvent.data.amount}} € a pagar antes del {{triggerEvent.data.due_date}}».
- Una reserva cambia, filtrado en Rechazado → notificación.
El widget
El widget Agora Famille del panel muestra:
- el saldo pendiente (en directo);
- para cada niño (5 como máximo), lo reservado hoy y mañana (verde: reservado, naranja: solicitud pendiente, rojo: rechazado);
- las facturas por pagar y los 3 últimos mensajes sin leer;
- la hora de la última lectura, o el error actual.
Y dos botones: Actualizar y Abrir portal. Las ausencias y las reservas se hacen en el portal.
Facturas transmitidas al Trésor public
Cuando una factura no se paga a tiempo, el municipio la transmite al Trésor public (el tesoro público francés, «mise en impayé»). El portal deja entonces de seguir su pago: la muestra impagada para siempre, incluso una vez pagada al Trésor.
La integración pone estas facturas aparte:
- no cuentan en el saldo pendiente ni como próxima factura;
- no disparan ni «nueva factura» ni «factura a punto de vencer»;
- el widget las muestra en gris, con la insignia Tesoro.
Se reconocen de dos formas:
- solas, cuando el portal las marca (factura en contencioso, o un estado que menciona el Trésor);
- por su número, en el campo Facturas transmitidas al Trésor public
(el número que muestra el portal, p. ej.
164513).
Solución de problemas
- «El portal rechazó el usuario o la contraseña»: compruébelos iniciando sesión en el portal desde un navegador. Una cuenta pendiente de validación por el ayuntamiento aún no puede iniciar sesión.
- «El portal no responde»: puede que el portal esté en mantenimiento; la integración lo vuelve a intentar en cada intervalo.
- «El portal respondió algo inesperado»: marque Registros detallados, pulse Probar la conexión y consulte los registros de la integración (Integraciones → Agora Famille → Supervisión).
Importante: no hay API oficial
Agora Plus no publica ninguna API para su portal familiar. La integración
hace las mismas peticiones que las páginas del portal; están reunidas en un
único archivo, src/agora/endpoints.js. Una
actualización del portal, o un municipio configurado de otra forma, puede
requerir ajustarlas: abra entonces una
incidencia indicando
el paso que falla y el código HTTP devuelto (nunca su contraseña).
Privacidad
- Las credenciales solo sirven para iniciar sesión en el portal de su municipio, por HTTPS.
- La contraseña y las cookies de sesión nunca se escriben en los registros.
- La última lectura del portal (planificación, facturas, mensajes) se guarda
en el volumen privado
/datade la integración, para detectar cambios tras un reinicio. No se envía nada a ningún otro sitio.
Parámetros de configuración
Estos son los parámetros que Agora Famille te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su portal familiar | section | No | Use la dirección y la cuenta con las que inicia sesión en el portal Agora Famille de su municipio. La integración lee el portal como lo haría un navegador: no se comparte nada con nadie más. |
| Dirección del portal | string | Sí | La dirección de su portal, tal como la muestra su navegador, o solo el nombre de su municipio que aparece en ella. |
| Usuario (correo) | string | Sí | |
| Contraseña | secret | Sí | |
| Intervalo de lectura (min) | number | No | Cada cuánto se lee el portal, en minutos (15 como mínimo). |
| Días de planificación seguidos | number | No | Cuántos días por adelantado se leen y vigilan las reservas. |
| Aviso de factura (días) | number | No | El disparador «factura a punto de vencer» se activa estos días antes del vencimiento. 0 lo desactiva. |
| Facturas transmitidas al Trésor public | string | No | Números de las facturas que el municipio transmitió al Trésor public («mise en impayé»), separados por comas. El portal las sigue mostrando impagadas: se muestran aparte y no se cuentan en el saldo pendiente. Las que el propio portal marca se detectan sin esto. |
| Registros detallados | boolean | No | Registra cada petición al portal (nunca la contraseña). Para diagnosticar. |
Cómo instalar Agora Famille en Gladys
- En Gladys, abre Integraciones: Agora Famille 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/prohand/gladys-agorafamille:2.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/prohand/gladys-agorafamille.
Agora Famille 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
Agora Famille 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 prohand, 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