Pular para o conteúdo principal

⏰ SmartFlows Agendados

O Gatilho de SmartFlow Agendado é projetado para executar fluxos de trabalho automaticamente com base em um cronograma predefinido. Ele oferece flexibilidade para definir intervalos recorrentes, gerenciar exclusões (por exemplo, finais de semana) e garantir que os fluxos de trabalho sejam executados sem problemas em horários especificados.

📝 Detalhes do Gatilho​

Nome: Scheduled SmartFlow
Categoria: Gatilhos

🔧 Parâmetros​

1. Intervalo de Recorrência​

  • Tipo: string
  • Descrição: Define a frequência da execução do fluxo de trabalho.
  • Opções:
    • diário
    • semanal
    • mensal
  • Obrigatório: Sim
  • Exemplo: 
    "semanal"

2. Hora de Execução​

  • Tipo: time
  • Descrição: A hora específica em que o fluxo de trabalho deve ser acionado.
  • Obrigatório: Sim
  • Exemplo: 
    "08:30"

3. Data de Início​

  • Tipo: date
  • Descrição: O primeiro dia em que o SmartFlow deve começar a ser executado.
  • Obrigatório: Sim
  • Exemplo: 
    "2025-01-15"

4. Excluir Fins de Semana​

  • Tipo: boolean
  • Descrição: Indica se o fluxo de trabalho deve pular os fins de semana.
  • Obrigatório: Opcional
  • Valor Padrão: false
  • Exemplo: 
    true

5. Variáveis​

  • Tipo: object
  • Descrição: Variáveis passadas para o SmartFlow no momento da execução.
  • Obrigatório: Opcional
  • Exemplo: 
    {
      "emailReminder": "true",
      "reportType": "weekly"
    }

🚀 Como Funciona​

  1. Definir Agenda:

    • Configure a frequência (diária, semanal, mensal) e especifique a data de início.
    • Parâmetros opcionais, como excluir finais de semana e definir variáveis, podem refinar a execução.

  2. Processo de Execução:

    • No horário agendado, o SmartFlow inicia o fluxo de trabalho.
    • Variáveis definidas no gatilho são automaticamente passadas para o fluxo de trabalho.

  3. Gerenciamento Recorrente:

    • O SmartFlow continuará executando conforme o intervalo definido até ser cancelado.

  4. Visualizando Fluxos de Trabalho Agendados:

    • O botão Ver Agendados na página principal do SmartFlow permite que os usuários vejam todas as agendas ativas.
    • Os usuários podem cancelar qualquer SmartFlow agendado conforme necessário.

💡 Casos de Uso​

1. Relatórios Automatizados​

  • Cenário: Gerar relatórios de vendas semanais.
  • Configuração:
    • Recorrência: weekly
    • Hora: 09:00
    • Variáveis: 
      {
        "reportType": "sales",
        "period": "lastWeek"
      }

2. Notificações de Lembrete​

  • Cenário: Enviar lembretes diários para tarefas em atraso.
  • Configuração:
    • Recorrência: daily
    • Hora: 10:00
    • Excluir Fins de Semana: true

3. Backups Mensais de Dados​

  • Cenário: Automatizar backups de dados no primeiro dia de cada mês.
  • Configuração:
    • Recorrência: monthly
    • Hora: 02:00

🔍 Exemplo de Fluxo de Trabalho​

Nesta configuração:

  • O fluxo de trabalho está agendado para ser executado toda segunda-feira às 8:00 AM.
  • Finais de semana são excluídos.
  • Uma variável emailReminder é passada com o valor true.
{
  "recurrence": "weekly",
  "time": "08:00",
  "startDate": "2025-01-15",
  "excludeWeekends": true,
  "variables": {
    "emailReminder": true
  }
}

A cada execução, o SmartFlow avalia o cronograma e pula os dias não úteis, se configurado.

Dentro do fluxo, você também pode visualizar a lógica do cronograma. Por exemplo:

🛠️ Dicas​

  1. Depuração de Fluxos Agendados:

    • Verifique regularmente a seção Ver Agendados para garantir que os agendamentos estão configurados corretamente.
    • Cancele fluxos de trabalho desatualizados que não se aplicam mais.

  2. Controle de Variáveis:

    • Use variáveis dinamicamente em seus fluxos de trabalho para tornar os agendamentos adaptáveis a requisitos em mudança.

  3. Testando Intervalos:

    • Antes de implantar, teste com intervalos mais curtos para confirmar a correção da lógica.