Integração Accelero Edu
A integração Accelero Edu conecta o ACCELERO ao aplicativo Accelero Edu, voltado ao ambiente escolar. O app permite que o professor faça a chamada (lista de presença) de uma turma diretamente pelo celular, autenticando-se com suas credenciais do ACCELERO. As chamadas registradas ficam disponíveis no ACCELERO por meio do Relatório de Chamadas.
Esta integração é disponibilizada como plugin (acceleroedu) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 1.0.0 — compatível com ACCELERO 2.17.0 ou superior.
O que a integração faz
Com o plugin ativo, o ACCELERO passa a fornecer ao aplicativo Accelero Edu os dados de turmas e alunos, autentica os professores e armazena as chamadas realizadas pelo app.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Marcação de turma | Uma categoria de pessoa pode ser marcada como turma, passando a aparecer no aplicativo |
| QR Code da turma | Cada turma ganha um QR Code que aponta para o endereço do app, identificando a escola e a turma |
| Senha para o Accelero Edu | Uma pessoa (professor) pode ter uma senha própria para autenticar no aplicativo |
| Autenticação do professor | O app autentica o professor usando documento (CPF) e senha cadastrados no ACCELERO |
| Consulta de turmas e alunos | O app lista as turmas habilitadas e os alunos de cada turma, com foto |
| Registro de chamada | A lista de presença enviada pelo app é gravada no ACCELERO (chamada + presença de cada aluno) |
| Relatório de Chamadas | Relatório, dentro do ACCELERO, das chamadas registradas, com filtros por período, turma, aluno e professor |
Permite que o professor faça a chamada da turma pelo aplicativo, reaproveitando o cadastro de pessoas e categorias já existente no ACCELERO, sem planilhas paralelas.
Configuração
Caminho de acesso: Avançado > Sistema > Integrações - AcceleroEdu
A tela de configuração possui a aba Geral.
Aba Geral — Dados da integração
| Campo | Descrição |
|---|---|
| Operador | Operador do ACCELERO usado pela integração. Quando não definido, é utilizado o usuário de processos em segundo plano |
| Token de autenticação (APP > Accelero) | Token usado na comunicação entre o aplicativo e o ACCELERO |
| URL do acceleroEdu | Endereço (URL) do aplicativo Accelero Edu. Compõe o link gravado no QR Code da turma |
| Slug da escola | Identificador da escola usado na composição do QR Code da turma |
Todos os campos da aba Geral são de preenchimento obrigatório. O Token, a URL e o Slug da escola são fornecidos/definidos durante a implantação pela IONGRADE.
Botões da tela
| Botão | Função |
|---|---|
| Voltar | Retorna à lista de configurações |
| Salvar | Persiste a configuração |
Campos adicionados às entidades
O plugin estende formulários do ACCELERO com seções específicas do Accelero Edu.
Pessoa
No cadastro de pessoa é adicionada a seção recolhível Accelero Edu:
| Campo | Descrição |
|---|---|
| Senha para o Accelero Edu | Senha usada pela pessoa (professor) para autenticar no aplicativo. É armazenada de forma criptografada |
O professor autentica no app informando o documento (CPF) cadastrado em sua ficha de pessoa e a Senha para o Accelero Edu. Pessoas sem essa senha definida não conseguem entrar no aplicativo.
Categoria (Turma)
Na edição de categoria de pessoa é adicionada a seção recolhível Accelero Edu:
| Campo | Descrição |
|---|---|
| É uma turma? | Quando ativado, marca a categoria como uma turma do Accelero Edu. Apenas categorias marcadas como turma aparecem no aplicativo |
| QR Code | Imagem do QR Code da turma, gerada automaticamente com o endereço <URL do acceleroEdu>/<Slug da escola>/<ID da categoria> |
| Imprimir QRCode | Botão que permite imprimir o QR Code da turma |
Somente categorias habilitadas e marcadas como turma são listadas para o aplicativo. Desabilite a categoria ou desmarque "É uma turma?" para removê-la do app.
Relatório de Chamadas
O plugin adiciona o Relatório de Chamadas, que reúne as chamadas registradas pelo aplicativo.
Caminho de acesso: Relatórios > Relatório de Chamadas
Filtros disponíveis
| Filtro | Descrição |
|---|---|
| De | Data inicial da chamada |
| Até | Data final da chamada |
| Turmas | Seleção de uma ou mais turmas |
| Nome do aluno | Filtra pelo nome do aluno |
| RA do aluno | Filtra pelo código (RA) do aluno |
| Nome do professor | Filtra pelo nome do professor responsável pela chamada |
Conteúdo do relatório
O relatório lista as presenças registradas, com as colunas:
| Coluna | Conteúdo |
|---|---|
| Nome do aluno | Nome do aluno |
| RA | Código (RA) do aluno |
| Turma | Descrição da turma |
| Data e Hora da Chamada | Momento em que a chamada foi registrada |
| Professor | Nome do professor que realizou a chamada |
| Presente | Indica se o aluno foi marcado como presente (Sim/Não) |
A tela também disponibiliza as abas Templates (modelos de filtro salvos) e Histórico (relatórios gerados anteriormente). O botão Gerar relatório gera o relatório de forma assíncrona, e Criar template salva os filtros atuais como modelo.
O acesso ao Relatório de Chamadas é controlado pela permissão Relatório de chamadas, criada na instalação do plugin. Garanta que o perfil do operador tenha essa permissão.
Como o aplicativo se comunica com o ACCELERO
O fluxo de uso do app segue estas etapas:
- Autenticação — o professor informa documento (CPF) e a Senha para o Accelero Edu; o ACCELERO valida as credenciais e retorna os dados do professor.
- Listagem de turmas — o app obtém as turmas (categorias habilitadas e marcadas como turma).
- Listagem de alunos — ao abrir uma turma, o app recebe os alunos vinculados à categoria, com nome, RA e foto.
- Registro da chamada — ao finalizar, o app envia a lista com a presença de cada aluno; o ACCELERO grava a chamada e a presença individual.
O QR Code de cada turma aponta para o endereço do aplicativo, já identificando a escola (slug) e a turma. Ele facilita o acesso à turma correta a partir do app.
Casos de uso
Habilitar uma turma no aplicativo
- Solicite à IONGRADE a instalação do plugin
acceleroedu. - Em
Avançado > Sistema > Integrações - AcceleroEdu, preencha Operador, Token, URL do acceleroEdu e Slug da escola. - Edite a categoria que representa a turma e ative É uma turma? na seção Accelero Edu.
- Garanta que os alunos estejam vinculados a essa categoria.
- Use o QR Code da turma (botão Imprimir QRCode) para acesso rápido pelo app.
Habilitar um professor no aplicativo
- Edite a ficha da pessoa que será o professor.
- Confirme que o documento (CPF) está cadastrado.
- Na seção Accelero Edu, defina a Senha para o Accelero Edu.
- Informe ao professor as credenciais (CPF e senha) para login no aplicativo.
Conferir as chamadas registradas
- Acesse
Relatórios > Relatório de Chamadas. - Informe o período em De e Até e, se necessário, filtre por Turmas, aluno ou professor.
- Gere o relatório e acompanhe o resultado na aba Histórico.
Boas práticas
- Categorias dedicadas a turmas: use categorias específicas para representar turmas, evitando marcar categorias genéricas como "É uma turma?".
- CPF do professor cadastrado: a autenticação no app usa o documento (CPF); professores sem CPF cadastrado não conseguem entrar.
- Senhas individuais: defina uma Senha para o Accelero Edu por professor, em vez de compartilhar credenciais.
- Permissão do relatório: conceda a permissão Relatório de chamadas apenas aos perfis que precisam consultar a presença.
Troubleshooting
A turma não aparece no aplicativo
Possíveis causas:
- A categoria não está marcada com É uma turma?.
- A categoria está desabilitada.
Solução:
- Edite a categoria e confirme que É uma turma? está ativo.
- Verifique se a categoria está habilitada.
O professor não consegue autenticar
Possíveis causas:
- A pessoa não tem documento (CPF) cadastrado.
- A Senha para o Accelero Edu não foi definida ou está incorreta.
Solução:
- Confirme o CPF na ficha da pessoa.
- Redefina a Senha para o Accelero Edu na seção Accelero Edu do cadastro.
O QR Code não direciona corretamente
Possíveis causas:
- Os campos URL do acceleroEdu ou Slug da escola não estão preenchidos corretamente na configuração.
Solução:
- Em
Avançado > Sistema > Integrações - AcceleroEdu, revise os campos URL do acceleroEdu e Slug da escola. - Salve e gere/imprima novamente o QR Code da turma.
Integração com outros módulos
Categorias
As turmas do Accelero Edu são Categorias de pessoa marcadas como turma. A habilitação e o vínculo de alunos são feitos no cadastro de categorias.
Pessoas
Alunos e professores são Pessoas do ACCELERO. O professor usa o documento (CPF) e a senha do Accelero Edu para autenticar; os alunos são as pessoas vinculadas à categoria da turma.
Relatórios
O Relatório de Chamadas segue o mecanismo de Relatórios do ACCELERO, com filtros, templates e histórico de geração.
Próximos Passos
- Categorias — Marque a categoria como turma e vincule os alunos
- Pessoas — Cadastre o CPF e a senha do professor
- Relatórios — Entenda o funcionamento dos relatórios
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO