O que o Wait Faz
O nó Wait no n8n permite que você pause a execução do workflow por um período de tempo especificado ou até que uma condição externa seja atendida, essencial para throttling, atrasos de tempo e coordenação de processos assíncronos.
- Pausa a execução do workflow por segundos, minutos, horas ou até uma data/hora específica
- Pode esperar por eventos externos como webhooks, notificações ou confirmações antes de continuar
- Essencial para respeitar limites de API, adicionar delays entre ações ou criar workflows com timing preciso
Principais Casos de Uso
- Rate Limiting: Inserir delays entre chamadas de API para respeitar limites de taxa (ex: esperar 1 segundo entre requisições)
- Processos de Aprovação: Pausar workflow até que um humano aprove ou rejeite via webhook ou formulário
- Delays de Tempo: Aguardar período específico antes de executar próxima ação (ex: esperar 24 horas antes de enviar email de follow-up)
- Sincronização: Coordenar ações que dependem de processos externos ou sistemas que levam tempo para processar
- Processamento em Lote: Combinar com Loop Over Items para controlar velocidade de processamento de grandes volumes de dados
Modos de Espera
1. Tempo Fixo
Espera por um período de tempo específico (segundos, minutos, horas)
- Simples e direto
- Ideal para delays previsíveis
- Exemplo: esperar 5 segundos entre emails
2. Data/Hora Específica
Pausa até uma data e hora específica
- Útil para agendamentos precisos
- Pode usar expressões dinâmicas
- Exemplo: esperar até amanhã às 9h
3. Webhook/Evento
Espera até receber um webhook ou evento externo
- Permite workflows interativos
- Requer URL de retomada
- Exemplo: esperar aprovação do usuário
Melhores Práticas e Dicas
- Use com Loop Over Items para controle preciso de taxa em processamento em lote
- Configure timeouts apropriados quando esperar por eventos externos para evitar workflows travados
- Considere timezone ao usar esperas baseadas em data/hora específica
- Não abuse de delays longos - considere usar Schedule Trigger para ações com dias/semanas de intervalo
- Para APIs com rate limiting, calcule o delay necessário: (60 segundos / limite por minuto)
Exemplos Práticos
Exemplo 1: Rate Limiting de API
Cenário: API permite 10 requisições por minuto
- Use Loop Over Items (lote de 1)
- Adicione nó Wait com 6 segundos (60s ÷ 10 = 6s)
- Isso garante máximo de 10 requisições/minuto
Exemplo 2: Email de Follow-up
Cenário: Enviar email de follow-up 3 dias após primeiro contato
- Trigger: novo lead no CRM
- Enviar email de boas-vindas
- Wait: 3 dias (4320 minutos)
- Enviar email de follow-up
Exemplo 3: Aprovação Manual
Cenário: Workflow precisa de aprovação humana
- Processar dados iniciais
- Enviar notificação com link de aprovação
- Wait (modo webhook) até receber aprovação/rejeição
- Continuar baseado na resposta
Considerações Importantes
- Workflows em espera consomem recursos - planeje sua infraestrutura adequadamente
- Defina sempre timeouts para esperas baseadas em eventos externos
- Documente delays longos no seu workflow para que outros entendam o timing
- Para delays muito longos (dias/semanas), considere usar abordagem com banco de dados + Schedule Trigger