Guía de implementación

Para la persona que configura la iglesia. Traer el repertorio de Holyrics a Eslyrio (exportar e importar el fichero) no necesita plan ni agente. Para enviar a Holyrics lo que montes en Eslyrio hace falta, como mínimo, una suscripción de Holyrics en el plan Basic.

1. Integración según tipo de suscripción con Holyrics

1.1 Suscripción Holyrics — plan Basic

• Eslyrio se sincroniza con Holyrics mediante el agente local (un programa para Windows).
• El agente se descarga desde Ajustes → Sincronización con Holyrics y se ejecuta en el ordenador del templo.
• Mantiene canciones y listas al día con Holyrics.

1.2 Suscripción Holyrics — plan Advanced

• No necesita el agente: la sincronización es directa vía la API oficial de Holyrics.
• Requiere la clave de API pública de tu cuenta de Holyrics.

¿Y sin plan de pago? Puedes traer tu repertorio igual: exporta tus canciones de Holyrics (Canción → Exportar → Exportación en grupo, en JSON y con «Archivo único») y súbelas en Eslyrio; eso no necesita plan ni agente. Lo que no habrá es envío a Holyrics: la lista se monta a mano allí (o se usan las canciones con la plantilla).

2. Conectar Holyrics (con el agente, plan Basic)

Todo esto se hace una vez, en el PC del templo, con Holyrics abierto. Los nombres son los del propio Holyrics (pueden aparecer en el idioma que tengas puesto ahí):

1. En Holyrics: menú Archivo → Configuraciones.
2. Pestaña API Server y marca «Activado» (el puerto 8091 se queda como está).
3. Pulsa «Administrar permisos», selecciona el usuario con el que va a leer Eslyrio (o crea uno con «+ Añadir») y pulsa «Editar».
4. Copia su token (el botón de copiar que está junto al token): lo vas a necesitar en el paso 8.
5. En la lista de permisos, marca las casillas de la columna «Local»: son cientos, así que márcalas todas.
6. Cierra con «Ok».
7. En Eslyrio: Ajustes → Sincronización con Holyrics. Ahí tienes la clave de sincronización de tu iglesia y el botón Descargar agente (Windows), que ya la lleva dentro.
8. Instala el agente en ese mismo PC y pégale el token de Holyrics del paso 4.

En cuanto el agente arranque, el repertorio baja solo y en el inicio de la app desaparece el aviso «tu repertorio de Holyrics aún no ha llegado».

Si al enviar canciones sale «Acceso denegado»: Holyrics tiene otra capa de permisos, la del motor JavaScript. Míralo en Configurações → Avanzado → JavaScript → Configurações → Permisos avanzados (jslib): la casilla «Crear, editar y eliminar datos importantes» tiene que estar marcada (viene marcada de fábrica; si no lo está, márcala).

3. Planes de Eslyrio

El plan de Eslyrio es independiente del de Holyrics:

• Inicial: gratis, sin tope de canciones, 10 músicos activos, 1 director, 1 co-director y 1 administrador. El equipo se puede rotar (archivar y reactivar) sin borrar a nadie.
• Plus: hoy abierto en beta para todas las iglesias. Cuando salga, añade músicos y responsables sin tope, disponibilidad del equipo, cuadrante del mes con imagen y sincronización con Holyrics Advanced sin agente.

4. Instalar la app (PWA)

En el móvil, toca el botón flotante "Instalar la app" (abajo a la derecha) para agregarla a la pantalla de inicio. La app funciona sin conexión una vez instalada.

5. Datos y privacidad

• Cada usuario accede con su código de acceso (correo).
• Puedes exportar y eliminar los datos de un usuario (RGPD) desde el panel.
• La app separa claramente los datos de cada iglesia (multi-tenant).