OnclickWise
Documentação

Tudo o que precisa para implantar e integrar.

Conceitos, módulos, perfis de acesso, integrações e API da plataforma OnclickWise.

Introdução

Visão geral da plataforma

A OnclickWise é uma plataforma de gestão para escolas, centros infantis, universidades e empresas. Funciona no browser (computador e telemóvel), na nuvem ou instalada nos servidores da organização, em português, espanhol, francês e inglês.

Cada organização é uma instituição isolada das restantes: os dados de uma nunca são visíveis para outra. Dentro da instituição, ativa os módulos de que precisa e dá a cada pessoa um perfil que define o que vê e o que pode fazer.

ConceitoO que é
InstituiçãoA sua organização na plataforma: dados, logótipo, país, idioma, moeda e fuso horário.
UnidadeUm local da organização (campus, escola da rede, filial), com equipas, turmas, armazéns ou contas próprias.
MóduloUma área funcional (Acadêmico, RH, Financeiro, Vendas…). Os módulos inativos não aparecem nem respondem.
Perfil (área)Conjunto de permissões atribuído à conta: Secretaria, Financeiro, Comercial, Professor, Aluno…
PortalVista própria para professores, alunos e encarregados, com o que lhes diz respeito.

Guia de implantação

Ordem recomendada para pôr a plataforma a funcionar numa instituição nova:

  1. 1
    Instituição — em Sistema → Configurações: identificação, logótipo, país, idioma, moeda e fuso horário.
  2. 2
    Unidades — em Sistema → Unidades: os locais da organização e os níveis de ensino de cada um.
  3. 3
    Utilizadores — em Sistema → Usuários: a equipa, cada pessoa com a sua área (perfil).
  4. 4
    Acesso — em Sistema → SSO, se for usar login com Google, Microsoft, SAML ou LDAP.
  5. 5
    Dados base — importe alunos, colaboradores, clientes ou artigos em Integração → Importações (ou nos ecrãs de cada módulo).
  6. 6
    Módulos — configure cada módulo que vai usar (calendário acadêmico, planos de mensalidade, jornadas, plano de contas, etapas do pipeline…).
Comece por um módulo e uma unidade-piloto. Acrescentar módulos depois não exige migrar dados.
Módulos

Secretaria e admissão

Gere o ciclo do aluno do primeiro contacto ao arquivo: candidaturas por etapas (documentação, conferência, aprovação), matrículas, trancamentos e reingressos, documentos, solicitações e arquivo acadêmico.

Os Processos digitalizam pedidos com etapas, responsáveis, checklists e prazos (SLA), com modelos prontos, encaminhamentos e auditoria completa.

  • Ecrãs: Secretaria → Candidatos, Alunos, Matrículas, Documentos, Solicitações & atendimento, Arquivo acadêmico, Processos.
  • Perfis: Secretaria, Diretor, Administrador.

Serviços acadêmicos

Estrutura a oferta formativa e a vida da turma: programas por unidade, disciplinas, currículos, salas, calendário acadêmico, planos de ensino, turmas, horário, frequência, diário de classe, boletins, pautas, progressão, aproveitamento de estudos, estágios, TCC, conselhos de classe e conclusões.

  • Ecrãs: Serviços acadêmicos → Turmas, Horário, Frequência, Diário de classe, Boletim, Pautas…
  • Perfis: Coordenador Pedagógico, Secretaria, Professor (pelo portal).

Financeiro, tesouraria e contabilidade

Financeiro — contas a receber, recebimentos, contratos, mensalidades, inadimplência e negociações, contas a pagar, despesas, descontos e bolsas, DRE e relatórios.

Tesouraria — posição multi-moeda, contas bancárias, caixa, conciliação, transferências, agenda de pagamentos, previsão, aplicações, empréstimos e câmbios automáticos (BNA e Banco Central do Brasil).

Contabilidade e fiscal — plano de contas (Brasil e PGC de Angola), lançamentos, razão, balancete, demonstrações, exercícios; documentos fiscais, apuramentos de impostos e calendário de obrigações.

  • Perfis: Financeiro, Contabilidade, Diretor (leitura).

