Integración domótica Monica, gratuita y de código abierto
Cumpleaños y recordatorios de Monica (CRM personal): contadores, disparadores de escena, widget.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Los cumpleaños y recordatorios de su Monica (el CRM personal libre) en Gladys: quién cumple años hoy, quién los cumple esta semana, qué recordatorios caen hoy. Una escena puede enviarle un mensaje la mañana de un cumpleaños, avisarle una semana antes para el regalo, y Gladys puede leer en voz alta los cumpleaños de la semana.
Sus comentarios son bienvenidos. Esta integración se ha probado con un servidor Monica 4 real (imagen Docker oficial
monica:4, 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.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Un Monica 4 autoalojado (la imagen Docker
monica:4o una instalación 4.x), accesible desde Gladys. Monica 5 («chandler») aún no tiene API: no es compatible. - Un token de acceso personal de un usuario de Monica. En Monica:
Settings → API → Personal access tokens → Create new token,
dele un nombre (
Gladys) y cópielo: Monica solo lo muestra una vez. La integración solo lee: nunca cambia nada en Monica.
Configuración
- En Gladys, Integraciones → instale Monica.
- En la pantalla Configuración de la integración:
- Dirección: la dirección de Monica como en su navegador, p. ej.
http://192.168.1.20:8080ohttps://monica.example.org; - Token de acceso personal: el token creado arriba;
- Hora de los eventos de escena (08:00 por defecto): cuándo los cumpleaños y recordatorios del día activan sus escenas;
- Intervalo de actualización (1 hora por defecto, de 15 minutos a 6 horas);
- Aceptar certificados autofirmados: solo para su propio servidor en
https://con un certificado autofirmado; - Idioma de los nombres de funciones: francés por defecto.
- Dirección: la dirección de Monica como en su navegador, p. ej.
- Probar la conexión: Gladys lee Monica e indica cuántos cumpleaños y recordatorios ha encontrado.
- En la pestaña Descubrimiento, añada el dispositivo Monica.
Monica permite 60 solicitudes por minuto y por token. Una lectura cuesta una solicitud por cada 100 contactos y 100 recordatorios, más una: muy por debajo, incluso con una agenda grande.
Dispositivos
Un dispositivo Monica por cuenta de Monica, con estas funciones:
| Función | Lo que indica |
|---|---|
| Cumpleaños hoy | los contactos que cumplen años hoy |
| Cumpleaños en 7 días | los cumpleaños de hoy a dentro de 6 días |
| Recordatorios de hoy | los recordatorios de Monica que caen hoy (salvo los de cumpleaños) |
| Días hasta el cumpleaños | días hasta el próximo cumpleaños, 0 si es hoy |
| Próximo cumpleaños | el nombre de la próxima persona que los cumple, «Ninguno» si no hay |
Lo que cuenta como cumpleaños:
- un contacto con fecha de nacimiento conocida; si solo se conocen el día y el mes, no hay edad;
- se excluyen los contactos fallecidos, archivados y parciales (familiares sin ficha propia), así como una fecha de nacimiento introducida solo como edad («unos 40 años»);
- nacido un 29 de febrero: se celebra el 28 de febrero en un año no bisiesto.
Lo que cuenta como recordatorio: todos los recordatorios de Monica (una vez, cada N semanas, meses o años), salvo los de contactos fallecidos o archivados y los recordatorios «Wish happy birthday» que Monica crea para cada cumpleaños, ya contados como cumpleaños. Un recordatorio mensual el día 31 cae el último día de los meses más cortos.
Panel
El widget Próximos cumpleaños muestra dos casillas (cumpleaños y recordatorios de hoy), los seis próximos cumpleaños con su fecha y la edad cumplida, y los recordatorios de los próximos 7 días con su contacto. Añádalo a un panel con Editar → Añadir un widget. Si Monica no responde, el widget conserva los últimos datos conocidos bajo un breve aviso.
Escenas
Disparadores
Los eventos del día se activan una vez al día, a la hora de los eventos de escena elegida en la configuración (o en la primera lectura posterior, si Gladys o Monica estaban detenidos). Un cumpleaños o un recordatorio añadido más tarde en el día se activa en la lectura siguiente. Las variables contienen nombres: piense en quién leerá los mensajes que envíe con ellas.
- Cumpleaños hoy (Monica): un contacto cumple años hoy. Filtro opcional: Nombre (nombre y apellido exactamente como en Monica). Variables: nombre, nombre de pila, edad cumplida (vacía si se desconoce el año), fecha del cumpleaños, número del contacto de Monica.
- Cumpleaños dentro de N días (Monica): el cumpleaños de un contacto es dentro de N días. Campo obligatorio Días antes del cumpleaños, de 1 (la víspera) a 30; filtro opcional Nombre. Las mismas variables, más los días restantes.
- Recordatorio de hoy (Monica): un recordatorio cae hoy. Filtro opcional: Título del recordatorio (título exacto). Variables: título del recordatorio, nombre del contacto, número del recordatorio de Monica, número del contacto de Monica.
Acciones
- Leer los cumpleaños de la semana (Monica): Monica se vuelve a leer y la acción devuelve una Frase, por ejemplo «4 cumpleaños en los próximos 7 días: Alice Martin (36 años) hoy, Bruno hoy, Chloé Durand (10 años) sábado y Inès lunes.», y el Número de cumpleaños, para enviar por mensaje o decir en voz alta. La frase sigue el idioma elegido en la configuración.
Ideas de escenas
- Mensaje de cumpleaños: disparador «Cumpleaños hoy (Monica)» → enviar «Hoy es el cumpleaños de {{name}}» (y su edad, si se conoce).
- Pensar en el regalo: disparador «Cumpleaños dentro de N días (Monica)» con 7 días → mensaje «{{name}} cumple años dentro de una semana: piense en el regalo».
- Lunes por la mañana: cada lunes a las 08:00 → «Leer los cumpleaños de la semana (Monica)» → decir la frase en el altavoz de la cocina, o enviarla.
- Recordatorio de llamada: disparador «Recordatorio de hoy (Monica)» → mensaje «Recordatorio: {{title}} ({{contact_name}})».
Solución de problemas
- «Monica no responde»: compruebe la dirección (con el puerto) y que
Gladys la alcanza: Gladys funciona en Docker,
localhostno es su servidor. - «token de acceso rechazado (¿revocado o caducado?)»: cree un nuevo token de acceso personal en Monica y péguelo en la configuración.
- «no hay ninguna API de Monica 4 en esta dirección»: la dirección apunta a otra cosa, o a Monica 5, que no tiene API.
- «la dirección redirige»: Monica impone HTTPS: introduzca la dirección
https://. - «certificado rechazado»: marque «Aceptar certificados autofirmados» para su propio servidor.
- Falta un cumpleaños: compruebe en Monica que el contacto tiene fecha de nacimiento (no solo una edad) y que no está archivado ni fallecido.
- Ningún evento de escena: los eventos se envían una vez al día a la hora
elegida en la configuración; los registros nunca muestran nombres
(
LOG_LEVEL=debugpara el detalle de una lectura).
Límites
- Solo Monica 4; Monica 5 no es compatible (sin API).
- Solo lectura: desde Gladys no se crea ni se modifica ningún contacto, cumpleaños ni recordatorio.
- Los eventos del día se envían una vez al día, no a la hora del recordatorio (un recordatorio de Monica tiene fecha, no hora).
- La próxima vez que cae un recordatorio la calcula la integración a partir de su fecha de inicio y su frecuencia.
- Una cuenta de Monica por integración (la del token).
Parámetros de configuración
Estos son los parámetros que Monica te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su Monica | section | No | Un Monica 4 autoalojado (Monica 5 aún no tiene API). En Monica, cree un token de acceso personal: Settings, API, Personal access tokens. |
| Dirección | string | Sí | Dirección de Monica, como en el navegador, con https:// para HTTPS y :puerto si no es el estándar. |
| Token de acceso personal | secret | Sí | Creado en Monica: Settings, API, Personal access tokens. La integración solo lee. |
| Opciones | section | No | |
| Hora de los eventos de escena | select | No | Los cumpleaños y recordatorios del día activan sus escenas a esta hora, una vez al día. |
| Intervalo de actualización | select | No | Con qué frecuencia se lee Monica. La medianoche y la hora de los eventos se siguen siempre a tiempo. |
| Aceptar certificados autofirmados | boolean | No | Para una dirección https:// con certificado autofirmado. Márquelo solo para su propio servidor. |
| Idioma de los nombres de funciones | select | No | Nombres de las funciones al añadir un dispositivo y textos enviados a las escenas. |
Cómo instalar Monica en Gladys
- En Gladys, abre Integraciones: Monica 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-monica: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-monica.
Monica 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
Monica 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, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación