Gatilho agendado (cron / horário)

O gatilho Agendado (cron) executa uma automação em um horário recorrente sem ninguém iniciá-la. Ideal para relatórios, lembretes e tarefas que se repetem.

Jun 26, 2026

Veja este passo no vídeo · Agendados e webhook recebido

O gatilho Agendado (cron) executa uma automação em um horário recorrente, sem que ninguém precise iniciá-la. É a base para relatórios diários, lembretes periódicos, reativações e qualquer tarefa que deva se repetir "toda segunda às 9" ou "no dia 1 de cada mês".

Diferente de gatilhos como Mensagem recebida, o gatilho agendado não traz uma conversa nem um contato consigo: ele dispara sozinho, pelo relógio. Por isso, os nós que enviam mensagens precisam que você indique explicitamente para quem escrever.

Requisitos

  • Disponível em todos os planos (a partir do Lite), com uma cota mensal de execuções de workflows conforme o seu plano.
  • Permissão para administrar Workflows no seu workspace.

Passos

  1. Vá em Configurações → Fluxos de trabalho e clique em Criar workflow (ou edite um existente).
  2. No quadro, clique em Adicionar gatilho.
  3. Escolha Agendado (cron) na lista de gatilhos do sistema.
  4. Em Expressão cron digite os 5 campos padrão min hora dia mês dia-semana. Exemplos:
    • 0 9 * * 1 → toda segunda-feira às 9:00.
    • 0 8 * * * → todos os dias às 8:00.
    • */15 * * * * → a cada 15 minutos.
    • 0 9 1 * * → no dia 1 de cada mês às 9:00.
  5. Adicione seus nós de ação. Como não há conversa de origem, em um nó Enviar mensagem defina o destinatário (por exemplo, uma transmissão para um segmento ou um aviso ao Team). Você pode usar as variáveis {{$scheduled.execution_time}} e {{$scheduled.iteration}} no texto.
  6. Ative o workflow com o botão no topo.

Verificação

A Omnifox revisa os workflows agendados a cada minuto, então na próxima coincidência com seu cron ele dispara sozinho. Para não esperar, use o botão Testar do editor e abra o histórico em Execuções: ali você verá a data, o status e os nós percorridos.

Se não funcionar

  • Não dispara: confirme que o workflow está Ativo e que a expressão cron é válida (5 campos). Veja o auxiliar Cron gerado abaixo do campo.
  • Hora errada: o cron roda no fuso horário do seu workspace; ajuste os valores se sua operação está em outro fuso.
  • A mensagem não sai: lembre que este gatilho não tem contato. Um nó Enviar mensagem sem destinatário explícito não tem para quem escrever.

Dica: evite expressões muito frequentes (como * * * * *) se o fluxo faz trabalho pesado; a cada minuto pode acumular execuções. Comece com uma vez por dia e ajuste.

Dica: um workflow aceita apenas um gatilho. Se precisar do mesmo processo em dois horários diferentes, crie outro workflow agendado que chame este com um nó Chamar workflow.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp