Nó Delay

O nó Delay (delay) pausa o workflow antes de continuar para o próximo nó. Use-o para espaçar mensagens de saída, aguardar processamento externo, respeitar horário comercial ou montar sequências de follow-up em várias etapas.

Disponível na paleta Lógica em Automações.

Figura 1: Configuração do Delay — regras de tempo, templates e janela opcional

O que faz

Quando a execução chega a um nó Delay:

1. O engine calcula o tempo total de espera a partir das regras de tempo e, opcionalmente, de uma janela de horário.
2. Em produção, esperas maiores que alguns segundos são agendadas em uma fila em background (BullMQ) — a execução permanece running até o timer completar.
3. Após a espera, o workflow retoma no próximo nó conectado.
4. A saída inclui delayed_ms (milissegundos totais aguardados), além de window_ms e rules_ms quando a janela está habilitada.

Durante um delay enfileirado você pode usar Skip delay no histórico de execução para retomar imediatamente (útil em testes ou overrides urgentes).

No modo de teste isolado do nó, esperas são limitadas a 3 segundos inline para feedback mais rápido.

Como configurar

Clique duas vezes no nó Delay.

Regras de tempo (obrigatório)

Define quanto tempo esperar depois de qualquer delay de janela (veja abaixo). Digite um valor ou escolha um template.

Máximo por delay: 1 hora (3.600.000 ms). Valores acima do teto são limitados.

Templates embutidos incluem 5s, 30s, 5min, 15min, 1h e intervalos aleatórios como "1 to 5 min (random)" — ideais para espaçamento anti-bloqueio de mensagens.

Você pode usar variáveis: {{variables.wait_ms}} é resolvido antes do parse.

Janela de horário (opcional)

Ative Time window / Janela temporal para restringir quando o workflow pode prosseguir.

Quando habilitada:

• Days — quais dias da semana contam (0 = domingo … 6 = sábado). Padrão seg–sex.
• Start / end time — ex.: 09:00–18:00.
• Timezone — padrão America/Sao_Paulo.

Comportamento:

• Se a execução chega dentro da janela → só as regras de tempo se aplicam.
• Se fora da janela → o engine espera até a próxima abertura da janela, depois aplica as regras de tempo.

Use isso para evitar envios WhatsApp à noite ou nos fins de semana sem triggers Schedule separados.

Saída

Nós downstream podem referenciar {{delay_1.delayed_ms}} se necessário.

Dicas e boas práticas

• Use intervalos aleatórios em loops ao enviar para muitos contatos (30s-90s, 60s-300s) para simular ritmo humano e reduzir risco de bloqueio.
• Combine janela + regra curta para fluxos "próxima manhã útil": a janela leva você às 09:00, depois adicione 10s-60s antes do envio.
• Skip delay só quando necessário em produção — pular ignora espaçamento intencional e janelas de compliance.
• Não encadeie muitos delays de uma hora em um workflow sem entender limites da fila; prefira triggers Schedule para sequências de vários dias.
• Teste com delays fixos curtos (5s, 10s) antes de implantar configs aleatórias ou com janela em produção.
• Execuções pausadas durante delay podem ser canceladas na barra lateral de execução; o job do timer enfileirado é removido.

Exemplos de uso

Exemplo 1 — Sequência de follow-up após captura de lead

Trigger: Webhook — novo lead.

Fluxo:

1. Send Text — boas-vindas imediatas
2. Delay — 2m (2 minutos)
3. Send Text — visão geral do produto
4. Delay — 1h (1 hora)
5. Condição — se não houver resposta (verificar CRM ou estado da conversa)
6. Send Text — lembrete gentil

Cada Delay cria uma pausa natural sem workflows separados.

Exemplo 2 — Campanha em massa com espaçamento anti-bloqueio

Trigger: Manual / Schedule.

Fluxo:

1. HTTP — buscar lista de contatos
2. Loop — por contato
3. A cada item → Send Text → Delay 60s-300s (aleatório 1–5 min)
4. Ao concluir → notificar admin

Delay aleatório dentro do loop é o padrão recomendado para outreach WhatsApp em massa.

Exemplo 3 — Notificações só em horário comercial

Trigger: Webhook — alerta de estoque do ERP (pode disparar 24/7).

Fluxo:

1. Delay — regras de tempo 10s, janela seg–sex 09:00–18:00 America/Sao_Paulo
2. Send Text para o gerente de estoque
3. CRM — comment no card relacionado

Alertas que chegam às 2h da manhã esperam até 09:00 antes do envio da mensagem.

FAQ

Por que minha execução ficou presa no Delay?

Um delay enfileirado está em andamento. Verifique o histórico de execução — o status mostra o nó Delay ativo. Aguarde o timer ou use Skip delay.

Por que o modo de teste terminou mais rápido que produção?

Testes de nó único limitam espera inline a 3 segundos. Execuções completas em produção usam a duração real e agendamento na fila.

Posso atrasar por dias?

O máximo por nó Delay é 1 hora. Para follow-ups de vários dias, use vários nós Delay, triggers Schedule ou ações agendadas no CRM.

Janelas somam com regras longas?

Espera total = espera da janela (se fora da janela) mais espera das regras. Ambas aparecem no detalhamento da saída.

O que acontece se eu cancelar durante o delay?

A execução é cancelada e o job de continuação em background é removido.

O Delay pode usar variáveis?

Sim. {{variables.delay_seconds}}s ou {{input.retry_after}} é resolvido antes de calcular milissegundos.

Artigos relacionados

• Visão geral de Lógica
• Nó Loop — delay dentro de iterações
• Boas práticas anti-bloqueio
• Histórico de execuções do workflow
• Como testar e depurar um workflow