Conecta-seEntrar na plataforma

Agendamento

Iniciar a execução automaticamente nos dias e horários programados.

Gatilhos de inícioRecurso internoConexão: Sem conexão externa obrigatória

O que faz

Integre o agendamento ao fluxo. Permite disparar um fluxo de acordo com uma programação de horários.

Quando usar: Use quando o seu fluxo precisar iniciar a execução automaticamente nos dias e horários programados.

Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.

Antes de começar

Conexão necessária: Sem conexão externa obrigatória.

Nenhuma conta externa é obrigatória para usar este bloco.

Passo a passo

  1. Adicione Agendamento ao desenho a partir da seção Gatilhos da aba Blocos.
  2. Nenhuma conta externa é obrigatória para usar este bloco.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Frequência

    ObrigatórioModo gatilho

    Define a data, o horário ou a programação usada pela operação.

    Opções:
    A cada X minutos · A cada hora · Diariamente · Semanalmente · Mensalmente · Personalizado (cron)
    Padrão:
    Diariamente
    Exemplo:
    A cada X minutos

  • Intervalo (minutos)

    Obrigatório conforme a operaçãoModo gatilho

    De quantos em quantos minutos o fluxo deve rodar (ex.: 15 para quatro vezes por hora).

    Quando aparece:
    Quando o campo “Frequência” for “A cada X minutos”
    Exemplo:
    15

  • Minuto

    Obrigatório conforme a operaçãoModo gatilho

    Em que minuto de cada hora o fluxo roda, de 0 a 59 (ex.: 30 roda às 8h30, às 9h30 e assim por diante).

    Quando aparece:
    Quando o campo “Frequência” for “A cada hora”
    Exemplo:
    30

  • Horário

    Obrigatório conforme a operaçãoModo gatilho

    Define a data, o horário ou a programação usada pela operação.

    Quando aparece:
    Quando o campo “Frequência” for “Diariamente”
    Exemplo:
    09:00

  • Dia da semana

    Obrigatório conforme a operaçãoModo gatilho

    Escolhe uma das opções aceitas por este campo.

    Quando aparece:
    Quando o campo “Frequência” for “Semanalmente”
    Opções:
    Segunda-feira · Terça-feira · Quarta-feira · Quinta-feira · Sexta-feira · Sábado · Domingo
    Exemplo:
    Segunda-feira

  • Horário

    Obrigatório conforme a operaçãoModo gatilho

    Define a data, o horário ou a programação usada pela operação.

    Quando aparece:
    Quando o campo “Frequência” for “Semanalmente”
    Exemplo:
    09:00

  • Dia do mês

    Obrigatório conforme a operaçãoModo gatilho

    Dia do mês em que o fluxo roda, de 1 a 31 (ex.: 5 para rodar todo dia 5).

    Quando aparece:
    Quando o campo “Frequência” for “Mensalmente”
    Exemplo:
    5

  • Horário

    Obrigatório conforme a operaçãoModo gatilho

    Define a data, o horário ou a programação usada pela operação.

    Quando aparece:
    Quando o campo “Frequência” for “Mensalmente”
    Exemplo:
    09:00

  • Expressão cron

    Obrigatório conforme a operaçãoModo gatilho

    Define a data, o horário ou a programação usada pela operação.

    Quando aparece:
    Quando o campo “Frequência” for “Personalizado (cron)”
    Exemplo:
    0 9 * * 1-5

  • Fuso horário

    Modo gatilho

    Define a data, o horário ou a programação usada pela operação.

    Opções:
    UTC · EUA - Pacífico (UTC-8) · EUA - Montanha (UTC-7) · EUA - Central (UTC-6) · EUA - Leste (UTC-5) · EUA - Alasca (UTC-9) · EUA - Havaí (UTC-10) · Canadá - Toronto (UTC-5) · Canadá - Vancouver (UTC-8) · Cidade do México (UTC-6) · São Paulo (UTC-3) · Buenos Aires (UTC-3) · Londres (UTC+0) · Paris (UTC+1) · Berlim (UTC+1) · Amsterdã (UTC+1) · Madri (UTC+1) · Roma (UTC+1) · Moscou (UTC+3) · Dubai (UTC+4) · Tel Aviv (UTC+2) · Cairo (UTC+2) · Joanesburgo (UTC+2) · Índia (UTC+5:30) · Bangcoc (UTC+7) · Jacarta (UTC+7) · Singapura (UTC+8) · China (UTC+8) · Hong Kong (UTC+8) · Seul (UTC+9) · Tóquio (UTC+9) · Perth (UTC+8) · Sydney (UTC+10) · Melbourne (UTC+10) · Auckland (UTC+12)
    Padrão:
    São Paulo (UTC-3)
    Exemplo:
    UTC

  • Começar em (opcional)

    Modo gatilho

    Data e hora no fuso selecionado. Vazio: começar após publicar.

    Exemplo:
    2026-10-19T09:00

  • Encerrar em (opcional)

    Modo gatilho

    Nenhuma nova execução começa a partir deste horário. Vazio: até você desativar.

    Exemplo:
    2026-10-30T18:00

Saídas

Este bloco não declara campos de saída separados.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

Agendamentoprocessamentoação final
Frequência
A cada X minutos
Intervalo (minutos)
15
Minuto
30
Horário
09:00
Dia da semana
Segunda-feira
Horário
09:00

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <agendamento.campo>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O fluxo não inicia sozinho
Gatilhos só disparam com a automação publicada. Confira também se o evento aconteceu na conta conectada e se os filtros do gatilho não estão excluindo o evento.

Blocos relacionados