Guia de implementação

Para a pessoa que configura a igreja. Trazer o repertório do Holyrics para a Eslyrio (exportar e importar o ficheiro) não precisa de plano nem de agente. Para enviar ao Holyrics o que você monta na Eslyrio é preciso, no mínimo, uma assinatura do Holyrics no plano Basic.

1. Integração por tipo de assinatura do Holyrics

1.1 Assinatura Holyrics — plano Basic

• A Eslyrio sincroniza com o Holyrics por meio do agente local (um programa para Windows).
• O agente é baixado em Configurações → Sincronização com Holyrics e roda no computador do templo.
• Mantém músicas e listas atualizadas com o Holyrics.

1.2 Assinatura Holyrics — plano Advanced

• Não precisa do agente: a sincronização é direta via API oficial do Holyrics.
• Requer a chave de API pública da sua conta Holyrics.

E sem plano pago? Você pode trazer o seu repertório igual: exporte as suas músicas do Holyrics (Canção → Exportar → Exportação em grupo, em JSON e com «arquivo único») e suba-as na Eslyrio; isso não precisa de plano nem de agente. O que não haverá é envio ao Holyrics: a lista é montada à mão lá (ou as músicas são carregadas com o modelo).

2. Ligar o Holyrics (com o agente, plano Basic)

Faz-se tudo uma vez, no PC do templo, com o Holyrics aberto. Os nomes são do próprio Holyrics (podem aparecer no idioma que você tiver configurado lá):

1. No Holyrics: menu Archivo → Configuraciones.
2. Separador API Server: marque «Activado» (a porta 8091 fica como está).
3. Clique em «Administrar permisos», selecione o usuário com que o Eslyrio vai ler (ou crie um com «+ Añadir») e clique em «Editar».
4. Copie o token dele (o botão de copiar ao lado do token): vai precisar dele no passo 8.
5. Na lista de permissões, marque as caixas da coluna «Local»: são centenas, por isso marque todas.
6. Feche com «Ok».
7. No Eslyrio: Configurações → Sincronização com Holyrics. Aí tem a chave de sincronização da sua igreja e o botão Baixar agente (Windows), que já a leva dentro.
8. Instale o agente nesse mesmo PC e cole lá o token do Holyrics do passo 4.

Assim que o agente arrancar, o repertório desce sozinho e no início da app desaparece o aviso «o seu repertório do Holyrics ainda não chegou».

Se ao enviar músicas aparecer «Acesso negado»: o Holyrics tem outra camada de permissões, a do motor JavaScript. Veja em Configurações → Avanzado → JavaScript → Configurações → Permisos avanzados (jslib): a caixa «Crear, editar y eliminar datos importantes» tem de estar marcada (vem marcada de fábrica; se não estiver, marque-a).

3. Planos da Eslyrio

O plano da Eslyrio é independente do Holyrics:

• Inicial: grátis, sem limite de músicas, 10 músicos ativos, 1 diretor, 1 co-diretor e 1 administrador. A equipa pode ser rodada (arquivar e reativar) sem apagar ninguém.
• Plus: hoje aberto em beta para todas as igrejas. Quando sair, acrescenta músicos e responsáveis sem limite, disponibilidade da equipa, quadro do mês com imagem e sincronização com o Holyrics Advanced sem agente.

4. Instalar o app (PWA)

No celular, toque no botão flutuante "Instalar o app" (canto inferior direito) para adicioná-lo à tela inicial. O app funciona offline depois de instalado.

5. Dados e privacidade

• Cada usuário entra com seu código de acesso (e-mail).
• Você pode exportar e excluir os dados de um usuário (LGPD) no painel.
• O app separa claramente os dados de cada igreja (multi-tenant).