Integración domótica iNoé Espace Famille, gratuita y de código abierto
Facturas, reservas y noticias de su portal iNoé Espace Famille (comedor, extraescolar, guardería).
Publicado por prohand
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.3.0
- ★ 0
Esta integración conecta Gladys con su iNoé Espace Famille (el portal familiar de AIGA que usan muchos municipios y centros franceses: comedor escolar, actividades extraescolares, centro de ocio, guardería). Lee, como usted lo haría en el portal:
- el importe por pagar y las facturas pendientes;
- las reservas de cada niño (hoy, mañana, los días siguientes);
- las noticias publicadas por el centro;
- el número de documentos que el centro espera.
La integración solo lee: nunca reserva, cancela ni paga nada. Los pagos y las reservas siguen en el portal.
Es una integración en la nube: pasa por los servidores de AIGA en Internet, así que Gladys necesita acceso a Internet.
Se necesita Gladys 5.3 o posterior.
Configuración
En Gladys, abra Integraciones, instale iNoé Espace Famille y complete la pantalla de configuración:
| Campo | Qué poner |
|---|---|
| Dirección del portal | La dirección de la página de inicio de sesión del portal, copiada tal cual: https://espacefamille.aiga.fr/index.html?dossier=1626256#connexion… o https://espacefamille.aiga.fr/11578177. También vale solo el número (1626256). |
| Correo electrónico | El correo con el que inicia sesión en el portal. |
| Contraseña | La contraseña del portal. Solo se envía al servidor de inicio de sesión de AIGA y nunca se escribe en los registros. |
| Intervalo de actualización (min) | Cada cuántos minutos se lee el portal (60 por defecto, de 15 a 1440). |
| Recordatorio de factura (días) | Cuántos días antes del vencimiento se activa el disparador «Una factura vence pronto» (3 por defecto). |
| Planificación leída por adelantado (días) | Cuántos días de la planificación de cada niño se leen, hoy incluido (7 por defecto). |
| Zona horaria | Lo que decide «hoy» y «mañana»: Europe/Paris por defecto, Indian/Reunion, America/Martinique… para ultramar. |
Pulse Probar la conexión: la respuesta indica el nombre del centro, el importe pendiente y, para cada niño, los días reservados y la próxima reserva.
Abra después la pestaña Descubrimiento de la integración y cree los dispositivos.
¿Dónde está la dirección del portal? En el correo de creación de cuenta que envió su centro, o en la barra de direcciones del navegador cuando está en el portal: es el número después de
dossier=(o deespacefamille.aiga.fr/).
Dispositivos
La familia
Un dispositivo con el nombre del centro (y de su familia):
| Función | Valor |
|---|---|
| Amount due | Importe pendiente de pago, en euros |
| Unpaid invoices | Número de facturas por pagar |
| Next due date | Fecha de vencimiento de la próxima factura (AAAA-MM-DD) |
| Documents expected | Número de documentos que espera el centro |
| Latest news | Título de la última noticia del centro |
Cada niño
Un dispositivo por niño («Léa – iNoé»):
| Función | Valor |
|---|---|
| Booked today | 1 si el niño tiene al menos una reserva hoy, si no 0 |
| Booked tomorrow | 1 si el niño tiene al menos una reserva mañana, si no 0 |
| Today | Las actividades reservadas hoy («Accueil de loisirs : Matin, Repas, Après-midi») |
| Tomorrow | Las actividades reservadas mañana |
| Days booked ahead | Número de días reservados en el periodo leído |
Una ausencia o una plaza en lista de espera no cuenta como reserva.
Cada dispositivo muestra la insignia nube; pasa a inaccesible cuando el portal no responde.
Disparadores de escena
En una escena, elija el disparador Integraciones → iNoé Espace Famille:
| Clave | Cuándo | Variables |
|---|---|---|
new_invoice | Aparece una nueva factura por pagar | number, label, structure, amount, due_date |
invoice_due_soon | Una factura vence pronto (una vez por factura) | las mismas + days_left |
booking_changed | Se reserva o cancela una actividad en la planificación de un niño | child_name, date, activity, change (booked/cancelled) |
new_message | El centro publica una nueva noticia | title, date |
booking_changed se puede filtrar por niño y por tipo de cambio. En las acciones siguientes,
use por ejemplo {{triggerEvent.data.amount}}.
En la primerísima lectura de una cuenta no se señala nada (si no, cada factura ya existente sería «nueva») — salvo una factura que ya vence pronto.
Acciones de escena
| Clave | Qué hace | Resultados |
|---|---|---|
refresh | Lee el portal ahora mismo, sin esperar al intervalo | amount_due, unpaid_invoices |
check_booking | Indica si un niño tiene reserva hoy o mañana, y en qué actividades | booked, activities |
Ejemplo: cada noche a las 20 h, check_booking para Léa, mañana; si booked es verdadero,
enviar «Mañana: {{…activities}}» por Telegram.
Widget del panel
El widget Espacio familiar (family_space) muestra el importe pendiente (en directo), la
próxima factura (naranja cuando se acerca el vencimiento, rojo cuando ha pasado), el día de cada
niño hoy y mañana, y los documentos esperados. El botón Actualizar vuelve a leer el portal;
Abrir el portal abre su Espace Famille.
El widget Próximas reservas (upcoming_bookings) lista los días reservados de los próximos
días (el ajuste Planificación leída por adelantado (días)), una tarjeta por día, 8 como máximo: los niños
inscritos y sus franjas, «Hoy» y «Mañana» en color. Toque una tarjeta para ver las actividades
de cada niño completas. Tiene los mismos botones Actualizar y Abrir el portal.
Solución de problemas
| Mensaje | Qué hacer |
|---|---|
| «iNoé no reconoce esta dirección de portal» | Copie de nuevo la dirección del correo de su centro. |
| «El portal rechazó el correo o la contraseña» | Inicie sesión en el propio portal; si la contraseña cambió, actualícela en Gladys. |
| «El portal iNoé está en mantenimiento» | Nada que hacer: se reintentará en la próxima actualización. |
| Un niño muestra «planificación ilegible» | Quizá el centro cerró una actividad. El resto de la información sigue al día. |
El portal no tiene API pública: la integración usa los mismos intercambios que el sitio web. Si AIGA cambia su sitio, puede ser necesaria una actualización de la integración.
Privacidad
- La contraseña solo se envía a
ism.aiga.fr(el servidor de inicio de sesión de AIGA). - No se envía nada a otro sitio que a los servidores de AIGA y a su Gladys.
- Solo una pequeña memoria (números de facturas y noticias, reservas ya vistas) se guarda en el
volumen
/datade la integración, para no señalar dos veces lo mismo.
Parámetros de configuración
Estos son los parámetros que iNoé Espace Famille te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Use la misma dirección, correo y contraseña que en el portal iNoé Espace Famille de su municipio o centro. La integración solo lee: nunca reserva, cancela ni paga nada. Se comunica con los servidores de AIGA por Internet (nube). |
| Dirección del portal | string | Sí | Pegue la dirección de la página de inicio de sesión del portal, p. ej. https://espacefamille.aiga.fr/index.html?dossier=1626256 o https://espacefamille.aiga.fr/11578177 — o solo ese número. |
| Correo electrónico | string | Sí | El correo con el que inicia sesión en el portal. |
| Contraseña | secret | Sí | La contraseña del portal. Solo se envía al servidor de inicio de sesión de AIGA y nunca se escribe en los registros. |
| Intervalo de actualización (min) | number | No | Frecuencia de lectura del portal, en minutos (15 a 1440). |
| Recordatorio de factura (días) | number | No | El disparador «Factura próxima a vencer» se activa una vez por factura, este número de días antes del vencimiento (0 = el mismo día). |
| Planificación leída por adelantado (días) | number | No | Cuántos días de la planificación de cada niño se leen, hoy incluido (1 a 31). |
| Zona horaria | string | No | La zona horaria de la familia, que decide qué son «hoy» y «mañana». Un nombre IANA como Europe/Paris o Indian/Reunion. |
Cómo instalar iNoé Espace Famille en Gladys
- En Gladys, abre Integraciones: iNoé Espace 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-inoeespacefamille: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/prohand/gladys-inoeespacefamille.
iNoé Espace 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
iNoé Espace 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