Recursos Humanos, ponto e folha

Colaboradores, contratos, jornadas, frequência, ocorrências, horas extras, justificativas, férias e afastamentos. O controle de ponto regista marcações web e mobile com cerca virtual e comprovativo numerado, e produz espelho de ponto e banco de horas.

No fim do mês, o fechamento de efetividade bloqueia a competência e entrega os dados à folha de pagamento, que calcula os lotes com regras configuráveis.

  • Perfis: Recursos Humanos; todos os colaboradores usam Meu ponto. Os dados salariais têm permissões próprias.

Vendas, marketing e atendimento

Vendas (CRM) — leads com pontuação, pipeline em kanban, clientes e contactos, atividades, propostas com versões, encomendas (expedição, fatura e recebimento), produtos e metas.

Atendimento — caixa de conversas do site e do WhatsApp, respostas automáticas por assunto e passagem a um comercial. Marketing — campanhas com ROI, anúncios e ligações rastreadas, calendário de publicações, listas e formulários de captação.

  • Perfis: Comercial, Marketing.

Estoque, logística, projetos e jurídico

Estoque — artigos, armazéns, saldos, movimentos (custo médio, lotes e validades com saída FEFO), inventários, requisições e reposição. Logística — expedições e guias, viagens, frota, motoristas e transportadoras.

Projetos — tarefas, kanban, gantt, calendário, aprovações e relatórios. Jurídico — contratos, contencioso, prazos e audiências, pedidos internos. Assinaturas — envelopes de assinatura digital por ligação e verificação pública do documento.

Comunicação e workspace

Mensagens individuais e de grupo com anexos e videochamadas, mural interno com publicações e enquetes, comunicados e notificações. O Workspace junta o Drive (pastas, partilha e permissões) e documentos colaborativos com versões.

Perfis e segurança

Perfis de acesso

As permissões são atribuídas por perfil. Uma pessoa vê apenas os menus e as ações do seu perfil, e apenas dos módulos ativos.

PerfilUso típico
AdministradorConfiguração da instituição, utilizadores e todos os módulos
DiretorPainéis, relatórios e leitura transversal
SecretariaAdmissão, matrículas, documentos e processos
Coordenador PedagógicoTurmas, horários, avaliação e conselhos
ProfessorPortal do professor: frequência, diário e notas
Aluno / Encarregado de EducaçãoPortais com notas, faltas, comunicados e pagamentos
Financeiro / ContabilidadeReceitas, pagamentos, tesouraria, contabilidade e fiscal
Recursos HumanosColaboradores, ponto, efetividade e férias
Comercial / MarketingCRM, atendimento, campanhas e formulários
Estoque / Logística / JurídicoOperações de cada área
Estatísticas / BibliotecárioRelatórios e biblioteca

Sessões, auditoria e login único

  • Sessões por dispositivo — cada entrada cria uma sessão que o próprio ou o administrador pode terminar à distância (Sistema → Sessões ativas).
  • Auditoria de acessos — entradas, falhas, entradas por SSO, sessões terminadas e acessos negados ficam registados.
  • Login único — OIDC (Google, Microsoft…), SAML e LDAP, com política da instituição (permitir ou exigir SSO).
  • Isolamento — os dados de cada instituição estão separados e todas as consultas são filtradas pela instituição da sessão.
Integrações e API

Autenticação na API

A API REST responde em JSON. Na nuvem OnclickWise o endereço é https://app-api.onclickwise.com.br; numa instalação própria é o endereço do seu servidor. A documentação interativa (Swagger) está em /api/docs.

Para agir em nome de um utilizador, obtenha um token com o email e a palavra-passe e envie-o no cabeçalho Authorization. As permissões são as do perfil desse utilizador.

Obter um token
curl -X POST https://app-api.onclickwise.com.br/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"utilizador@instituicao.com","password":"••••••••"}'

