Moodle e LTI 1.3
Cursos e inscrições do Moodle a partir do Wise Ed, e o Wise Ed dentro de um curso no Moodle, Canvas, Brightspace ou Blackboard. As notas que voltam são mapeadas por uma pessoa.
A plataforma
Integrações
O Wise Ed fala com os sistemas que uma escola já usa: o seu programa de contabilidade, a sua plataforma de aprendizagem, os seus formulários web e automatizações, o seu banco. Cada via de entrada passa pelas mesmas portas e regras dos ecrãs da própria secretaria, e os dados pessoais só saem até onde a escola permite.
- As escritas passam pelos módulos, nunca à sua volta
- A escola decide que dados pessoais podem sair
- Registos de saúde, apoio e adaptações nunca saem
A API pública
Para um ERP, um conector bancário, um formulário web ou os scripts da própria escola: um sistema sem ninguém para iniciar sessão recebe uma chave. A API pública faz parte da licença.
A documentação acompanha a chave.
- Chaves que a própria escola cria, no ecrã “Chaves API” da secretaria: com nome, mostradas uma vez quando criadas e guardadas apenas como hash, e revogadas a partir da chamada seguinte.
- Âmbitos por chave: estudantes, inscrições, cursos, disciplinas, notas, faturas, pagamentos e contactos do CRM, cada um para leitura ou, onde faz sentido, para escrita.
- Limites por chave: uma data de validade, uma lista de endereços e intervalos permitidos, uma limitação a alguns campi e um limite de frequência — 120 chamadas por minuto, a menos que a escola defina outro.
- Um registo de chamadas. Cada chamada é uma linha que a escola pode ler, com a chave que a fez, e cada escrita fica no histórico do próprio módulo como “API:” e o nome da chave.
- As escritas passam pelos módulos. Um estudante, uma inscrição, um pagamento ou um contacto do CRM é guardado pelo mesmo código que a secretaria usa, com as mesmas verificações. Um pagamento da contabilidade é associado à sua fatura como uma linha de extrato bancário.
- Também se podem escrever notas, em registos de exame, acrescentadas e nunca substituídas, com um ensaio que responde exatamente o que a chamada real responderia.
- Verifica-se, não se recusa — para um programa. Onde a secretaria seria questionada, a API responde com as mesmas perguntas e não guarda nada; a mesma chamada, confirmada com um motivo, guarda.
- “O que mudou desde” para cada lista, incluindo eliminações, para que outro sistema se mantenha em sintonia sem voltar a ler tudo.
Zapier
Para as automatizações da própria secretaria: uma nova candidatura numa folha de cálculo, um pedido decidido numa conversa de equipa.
- A funcionária liga-se como ela própria, com OAuth 2. A ligação leva a sua escola e os seus direitos, relidos em cada chamada: uma funcionária que perde o ecrã de candidaturas deixa de receber candidaturas por Zap no mesmo minuto. Pode cortar a ligação com um clique.
- Nove eventos: uma nova candidatura, o estado de uma candidatura alterado, uma nova inscrição, um novo pedido, um pedido decidido, uma nova nota, um diploma emitido, um novo contacto do CRM, uma nova fatura — cada um com filtros opcionais.
- Ações: criar uma candidatura, criar ou atualizar um contacto do CRM, acrescentar uma nota a um estudante, enviar uma mensagem a um estudante. Pesquisas: encontrar um estudante, uma candidatura, um curso ou um contacto do CRM.
- Disponível a pedido. O Wise Ed no Zapier é por agora uma integração privada; uma escola pede-nos o convite.
Webhooks
- Os mesmos eventos, para o recetor da própria escola — Make, n8n, Power Automate ou o seu próprio servidor — indicado no ecrã de Integrações da secretaria.
- Cada entrega é assinada com HMAC-SHA256 sobre uma marca temporal e o corpo, com um segredo que só a escola possui, mostrado uma vez quando é criado.
- Entregue, ou tentado de novo durante grande parte de um dia; um recetor que continua a falhar é suspenso com uma nota a dizer porquê. Cada entrega fica listada, pode ser aberta e enviada de novo.
- Nada do passado é repetido. Um recetor recebe o que acontece depois de ter sido configurado.
- Só endereços https na internet. Um endereço dentro da rede da escola ou da nossa é recusado.
O que pode sair do Wise Ed
Um só ecrã decide que dados pessoais saem por Zapier e webhooks, para todos os recetores de uma vez.
- Dados de contacto e linhas de fatura saem por defeito; morada, dados de nascimento e os números de identificação nacional e fiscal não, nem as respostas de um pedido, até a escola os ativar.
- Ativar a identificação nacional é perguntado primeiro, nomeando as regras de proteção de dados. A escola decide, e o registo diz quem.
- Uma opção desligada retira os campos, em vez de os enviar vazios, para que um bom endereço de e-mail no sistema recetor nunca seja substituído por nada.
- Nunca, e não é uma definição: registos de saúde, apoio, adaptações e disciplinares, palavras-passe e chaves. O código que constrói o que é enviado nem sequer lê essas tabelas.
As outras ligações
Contabilidade (ERP)
Em Finanças: as faturas, linhas, pagamentos e saldos em aberto de um período com as contas e centros de custo da escola, no formato que o seu programa lê.
Início de sessão Microsoft
Os estudantes iniciam sessão com a conta Microsoft da escola, onde esta a usa; os pais com qualquer conta Microsoft cujo endereço a Microsoft confirme.
Mensagens de texto
Através de um gateway HTTP genérico, Twilio ou Infobip, com um limite mensal e horas de silêncio. Desligadas até a escola as ativar; ver mensagens.
Extratos bancários
Extratos em camt.053 associados às faturas pela referência, um número de fatura no texto, depois o valor e o nome. Pagamentos de apoios como ficheiro de pagamento SEPA.
Faturas eletrónicas
Uma fatura como fatura eletrónica no formato nacional, descarregada como XML, no formato do país da escola.
Perguntas sobre integrações
A API pública custa algo extra?
Não. A API pública faz parte da licença. A escola cria as suas próprias chaves; a documentação acompanha a chave.
O nosso programa de contabilidade pode enviar pagamentos de volta?
Sim, pela API ou como ficheiro através da importação. Um pagamento é associado à sua fatura como uma linha de extrato bancário, e um já registado é deixado em paz.
Quem pode ver o que faz um Zap?
Cada chamada através de uma ligação é da pessoa que se ligou, registada em seu nome. O ecrã de Integrações lista quem se ligou, desde quando e quantos Zaps estão à escuta.
O Wise Ed está no diretório público do Zapier?
Ainda não. Está disponível a pedido como integração privada; peça-nos o convite.
Uma chave pode ser limitada a um campus?
Sim. Uma chave limitada a alguns campi lê e escreve apenas os estudantes desses campi, e um estudante fora deles não existe para essa chave.
Veja o Wise Ed na sua escola
Marque uma apresentação online. Mostramos como funciona hoje a sua secretaria académica e o mesmo trabalho no Wise Ed, com os seus programas, não com dados de demonstração.