Nota sobre funcionalidade
Enviar por e-mail horários semanais aos docentes
Um docente não deveria ter de ir consultar. Uma vez por semana, chega-lhe a sua própria semana — e desde a versão de 2026 é a escola que escreve a carta, sem nos escrever a nós.
Uma carta por pessoa, não um horário para todos
Um horário que é publicado não é um horário que foi lido.
A forma fiável de chegar a um docente é a caixa de correio que já tem aberta, e a forma fiável de ser lido é a carta tratar dele e de mais ninguém.
Assim, o e-mail agendado percorre a lista de docentes, uma pessoa de cada vez. Cada carta leva a semana desse docente em PDF, gerado no momento do envio e não retirado de um ficheiro que alguém exportou em setembro, e uma ligação que abre o horário dele exatamente na semana a que a carta diz respeito. Um docente sem nada agendado nessa semana é ignorado, em vez de receber uma página vazia.
Estão disponíveis duas tarefas, configuradas separadamente: o horário da próxima semana, normalmente enviado numa quinta ou sexta-feira à tarde, e o horário desta semana, normalmente enviado numa segunda-feira de manhã. A maioria das instituições executa só a primeira; a segunda justifica-se onde o horário ainda se altera durante a semana.
A escola escreve a carta e altera-a sem pedir a ninguém
O que mudou na versão de 2026 foi quem é dono das palavras.
Os assuntos, as cartas de apresentação, o dia e a hora de envio eram configuração no nosso servidor, e alterar uma frase significava escrever-nos. Agora vivem na base de dados da própria escola e são editados no site de horários da própria escola, em Definições ▸ Notificações, por quem tenha direitos de administrador de configuração.
Por tarefa: se envia, em que dia, a que hora e para que semana. Por idioma: um assunto, um modelo de ligação e a própria carta em HTML. Um docente recebe a carta no seu idioma quando esta foi escrita, e recorre ao texto geral quando não foi — incluindo um bloco próprio para docentes sem idioma registado, que costumam ser as pessoas a quem uma instituição mais quer dirigir-se em inglês.
A carta é composta a partir de marcadores, pelo que um só texto serve todos: o nome e o código do docente, o número da semana, a segunda-feira em que a semana começa e a ligação para o seu próprio horário são preenchidos à medida que a carta é construída.
- A caixa de correio da própria escola está no mesmo separador, e a sua palavra-passe nunca regressa. Em Correio, uma escola pode enviar em nome próprio — o seu próprio endereço na linha De — ou manter a nossa caixa e acrescentar um endereço de resposta, o que não precisa de palavra-passe nenhuma. Uma palavra-passe, uma vez guardada, é selada com uma chave que existe apenas no nosso servidor e nunca volta a ser mostrada, nesse ecrã ou noutro lugar. A ligação à base de dados permanece na configuração do servidor.
- Por agora a carta semanal ainda sai da caixa de correio do Wise Timetable. As cartas de reservas e as cartas que os planeadores enviam a partir do ambiente de trabalho já utilizam a caixa de correio da própria escola; a carta semanal passa para o mesmo caminho com a próxima versão do servidor de correio. De quem vêm as cartas tem a escolha completa.
- “— unchanged —” não é um espaço em branco. É o valor inicial para uma escola que acabou de ser ativada, e significa que esta definição ainda é respondida pela configuração do nosso servidor. Até alguém definir deliberadamente um dia e uma hora, nada no envio de correio da escola mudou.
- As tarefas não são criadas no website. Só a configuração do servidor sabe que uma tarefa existe, pelo que a primeira execução após a atualização escreve a linha e o ecrã apenas edita o que já lá está.
Uma carta de teste real, antes de trezentas pessoas a receberem
Uma pré-visualização num navegador não é um ensaio.
O Outlook apresenta HTML com o motor do Word e um navegador não, e os dois não concordam. Por isso o ecrã tem um campo para um endereço e o servidor envia uma carta real para lá na sua passagem seguinte — um docente real, o seu horário real, o seu PDF real, todos os marcadores expandidos exatamente como serão — e depois volta a esvaziar o campo. Uma caixa preenchida significa pendente; uma caixa vazia significa nada à espera; limpar a caixa cancela um teste que ainda não saiu.
E após cada execução real segue um breve resumo para um endereço designado: quantos docentes foram verificados, quantas cartas saíram e — a parte que vale a pena ler — se o servidor de correio recusou alguma. Uma carta recusada é quase sempre um endereço errado na lista de docentes, que é como um erro de escrita é detetado na primeira semana e não na décima primeira.
- Um teste nunca interrompe uma execução real. Se for pedido durante a hora de envio da própria tarefa, espera pela passagem seguinte em vez de reduzir a execução real a uma só carta.
- Não é enviado resumo de execução para um teste. “Verificámos 700 docentes” depois de uma só carta é uma frase que uma pessoa arquivaria e em que ninguém acreditaria.
- Demora até uma hora. A tarefa é uma passagem horária, não um botão.
Porque é que uma tarefa definida para as 14:00 pode sair às 14:20, e porque é isso correto
A tarefa de fundo acorda uma vez por hora, contada desde a última vez que o servidor foi iniciado e não desde o início da hora do relógio. Em cada despertar volta a ler a sua configuração — pelo que uma alteração guardada no website é apanhada na passagem seguinte, sem nada para reiniciar — e depois faz uma pergunta: é este o dia configurado e a hora configurada? Se for, recarrega o horário a partir da base de dados e envia.
Daqui decorrem duas consequências, e ambas já causaram um e-mail de perplexidade. Uma tarefa configurada para as 14:00 sai dentro da sua hora, não no início dela. E uma alteração guardada cinco minutos antes da hora de envio entra nessa execução — não há recarregamento separado, e não há forma de recolher uma carta que já saiu.
De uma carta semanal para um calendário que nunca fica desatualizado
Uma carta é uma fotografia. Está certa quando é enviada e continua exatamente tão certa depois, que é a única coisa que um horário não pode prometer.
Assim, a carta pode levar um endereço de subscrição para esse docente em particular — um marcador, uma frase sob o botão — que o Outlook, o Google Calendar e o Apple Calendar reconhecem como algo a subscrever e não a descarregar.
A carta semanal continua a chegar; o calendário por trás deixa de ser uma fotografia e passa a acompanhar o horário por si. Como funcionam as subscrições de calendário trata da outra metade, e as ligações de reunião em linha explicam como um endereço de acesso chega à carta e à entrada do calendário.
Os manuais
Todos os campos do separador, a lista completa de marcadores, o que o resumo da execução lhe diz e o que o separador não pode alterar. Gratuito e sem restrições, como todos os outros documentos deste site.
- Guia das notificações (PDF, 10 páginas)O separador Notificações completo: de quem vêm as cartas e para onde vão as respostas, a caixa de correio da própria escola, as duas tarefas semanais, a carta por idioma, todos os marcadores, a carta de teste e o resumo da execução — e as cartas de reservas no mesmo separador.
- Subscrições de calendário (PDF, 7 páginas)A outra metade da história: o que um docente ou uma sala obtém de um endereço de subscrição, como as duas formas diferem e com que frequência uma aplicação de calendário realmente o relê.
Quer ver isto a funcionar?
Marque uma apresentação online de 45 minutos e percorreremos a solução com base no problema de planeamento de horários da sua própria instituição.