Pular para o conteúdo

Stage Gating — ações obrigatórias por etapa

Stage Gating é o sistema que bloqueia o deal de sair de uma etapa até que ações obrigatórias sejam concluídas. Permite também controlar quais transições são permitidas (whitelist de etapas destino). É o que transforma seu funil em playbook real — vendedor não pula etapa, equipe não fecha deal sem preencher dados críticos, e o follow-up tem dados estruturados.

Antes do Stage Gating, qualquer pessoa podia arrastar um deal de “Lead” direto pra “Ganho” sem preencher nada. Resultado: histórico inconsistente, métricas furadas, perda de aprendizado.

Com Stage Gating:

  • Vendedor precisa fazer a tarefa (ex: ligar pro cliente, agendar visita) antes de avançar
  • Atendente anexa o documento (proposta assinada, comprovante) antes de fechar
  • Não dá pra pular etapas que não fazem sentido no seu fluxo
  • Motivo de perda registrado de forma estruturada quando deal vai pra “Perdido”
SituaçãoStage Gating vale a pena?
Time pequeno (1-3), todo mundo sabe o processoTalvez não — pode virar burocracia
Time médio (5+) com rotatividade✅ Sim — onboarding muito mais rápido
Vendas complexas (B2B, alto ticket, ciclo longo)✅ Sim — perda de info custa caro
Equipe que mistura comercial + atendimento no mesmo funil✅ Sim — bloqueia confusão
Operação que depende de relatórios pra reportar pra liderança✅ Sim — dados de qualidade
Você quer flexibilidade total e processo informal❌ Não — Gating engessa

Stage Gating: menu do topo Config. › CRM › Pipelines › ícone de lápis (Editar funil) › aba Config de Etapa › clicar numa etapa para abrir: Ativar ações obrigatórias nesta etapa marcado e, em Ações obrigatórias, pelo menos duas ações preenchidas (por exemplo uma Checklist com itens e um Anexo), com o botão Salvar etapa visível

  1. Config. → CRM → Pipelines → ícone de lápis (Editar funil) no funil
  2. Aba Config de Etapa
  3. Clique na etapa que quer “blindar” (ex: “Negociação”) para abrir
  4. Marque Ativar ações obrigatórias nesta etapa
  5. Em Ações obrigatórias, clique em Adicionar ação e defina cada uma (veja abaixo)
  6. Clique em Salvar etapa

A partir daí, deals que tentam sair dessa etapa sem cumprir as ações são bloqueados com aviso ao usuário.

São sete, escolhidos na aba Config de Etapa do editor do funil:

TipoO que exige
CampoUm campo preenchido. Você escolhe se ele grava no contato ou no negócio
ChecklistVários itens marcados. O admin escreve os itens, o vendedor só marca
TarefaUma tarefa criada no negócio, com data, responsável e tipo. Ela não precisa estar concluída
ReuniãoUma reunião agendada no negócio (e não cancelada)
AnexoUm arquivo enviado. Pode ir para o negócio ou para os documentos do contato
NotaUma nota escrita
Data / prazoUma data definida

O motivo não está na lista: ele continua sendo pedido quando o negócio é marcado como ganho ou perdido.

Cada ação tem o texto do que precisa ser feito, uma Instrução (opcional) e pode ser condicional (Obrigatório só em uma condição), exigida só quando um atributo personalizado do contato tem certo valor.

Na mesma aba você configura quem é avisado e quando: o responsável, uma equipe ou uma pessoa específica, quando o negócio fica parado nesta etapa ou quando uma ação obrigatória não foi feita depois de tantas horas.

Você pode tornar uma ação condicional. Exemplo:

  • Ação: “Anexar contrato assinado”
  • Condicional: só obrigatória se tipo_venda = "B2B"

Configuração:

Tipo: attachment
Label: "Contrato assinado"
Condicional: ATIVADO
Atributo: tipo_venda
Valor: B2B

Daí o ação só aparece (e bloqueia) em deals B2B; deals B2C passam direto.

Marque Restringir para quais etapas pode mover e escolha os destinos permitidos.

Exemplo: na etapa “Proposta Enviada”, você só permite ir pra:

  • “Negociação” (continuar processo)
  • “Ganho” (cliente aceitou)
  • “Perdido” (cliente declinou)

Tentar mover pra “Qualificação” (etapa anterior) ou “Onboarding” (pulando 2 fases) é bloqueado.

Stage Gating: menu lateral Vendas › CRM (quadro), depois de arrastar um negócio para fora de uma etapa com ações obrigatórias ainda não feitas: o aviso Ações obrigatórias pendentes aberto, com a lista do que falta e os botões Cancelar e Mover assim mesmo (este só aparece para quem pode furar o bloqueio)

Sistema cobre 5 caminhos de mudança de etapa:

  1. Drag-and-drop no Quadro — UI principal, mostra modal de aviso
  2. Dropdown na conversa — sidebar da conversa quando vincula deal, mesmo bloqueio
  3. API REST — POST /api/v1/accounts/X/deals/Y/move_to_stage retorna 422 com lista de pendências
  4. Pipeline Automations — automação tenta mover, registra erro no log se gating bloquear
  5. Workflows — a ação move_to_stage não move, e a execução do workflow fica marcada com erro

A validação é centralizada em Deal#move_to_stage! — não tem como furar, exceto pela exceção de admin (abaixo).

Admins têm permissão pra forçar mudança ignorando gating — útil pra correções, exceções de cliente VIP, etc. Quando furam:

  • Sistema registra timeline note automática: “Admin X forçou mudança de etapa ignorando ações pendentes”
  • Logs internos rastreiam o by-pass pra auditoria
  • Ações pendentes ficam marcadas como “puladas com aviso” — visíveis na ficha do deal pra análise depois

Atendente comum não pode forçar — bloqueio é absoluto.

1. Imobiliária — não fecha venda sem documentos

Seção intitulada “1. Imobiliária — não fecha venda sem documentos”
  • Etapa “Negociação”
    • task: “Agendar visita técnica” (obrigatório)
    • attachment: “Pré-contrato preenchido”
    • field: “Valor da proposta” preenchido
  • Etapa “Ganho” (whitelist):
    • Só permite vir de “Negociação”
    • attachment: “Contrato assinado”
    • attachment: “Comprovante do sinal”
  • Etapa “Qualificado”:
    • checklist “Critérios de qualificação” com 4 itens (BANT, persona, ticket mínimo, decisão)
    • note: “Resumo da call de discovery”
  • Restringir para quais etapas pode mover: só Proposta ou Perdido
  • Etapa “Perdido”:
    • field: “Motivo da perda” (atributo customizado dropdown: Preço, Concorrência, Timing, Não-qualificado, Outro)
    • note: “Detalhamento do motivo”
  • Automações furam o gate por padrão — Workflow ou Pipeline Automation que move deal bypassa o gating. Isso é intencional (automação tem que rodar mesmo sem ações pendentes manualmente). Se quiser que automação respeite gating, configure no Workflow.
  • UI manual continua exigindo motivo de perda — quando o vendedor arrasta o deal pra “Perdido” no Quadro, abre modal obrigando escolher motivo (UI manual). Já em automações, motivo é opcional (veja Motivo de perda opcional em automações).
  • Ações condicionais não recalculam em tempo real — se você muda o atributo tipo_venda no meio do processo, ações condicionais novas aparecem mas as antigas (já cumpridas) ficam marcadas como done.
  • Stage requirements são por etapa, não por pipeline — duplicar pipeline copia os requirements, mas mudanças em um pipeline não propagam pro outro.