- name
- Rotinas OpenBot com intervalo
- description
- Cria ou ajusta rotinas recorrentes no OpenBot, com intervalo mínimo de 3 minutos e vigilância curta a cada ~20 segundos para respostas rápidas. Use ao agendar tarefas periódicas, como monitorar uma fila e responder clientes.
Objetivo
Criar rotinas no OpenBot que rodam em intervalo fixo e, quando há trabalho, reagem em segundos por uma janela curta.
Procedimento
- Confirme o intervalo antes de criar.
- Use no mínimo 3 minutos, ou agenda diária, semanal ou cron.
- Intervalos menores são recusados na criação, então não tente criar com 2 minutos ou menos.
- Se o usuário pedir um intervalo menor, use 3 minutos e avise que foi ajustado, explicando o motivo.
- Para reação rápida, use vigilância dentro do script, não intervalo menor.
- Faça o script consultar a fila a cada ~20 segundos durante uma janela limitada (ex.: 5 minutos).
- Quando houver item, processe e reinicie a janela.
- Ao fim da janela sem nada, encerre o script. Assim o intervalo normal de 3 minutos volta a valer.
- Motivo: o agendador não aceita intervalo curto, mas o script pode ficar ativo dentro de uma execução.
- Teste o script antes de criar a rotina.
- Rode-o com a ferramenta de shell do projeto, passando o caminho do script como argumento.
- Esperado: saída vazia e código de saída 0 quando a fila está vazia.
- Motivo: confirma que a chave e a API funcionam antes de a rotina rodar sozinha.
- Verifique a chave de acesso sem expô-la.
- Confirme que a chave está no cofre local antes de criar a rotina.
- Se a chave faltar ou for recusada, não a exiba nem a grave em arquivo temporário. Peça ao usuário para restaurá-la com o script de instalação da pasta, ou para aplicar o passo no servidor se for necessário.
- Motivo: uma chave ausente faz cada execução falhar e gerar avisos repetidos.
- Crie a rotina com os parâmetros.
- Use a ferramenta de criação de rotinas do OpenBot com nome, intervalo, fuso horário,
limitPolicy: skipemissedPolicy: skip. - Instrução: copie o texto do arquivo da instrução exatamente como está, sem o título da seção.
- Motivo:
skipevita acúmulo de execuções atrasadas.
- Use a ferramenta de criação de rotinas do OpenBot com nome, intervalo, fuso horário,
- Mantenha o arquivo e a rotina sincronizados.
- Ao alterar a instrução no arquivo, atualize também a instrução da rotina.
- Ao alterar o intervalo, atualize o arquivo de documentação para o mesmo valor.
- Motivo: o arquivo não altera a rotina sozinho, e divergências causam comportamento inesperado.
- Informe o resultado ao usuário.
- Diga o identificador da rotina, o intervalo efetivo e o horário da próxima execução.
- Diga se o intervalo foi ajustado.
Cuidados
- Execuções sobrepostas: se uma execução começar enquanto outra ainda está na janela de vigilância, as duas podem ler a mesma fila. Torne o processamento idempotente, por exemplo marcando o item como respondido antes de enviar, para evitar resposta duplicada.
- Clientes reais: uma rotina que responde clientes passa a agir assim que é criada. Avise o usuário disso antes de ativar.
- Pausa: se o usuário pedir pausa, desative a rotina em vez de apagá-la. Assim pode ser reativada sem recriar.
- Falhas silenciosas: o histórico de execuções pode não estar disponível. Sem ele, a primeira execução real com conteúdo na fila é a única prova de que funcionou; informe isso ao usuário.
Como verificar
- O teste manual do script retorna saída 0.
- A rotina aparece ativa com o intervalo esperado e o fuso correto.
- Após a primeira execução com item real na fila, confirme a resposta enviada e o encerramento da janela.
- Não afirme que a rotina funciona sem essa verificação; diga o que foi testado e o que não foi.