# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-08-29T23:41:07.182Z ## Página - Título: Agendar Execução - URL humana: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/agendar-execucao - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Pausa a automação até uma data manual, uma data de campo adicional ou a próxima janela de dia útil. ## Seções - Entradas e saídas - Escolher a origem da data - Data manual - Campo adicional da entidade - Próximo dia útil - Regras de data e feriados - Timezone - Exemplo: retorno comercial em data do registro ## Conteúdo da página # 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](/docs/configuracao/referencias/nodes-automacao-crm/aguardar-prazo). ![Configuração do node Agendar Execução com duas janelas úteis e calendário de feriados](/docs/screenshots/config-automacao-crm-agendar-execucao.png) ## 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](/docs/configuracao/referencias/nodes-automacao-crm/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 1. Crie um campo adicional do tipo data para a entidade da automação. 2. Preencha esse campo no contato, empresa ou oportunidade de teste. 3. Adicione **Agendar Execução** e escolha **Campo adicional da entidade**. 4. Selecione o campo, o horário e o timezone. 5. Depois do node, adicione [Avaliar Condição](/docs/configuracao/referencias/nodes-automacao-crm/avaliar-condicao) para confirmar que o registro ainda precisa do contato. 6. 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. | ## Guias relacionados - [Condicional de Tempo](/docs/configuracao/referencias/nodes-automacao-crm/condicional-de-tempo) - [Aguardar Prazo](/docs/configuracao/referencias/nodes-automacao-crm/aguardar-prazo) - [Avaliar Condição](/docs/configuracao/referencias/nodes-automacao-crm/avaliar-condicao) - [Automações de CRM](/docs/configuracao/fluxos-automacoes/automacoes-de-crm)