Agende campanhas para datas e horários futuros, ou envie imediatamente. O sistema decide automaticamente entre envio instantâneo e agendamento com base no horário informado.
Envio imediato vs. agendado
A lógica é simples: se a data/hora informada estiver a mais de 15 segundos no futuro, a campanha é agendada. Caso contrário, o envio começa imediatamente.
| Cenário | Status | Comportamento |
|---|---|---|
| Sem agendamento | SENDING | Despacho inicia imediatamente |
| Data < 15s no futuro | SENDING | Tratado como envio imediato |
| Data > 15s no futuro | SCHEDULED | Aguarda até a data; cron verifica a cada 5 minutos |
Como agendar
- Na etapa de Setup, ative a opção Agendar envio.
- Selecione data e horário. A data deve ser no futuro.
- Complete as etapas restantes normalmente (destinatários, variáveis, preview).
- Na etapa de preview, confirme com Agendar campanha.
O cron de verificação roda a cada 5 minutos. Isso significa que uma campanha agendada para 14:00 pode iniciar entre 14:00 e 14:05.
Gerenciando campanhas agendadas
Enquanto a campanha estiver com status SCHEDULED, você pode:
Enviar agora — muda o status para SENDING e despacha imediatamente, ignorando a data agendada.
Cancelar — muda o status para CANCELLED. Nenhuma mensagem é enviada. O sistema registra quem cancelou e quando.
Parando um envio em andamento
Se a campanha já estiver em SENDING, use a ação Parar. O sistema:
- Muda o status para
CANCELLED - Remove o job da fila de processamento (BullMQ)
- Registra o progresso no momento da parada
- Mensagens já enviadas não podem ser revertidas
Mensagens que já foram entregues pela Meta não podem ser canceladas. A ação de parar impede apenas o envio das mensagens restantes na fila.
Fluxo de status
DRAFT → SCHEDULED → SENDING → COMPLETED
↓ ↓
CANCELLED CANCELLED
↓
FAILED- DRAFT — campanha criada mas não enviada
- SCHEDULED — aguardando data agendada
- SENDING — processando envio das mensagens
- COMPLETED — todas as mensagens processadas
- CANCELLED — cancelada pelo usuário
- FAILED — erro crítico durante o despacho