Agendamentos
Um agendamento inicia sozinho um script ou flow publicado — a cada cinco minutos, todo dia útil às 9:00, todo dia 1º — com entradas definidas uma vez. A página Agendamentos lista todos, e o painel lateral conta qualquer período: o que rodou, o que falhou, o que nem chegou a iniciar e por quê.
- Criar um agendamento com o assistente O quê · Quando · Se falhar · Revisar
- Escolher a frequência, a expressão cron e o fuso certos
- Decidir o que acontece na sobreposição e na falha
- Ler a visão geral: tendência, rankings, horários de pico e confiabilidade
Como os agendamentos rodam
A API do Waiso procura agendamentos vencidos a cada 30 segundos. Um agendamento vencido vira uma execução comum da versão publicada do alvo — os mesmos logs, a mesma saída e a mesma linha na página Execuções de uma execução iniciada à mão, marcada com Disparado por Agendamento. Ninguém precisa estar conectado. Publicar uma correção muda o que o próximo disparo roda; editar o rascunho não muda.
Todo disparo fica registrado, tenha ele iniciado uma execução ou não. Se a API estava fora do ar na hora de um agendamento, ele dispara uma vez quando a API volta e segue o horário dali em diante — os horários perdidos não são repetidos um a um. Se nenhum worker estiver livre, a execução espera na fila como qualquer outra.
Crie um com o assistente
- O que deve rodar?
Clique em Novo Agendamento e escolha um script ou flow. Só os publicados podem rodar sozinhos — os outros aparecem como Não publicado. Se ele recebe entradas, preencha: estes valores vão em toda execução; uma obrigatória vazia segura o salvamento (Preencha … para salvar.).
- Quando deve rodar?
Escolha uma frequência (próxima seção), defina o horário e o Fuso horário, e leia Próximas execuções: na prévia antes de seguir.
- Se algo der errado
Opcional — clique em Pular, ou defina Tentar de novo ao falhar, a regra de sobreposição e Executar ao falhar (veja abaixo).
- Revisar
Dê um nome, mantenha Ligar agora ligado (ou desligue para criar pausado) e clique em Criar agendamento. Ele aparece como Ativo, com a Próxima Execução.
O menu de cada linha tem Editar (o mesmo assistente, com todas as etapas abertas), Pausar / Retomar e Apagar. Um agendamento pausado mantém todas as configurações e não mostra próxima execução. Clicar numa linha abre os detalhes: fuso, política de execução, o que fazer em caso de falha e as execuções recentes com resultado, horário e duração.
Frequências, cron e fusos
| Frequência | Você define | Igual ao cron |
|---|---|---|
| A cada N min | Rodar a cada 1 a 59 minutos (padrão 5) | */15 * * * * |
| Por hora | No minuto — roda às 9:00, 10:00, 11:00… | 0 * * * * |
| Diário | Às um horário | 30 7 * * * |
| Semanal | Nos dias + Às | 0 9 * * 1-5 |
| Mensal | No dia … do mês + Às | 0 6 1 * * |
| Personalizado | Uma Expressão cron | — |
# min hour day month weekday
*/10 8-18 * * 1-5 # every 10 minutes, 08:00–18:59, Monday to Friday
0 0 1 1,4,7,10 * # midnight on the first day of each quarter
30 23 * * 0 # Sundays at 23:30Uma expressão cron tem cinco campos e é lida no fuso do agendamento, nunca no do seu navegador. Uma inválida é recusada com Expressão inválida — verifique a sintaxe (min hora dia mês dia-semana), e a Prévia não disponível para cron personalizado — confira as primeiras execuções na lista depois de salvar. O fuso começa como o do seu navegador (ou UTC); um agendamento em America/Sao_Paulo às 09:00 roda às 09:00 de lá o ano inteiro, faça o horário de verão o que fizer em outros lugares.
Sobreposição, novas tentativas e Executar ao falhar
- Se a execução anterior deste agendamento ainda estiver ativa: Pular — esperar terminar (o padrão) pula aquele disparo e registra o motivo; Rodar em paralelo inicia mesmo assim.
- Tentar de novo ao falhar: uma execução que falhou começa de novo na hora, até esse número de vezes (no máximo 10). A revisão diz Se falhar, tenta de novo 2×.
- Executar ao falhar inicia outro script ou flow quando este agendamento falha — uma limpeza, um job de recuperação. Para mensagens a pessoas, use os Alertas, que não precisam de código.
- O limite Execuções ao mesmo tempo do próprio item (aba Gatilhos) continua valendo: uma execução agendada a mais espera na fila.
O painel de visão geral
O painel da direita lê um período — Hoje, 7d, 30d, Todo período ou Personalizado… — e todos os números dele somam os mesmos totais. Ele se atualiza sozinho conforme os agendamentos disparam (Ao vivo), no máximo a cada 30 segundos.
| Cartão | O que mostra |
|---|---|
| Tendência | Execuções por dia em três séries — com sucesso, com falha, não iniciaram — e a taxa de falha comparada ao período anterior (Falhas caíram 4 pontos em relação ao período anterior). Uma semana travada nunca aparece como 0% de falha. |
| Mais executados · Mais falham | Os agendamentos mais ativos e os que mais falham — ranqueados por taxa só com 5 ou mais execuções concluídas. Uma linha abre o agendamento. |
| Quando executa | Execuções por dia da semana e por hora, no seu horário: Pico: seg · 09:00 (seu horário). |
| Confiabilidade | Disparos que não iniciaram, por motivo, com os agendamentos de cada um; Atrasados (mais de 1 min), com o atraso típico e o pior. |
| Próximas 24 h | Quantos disparos estão previstos e o horário de pico à frente. |
Por que um disparo não iniciou
| Motivo | O que fazer |
|---|---|
| não há o que executar | O alvo foi apagado. Escolha outro alvo. |
| sem versão publicada | Publique o script ou flow; o próximo disparo inicia. |
| as entradas salvas não servem | Os parâmetros mudaram. Edite as entradas do agendamento. |
| a execução anterior ainda estava ativa | Esperado com Pular; escolha Rodar em paralelo para deixar sobrepor. |
| não foi possível enfileirar | Recusado ao entrar na fila — muitas vezes falta de créditos. Execute à mão para ver o erro. |
| o projeto está congelado · a licença precisa de atenção | Acima dos limites do plano, ou uma licença de instalação própria para instalar. |
Limites
- O seu plano define o menor intervalo; o formulário mostra isso ao lado do intervalo (Seu plano executa agendamentos no máximo a cada 15 min., com Ver planos).
- Os disparos ficam guardados por 30 dias (Contado desde … — os disparos ficam guardados por 30 dias); as execuções continuam na página Execuções. Apagar um agendamento mantém as execuções passadas nos números.
- Como os agendamentos vencidos são conferidos a cada 30 segundos, uma execução pode começar até cerca de meio minuto depois do horário; só mais de um minuto conta como atraso.