Central de Ajuda Re-entrada e cooldown: quando um lead pode reentrar

Re-entrada e cooldown: quando um lead pode reentrar

Nível: Intermediário Tempo de leitura: 4 min Plano necessário: Pro ou Ultra


Comportamento padrão: re-entrada bloqueada

Por padrão, um contato que já entrou em uma automação NÃO consegue entrar de novo, mesmo depois de ter terminado o fluxo (completed, exited, failed).

Por que: o comportamento defensivo evita que o contato receba a mesma sequência várias vezes. Imagina o lead que entrou no fluxo "Boas-vindas", terminou, e duas semanas depois cai num novo trigger por engano. Ele recebe TUDO de novo. Spam.

Se você tentar disparar um trigger pra alguém já bloqueado:

  • Webhook: retorna 409 com reason: "in_cooldown"
  • Evento de conversão: silenciosamente ignorado (não cria run)
  • Manual: o contato é pulado e contado em "skipped"

Quando faz sentido permitir re-entrada

Em alguns casos, faz total sentido o contato passar pelo fluxo de novo depois de um tempo:

  • Reengajamento periódico: todo trimestre, lead frio entra de novo no fluxo "Reativação"
  • Carrinho abandonado: se o cliente abandonar carrinho de novo daqui um mês, repetir a tentativa de recuperar
  • Aniversariante: fluxo que dispara todo ano no aniversário do cliente
  • Onboarding pós-compra: se ele comprar outro produto, repetir o onboarding

Pra esses casos, configure um cooldown.


Como configurar cooldown

No editor da automação:

  1. Clique em qualquer área vazia do canvas pra abrir o painel "Saídas globais" na direita
  2. No campo Cooldown de re-entrada (horas), preencha quantas horas o contato precisa esperar antes de poder reentrar

Exemplos:

Cenário Cooldown
Reativação trimestral 2160 (90 dias)
Reengajamento mensal 720 (30 dias)
Carrinho abandonado (mesmo produto) 168 (7 dias)
Pesquisa de NPS recorrente 4320 (180 dias)
Bloqueio permanente (padrão) (deixe vazio)

A contagem começa a partir do ended_at da última run (quando ela terminou, não quando começou).


Lógica detalhada

Quando chega um trigger pra um contato:

  1. Tem run ativa desse contato neste fluxo? → bloqueia
  2. Tem run terminada desse contato neste fluxo?
    • Se SIM e SEM cooldown configurado → bloqueia (padrão defensivo)
    • Se SIM e COM cooldown:
      • Diferença entre agora e ended_at < cooldown → bloqueia
      • Diferença ≥ cooldown → libera, cria nova run
  3. Nunca entrou antes → libera, cria nova run

Como ver runs anteriores

No monitor da automação, filtre por status "Completo" ou "Saiu" pra ver runs antigas. Cada linha mostra:

  • Telefone do contato
  • Quando começou e quando terminou
  • Motivo da saída

Pra ver TODAS as runs de UM contato específico (incluindo de outros fluxos), abra a página do contato em Contatos > selecione contato > aba "Histórico" (se disponível na sua versão).


Cuidado: cooldown ≠ opt-out

Cooldown só atrasa a re-entrada. Opt-out bloqueia PERMANENTEMENTE qualquer automação (não só essa).

Se um contato responder "PARAR" em qualquer fluxo, ele fica marcado como opt-out global. Nenhuma quantidade de cooldown vai liberar — só intervenção manual via banco. Veja Critérios de saída.


Cooldown e gatilhos manuais

Mesmo no início manual, o cooldown é respeitado. Se você selecionar 100 contatos pra entrar manualmente mas 30 estão em cooldown, o sistema cria 70 runs e pula 30 (você vê no resultado: "70 iniciadas, 30 puladas").


Próximos passos