Como configurar uma campanha recorrente

Campanhas recorrentes são executadas automaticamente em intervalos regulares — diariamente, semanalmente ou em qualquer frequência definida por uma expressão cron. Elas são ideais para fluxos de nutrição, reativação de leads inativos e disparos periódicos que precisam rodar sem intervenção manual. Você configura uma vez e o sistema executa no ritmo definido.

Neste artigo:

Disponível em: todos os planos.

Quem pode fazer: gestores e administradores com acesso ao módulo Campanhas.

Módulo: Menu lateral > Campanhas

Os passos iniciais são iguais a qualquer campanha:

💡 Dica: Se você não está familiarizado com expressões cron, o campo exibe automaticamente a tradução em linguagem natural conforme você digita. Use isso para confirmar que a frequência está correta.

Após definir a recorrência, o fluxo continua normalmente:

Cada vez que a expressão cron é atingida, o sistema executa a seguinte lógica:

⚠️ Importante: A frequência de verificação do scheduler é a cada 10 minutos em produção. Isso significa que a execução pode ter um atraso de até 10 minutos em relação ao horário definido na expressão cron.

Posso alterar a frequência de recorrência depois de lançar?

Não. O padrão de recorrência é definido na criação da campanha e fica imutável após a ativação. Se precisar alterar a frequência, pause e arquive a campanha atual e crie uma nova com a recorrência desejada.

O que acontece se a campanha for pausada durante uma execução?

Novos disparos são interrompidos imediatamente. Enrollments em andamento são preservados — ao reativar, eles retomam do ponto onde pararam. Execuções que deveriam ocorrer durante a pausa são perdidas (o sistema não as compensa retroativamente).

A campanha recorrente reprocessa contatos que já receberam todas as mensagens?

Não. Contatos com enrollment completo não são reinscritos automaticamente. A recorrência processa apenas enrollments em andamento (próxima etapa pendente) e cria novos enrollments para contatos que entraram na audiência desde a última execução.

Posso usar campanha recorrente com gatilho externo?

Não. Recorrente e gatilho externo são tipos de ativação mutuamente exclusivos. Use gatilho externo para campanhas reativas a eventos de CRM e recorrente para campanhas periódicas baseadas em lista ou funil.

A data de término encerra a campanha automaticamente?

Sim. Quando a data de término é atingida, a campanha muda automaticamente para status Concluída. Enrollments em andamento que ainda não completaram todas as etapas são finalizados sem enviar as etapas pendentes.

O que é a expressão cron e como funciona?

A expressão cron é um formato padrão para definir horários recorrentes, composta por 5 campos: minuto (0-59), hora (0-23), dia do mês (1-31), mês (1-12) e dia da semana (0-6, onde 0 é domingo). O asterisco (*) significa "todos". Por exemplo, 0 9 * * 1-5 significa "às 9h00, todos os dias de segunda (1) a sexta (5)".

A campanha recorrente respeita horário comercial?

Sim, por padrão. As mensagens são enviadas apenas entre 08h–18h, segunda a sexta, horário de Brasília. Se a expressão cron estiver configurada para executar às 6h, por exemplo, os enrollments serão criados mas as mensagens só serão disparadas a partir das 8h. Ative Ignorar horário comercial se precisar de envio fora desse horário.