# resposta: { "data": { "token": "eyJhbGciOi…", "user": { … } } }
Usar o token
curl https://app-api.onclickwise.com.br/vendas/leads \
  -H "Authorization: Bearer eyJhbGciOi…"
Todas as respostas seguem o formato { data, message, statusCode }. Erros de validação devolvem 400 com a mensagem em message.

Chaves de API

Para integrações servidor-a-servidor, crie chaves de API em vez de usar a palavra-passe de uma pessoa. As chaves são enviadas no cabeçalho X-API-Key e podem ser rodadas ou revogadas a qualquer momento.

PedidoFaz
GET /v1/api-keysLista as chaves da instituição
POST /v1/api-keysCria uma chave (o valor só é mostrado uma vez)
POST /v1/api-keys/:id/rotateGera um novo valor e invalida o anterior
DELETE /v1/api-keys/:idRevoga a chave
Guarde as chaves num cofre de segredos. Nunca as coloque em código que corre no browser.

Formulários e webhook de leads

Cada formulário de captação (Marketing → Formulários) tem um endereço público. Pode usar a página pronta /f/<endereço> ou enviar os dados a partir do seu próprio site:

Enviar um lead a partir do seu site
curl -X POST https://app-api.onclickwise.com.br/f/<endereço-do-formulário> \
  -H "Content-Type: application/json" \
  -d '{"name":"Maria Silva","email":"maria@exemplo.com","phone":"+244 923 000 000","company":"Colégio Exemplo","message":"Quero uma demonstração","consent":true}'

Para fontes externas (Meta Lead Ads, LinkedIn, Zapier, Make…), gere o webhook do formulário e configure a ferramenta para enviar cada lead para POST /f/webhook/<token>. São reconhecidos os campos name (ou full_name, first_name + last_name), email, phone, company, job_title, city, message, consent e os parâmetros utm_*.

Os leads entram em Vendas → Leads com a origem, a campanha e a plataforma identificadas, e o responsável do formulário é notificado.

Página de contacto e WhatsApp

A página de contacto do site usa os pedidos públicos GET/POST /contato/<endereço>: o primeiro devolve os números de WhatsApp e os assuntos, o segundo cria o lead, a tarefa do comercial e a resposta automática do assunto.

Para o assistente responder no WhatsApp, cada número é ligado à WhatsApp Cloud API da Meta em Vendas → Atendimento → Canais. Na app da Meta, configure o webhook:

Campo na MetaValor
URL de retornohttps://app-api.onclickwise.com.br/whatsapp/webhook
Token de verificaçãoO token mostrado no canal
Campos subscritosmessages
Quando a chave secreta da app está configurada, a plataforma valida a assinatura X-Hub-Signature-256 de cada pedido e ignora os que não a tiverem correta.

Importações

Em Integração → Importações (e nos ecrãs de leads e clientes) importa dados de folhas de cálculo: associa as colunas aos campos, corre uma simulação para ver erros e duplicados e confirma.

Estado do sistema

O pedido público GET /status devolve o estado atual da API, da base de dados, do armazenamento de ficheiros e do envio de email, o histórico diário dos últimos 90 dias e os incidentes recentes. É o que alimenta a página Status do sistema.

Consultar o estado
curl https://app-api.onclickwise.com.br/status
Instalação

Nuvem ou servidores próprios

Na nuvem, a OnclickWise trata do alojamento, das cópias de segurança e das atualizações. Numa instalação própria, a plataforma corre na infraestrutura da organização, com os mesmos módulos e atualizações.

  • Componentes: aplicação web, API e base de dados PostgreSQL.
  • Email: configure um servidor SMTP para recuperação de palavra-passe e respostas automáticas por email.
  • Ficheiros: guardados no servidor da API, na pasta de uploads.
Fale com a nossa equipa para planear uma instalação própria: dimensionamento, cópias de segurança e atualizações.

Ainda precisa de ajuda?

A nossa equipa responde pelo formulário de contacto ou pelo WhatsApp, em português, espanhol, francês e inglês.