---
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

1. **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.

2. **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.

3. **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.

4. **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.

5. **Crie a rotina com os parâmetros.**
   - Use a ferramenta de criação de rotinas do OpenBot com nome, intervalo, fuso horário, `limitPolicy: skip` e `missedPolicy: skip`.
   - Instrução: copie o texto do arquivo da instrução exatamente como está, sem o título da seção.
   - Motivo: `skip` evita acúmulo de execuções atrasadas.

6. **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.

7. **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.
