Agendar Execução
Agendar Execução pausa a automação e define quando ela deve continuar. O agendamento pode usar uma data manual, um campo adicional do registro ou a próxima janela de dia útil.
Use esse node quando o próximo passo precisa acontecer em uma data específica ou respeitar o calendário e os horários da operação. Para apenas aguardar um intervalo contado a partir do momento atual, use Aguardar Prazo.
Entradas e saídas
O node recebe 1 entrada e possui 1 saída. A saída é executada quando chega o momento agendado e a automação passa pelo próximo ciclo de processamento.
Por isso, considere uma pequena margem operacional: a continuação pode não acontecer exatamente no primeiro segundo do horário escolhido.
Escolher a origem da data
| Origem | Quando usar | O que configurar |
|---|---|---|
| Data manual | A continuação deve ocorrer em uma data e hora definidas no próprio fluxo. | Data, hora e timezone. |
| Campo adicional da entidade | Cada contato, empresa ou oportunidade possui sua própria data de retorno. | Campo adicional do tipo data, horário de execução e timezone. |
| Próximo dia útil | A continuação deve respeitar dias, horários de atendimento e calendários de exceção. | Uma ou mais janelas úteis, timezone e, opcionalmente, regras de data. |
Data manual
Selecione uma data e um horário futuros. Todas as execuções que chegarem a esse node usarão o mesmo momento configurado.
Esse modo é indicado para campanhas com início programado, viradas de etapa em uma data conhecida ou ações pontuais. Revise o node depois que a data passar, pois novos registros não devem ser enviados para um agendamento vencido.
Campo adicional da entidade
Selecione um campo adicional do tipo data pertencente à entidade da automação. O dia vem do valor salvo em cada registro; o horário e o timezone são definidos no node.
Exemplo: uma oportunidade possui o campo Data de retorno comercial preenchido com 15/09/2026. Se o node estiver configurado para 10:00, a automação continuará nessa data às 10:00 no timezone escolhido.
Antes de ativar:
- confirme que o campo pertence à mesma entidade da automação;
- mantenha o campo preenchido com uma data futura nos registros que passarão pelo node;
- teste com registros que tenham datas diferentes;
- defina o que deve acontecer quando o campo estiver vazio ou vencido, evitando enviar esses registros ao agendamento.
Próximo dia útil
Esse modo procura a primeira janela disponível a partir do dia seguinte. Cadastre uma ou mais janelas com dias da semana e horários, no mesmo padrão do node Condicional de Tempo.
Por exemplo:
- segunda a sexta, das 09:00 às 12:00;
- segunda a sexta, das 14:00 às 18:00;
- sábado, das 09:00 às 12:00.
A automação será agendada para o primeiro horário disponível entre essas janelas. Para um período que atravessa a meia-noite, divida-o em duas janelas.
Regras de data e feriados
Você também pode selecionar regras de data já cadastradas, normalmente usadas para feriados, recessos ou bloqueios especiais.
- Uma regra sem intervalo de horário bloqueia o dia inteiro.
- Uma regra com horário bloqueia somente aquele período.
- Se o começo de uma janela estiver bloqueado, o agendamento procura o próximo minuto livre dentro dela.
- Se não houver horário livre, a busca continua na próxima janela ou no próximo dia disponível.
Use calendários compatíveis com a região e a equipe atendida. Um feriado local selecionado no fluxo errado pode adiar contatos de outra operação.
Timezone
O timezone define como a plataforma interpreta a data, o dia da semana e o horário escolhidos. Configure-o conforme a operação que receberá a ação, não apenas conforme o local de quem está editando o fluxo.
Revise o timezone principalmente quando:
- clientes e equipe estão em fusos diferentes;
- a automação atende mais de uma região;
- existe mudança sazonal de horário na região selecionada;
- a data vem de um campo adicional preenchido por integração.
Exemplo: retorno comercial em data do registro
- Crie um campo adicional do tipo data para a entidade da automação.
- Preencha esse campo no contato, empresa ou oportunidade de teste.
- Adicione Agendar Execução e escolha Campo adicional da entidade.
- Selecione o campo, o horário e o timezone.
- Depois do node, adicione Avaliar Condição para confirmar que o registro ainda precisa do contato.
- Conecte a tarefa, mensagem ou outra ação somente ao caminho válido.
Como validar
- Faça um teste com uma data manual próxima e futura.
- Teste o campo adicional com pelo menos dois registros e datas diferentes.
- No modo próximo dia útil, teste mais de uma janela, um final de semana e uma regra de feriado.
- Confira no histórico se a execução ficou agendada para o momento esperado.
- Aguarde a retomada e confirme se o próximo node foi executado.
- Revalide a condição do registro antes de enviar mensagem, alterar etapa ou concluir conversa.
Troubleshooting
| Sintoma | O que verificar |
|---|---|
| A execução não ficou agendada | Confirme se a data é futura, se o campo adicional está preenchido e se há ao menos uma janela válida no modo próximo dia útil. |
| O horário ficou diferente do esperado | Revise o timezone do node e a região usada para preencher a data. |
| O próximo dia útil foi adiado | Verifique dias marcados, horários das janelas e regras de data selecionadas. |
| A execução passou do horário e ainda não continuou | Aguarde o próximo ciclo de processamento e confira se a automação continua ativa e sem erro no histórico. |
| A ação ocorreu fora de contexto | Adicione uma avaliação de condição depois do agendamento para conferir o estado atual do registro. |