Disparador: Agendado (tempo / cron)

O disparador Agendado executa um workflow de acordo com uma expressão cron definida por você — não depende de nenhum evento da caixa de entrada nem de um contato, roda no horário que você configurar.

Quando usar

É o disparador certo para tudo o que é recorrente: um resumo diário de conversas pendentes, um relatório semanal para a equipe, uma checagem periódica de negócios sem atividade, ou qualquer automação que precise rodar "sozinha" em determinado intervalo.

Configuração

No nó Disparador, escolha "Agendado" e preencha:

• Expressão cron (obrigatório): por exemplo 0 9 * * 1 para "toda segunda-feira às 9h", ou 0 8 * * * para "todo dia às 8h". ⚠️ Esse horário é avaliado em UTC do servidor, não no fuso horário do seu workspace (veja Dicas).

Variáveis disponíveis

• $scheduled.execution_time (timestamp da execução)
• $scheduled.iteration — ⚠️ hoje sempre vale 0: o sistema não mantém um contador real de execuções por workflow, então não a use para lógica de "uma vez a cada N execuções" como o nome pode sugerir.

Exemplo

Workflow "Resumo semanal para o Team": Disparador = Agendado, cron = 0 9 * * 1. Ação: consultar as conversas abertas da semana e publicar uma mensagem resumo no Espaço "Gerência" do Team.

Dicas

• O cron roda em UTC do servidor, não no fuso horário configurado no seu workspace — converta manualmente o horário que você quer (por exemplo, se seu workspace está em UTC-5 e você quer que rode às 9h local, configure 0 14 * * 1, não 0 9 * * 1).
• Se precisar de um vocabulário mais moderno para receitas de CRM/Projetos, existe o disparador equivalente "Agendado (tempo)" na categoria Tempo — funciona exatamente igual.
• Não use $scheduled.iteration para lógica de "a cada N execuções": hoje sempre chega em 0. Se precisar desse contador, controle você mesmo por outro meio (por exemplo, um campo persistente que você atualiza a cada execução).

Solução de problemas

• Se o workflow não rodar no horário esperado, revise a sintaxe do cron (5 campos: minuto hora dia-do-mês mês dia-da-semana), confirme que o workflow está ativo (não em rascunho), e lembre-se de que o horário é avaliado em UTC, não no fuso horário do seu workspace.
• Se sua lógica baseada em {{$scheduled.iteration}} não funcionar como esperado (por exemplo, tentando rodar "a cada 3ª execução"): é um problema conhecido, essa variável nunca incrementa, sempre vale 0.