A origem

Uma empresa mais consciente, conectada e capaz de aprender com a própria operação.

Contato

// DA ATENÇÃO À DECISÃO

UMA OPORTUNIDADE NÃO AVANÇA SOZINHA. Precisa da próxima mensagem certa.

O Comercial organiza contatos, oportunidades, propostas, negociações e follow-ups para transformar interesse em decisão.

Vender não é empurrar uma oferta. É mover uma relação até uma decisão.

EXPLORAR O COMERCIAL
// A TESE DO MÓDULO

LEAD, OPORTUNIDADE, PROPOSTA, VENDA E CLIENTE não são cinco cadastros.

São estados de uma mesma relação. Mova o funil abaixo e repare no painel da esquerda: ele não se mexe.

A empresa é a mesma linha do começo ao fim. O que muda é uma coluna.

o que NÃO muda

Nenhum campo acima é função do estágio. Este painel é desenhado uma única vez quando a página carrega e nunca mais é tocado — no código e na tela.

arquitetura real · verificada no código   Está escrito em app/actions/crm-painel.ts: “crm_leads é histórico legado — a fonte viva é emp_empresas.estagio_funil.” Não existe tabela de leads viva no sistema. Ser lead é um valor numa coluna da empresa — e os três valores que existem hoje no banco são exatamente lead, prospect e cliente, em 45 empresas numa tabela só.

NÃO DUPLIQUE A PESSOA. Mude a relação.

// MOVIMENTO COMERCIAL

QUAL É A PRÓXIMA MENSAGEM que move essa oportunidade para frente?

O Comercial não existe para acumular contatos. Existe para conduzir relações — e cada estado pede um movimento diferente.

pergunta oficial cadastrada no módulo
lead novoApresentar valorAntes de perguntar qualquer coisa, dar um motivo para a conversa continuar.
qualificadoAprofundar a dorEntender o problema melhor do que quem o descreveu.
proposta enviadaEsclarecer objeçãoSilêncio depois da proposta quase nunca é falta de interesse — é dúvida sem resposta.
negociaçãoReduzir incertezaNegociar é dar à outra parte informação suficiente para conseguir decidir.
paradoReativar a relaçãoVoltar com contexto novo, não com “passando para saber se viu minha mensagem”.
sem próxima açãoNenhum movimentoÉ o único estado em que a oportunidade não avança — e o mais comum de todos.

SE NÃO EXISTE PRÓXIMA AÇÃO, não existe movimento comercial.

// O FUNIL COMO NARRATIVA

PROSPECÇÃO. NEGOCIAÇÃO. Fechamento.

Três camadas, dez núcleos no catálogo da plataforma e mais sete que a archēLAB acrescentou. O funil não é decoração: é a estrutura do módulo no banco.

3 camadas · 10 núcleos globais · 7 do tenant
camada 01 Prospecção Encontrar e qualificar. Antes de vender, saber com quem se está falando — e se existe relação que valha ser movida.
ContatosEmpresas - LeadsAtividadesLeadsFunil de Vendas
camada 02 Negociação Construir valor, proposta e decisão. Reduzir a incerteza da outra parte até que decidir seja possível.
NegóciosPipelinesPipeline KanbanPropostasApresentações Comerciais
camada 03 Fechamento Formalizar a relação — e entregá-la ao resto da empresa sem que o cliente precise repetir nada.
VendedoresFaturasGovernançaeCommerceClientes GanhosContratos ClientesExpansão e Parcerias
// CAMADA 01 · QUEM ESTÁ DO OUTRO LADO

CONTATO NÃO É CLIENTE. É uma entidade com potencial de relação.

Prospecção não é volume. É identificação de contexto — e o contexto é o que decide se aquilo vira oportunidade ou consome o mês de alguém sem virar nada.

Contatos A pessoa. Uma entidade em con_contatos que pode ter vários papéis ao mesmo tempo — e continuar sendo uma pessoa só.
  • origem e canal
  • papéis múltiplos
  • vínculo com empresas
  • redes e formas de contato
  • histórico de interação
Empresas · Leads A organização. O mesmo registro que vira cliente — o estágio do funil é um campo dela, não outra tabela.
  • estágio do funil
  • segmento e prioridade
  • status
  • contatos ligados
  • negócios abertos
Qualificar Descobrir se existe dor, urgência, fit, orçamento, autoridade e timing. Não é preencher um formulário de score — é reunir contexto suficiente para decidir se vale mover.
  • existe dor real?
  • existe urgência?
  • quem decide?
  • é o momento?
Cada interação deixa rastro: ligação, mensagem, e-mail, reunião, demo, follow-up, nota. E toda atividade se liga a pessoa, empresa, oportunidade, responsável, data, resultado e próxima ação — sem os dois últimos, ela vira só histórico.
// O ESTADO DAS RELAÇÕES

PIPELINE NÃO É UMA FILEIRA DE CARDS. É uma leitura de estado.

Um serviço consultivo não vende como um e-commerce. Por isso pipeline é configuração, não realidade fixa.

Os três abaixo estão cadastrados no sistema hoje — com etapas e probabilidades reais.

3 pipelines · 11 etapas · dados do banco
Pipeline de Vendasvendas · 6 etapas
Lead10%
Oportunidade30%
Proposta50%
Negociação75%
Ganho100%
Perdido0%
Pipeline Comercialpipeline-comercial · 5 etapas
Captação10%
Contato25%
Proposta50%
Negociação75%
Fechamento90%
Vendas Padrãovendas-padrao · sem etapas
Cadastrado e ainda sem etapas configuradas. Está aqui exatamente como está no banco — um pipeline vazio é um dado, não um erro de captura.
Um detalhe que só aparece lendo o schema: a probabilidade não fica no negócio, fica na etapa. Isso significa que ela é uma propriedade do processo, não um chute do vendedor sobre aquele caso — e é o que permite comparar dois negócios da mesma etapa sem discutir otimismo.

KANBAN É UMA VIEW. A oportunidade continua a mesma entidade.

// CAMADA 02 · CONSTRUIR DECISÃO

NEGOCIAR é reduzir incerteza.

Uma oportunidade tem mais do que um valor. Estas são as colunas reais de um negócio em crm_deals.

colunas reais da tabela
next_stepA próxima ação, gravada no próprio negócio. É uma coluna, não um campo de observação — e é o que sustenta a frase que assina esta página.
temperatureQuente, morna, fria. A leitura do vendedor sobre a energia da conversa — que nem sempre coincide com a etapa formal.
stage_idA etapa dentro do pipeline. É daqui que sai a probabilidade, e não do palpite de quem preencheu.
sourceDe onde veio. É a coluna que devolve para o Marketing se aquele canal traz negócio ou só traz volume.
empresa_id · contato_idOs dois ponteiros para a relação. Não é texto digitado: é a mesma empresa e a mesma pessoa do resto do sistema.
responsavel_idO dono. Oportunidade sem responsável é oportunidade sem dono — e ninguém acorda pensando nela.
value · statusQuanto vale e em que situação está: aberto ou ganho. O status fecha, o valor alimenta o forecast.
closed_atQuando fechou. É essa coluna que permite medir ciclo de venda em vez de estimá-lo de cabeça.
// O QUE IMPEDE A DECISÃO

OBJEÇÃO NÃO É NÃO. É informação.

Preço, timing, confiança, escopo, prioridade, concorrente, risco, autoridade. Quando a mesma objeção se repete, ela deixa de ser problema de venda e vira informação de produto, de marketing ou de posicionamento.

A proposta não é um PDFEla se relaciona com cliente, oportunidade, oferta, preço, escopo e projeto — e tem versão. A v1 continua registrada quando a v2 nasce.núcleo propostas
O escopo vem do CatálogoProduto, serviço, plano, preço e atributos já existem. O Comercial não deveria reinventar o produto a cada proposta.relação com catálogo
O modelo vem do InstitucionalTom, marca, posicionamento e o modelo oficial já foram decididos. O Comercial adapta; o Institucional orienta.relação com institucional
A objeção fica registradaLigada à oportunidade, com motivo. É o que permite descobrir, três meses depois, que metade das perdas tinha a mesma causa.vira conhecimento
O follow-up tem contextoNão é “lembrar de cobrar”. É saber o que fazer depois: última interação → contexto → próxima ação → prazo → responsável.next_step

A PROPOSTA É UMA DECISÃO em forma de documento.

// CAMADA 03 · A DECISÃO VIRA RELAÇÃO

FECHAR NÃO É O FIM. É uma mudança de estado.

O fechamento é o momento em que o Comercial entrega a relação para o resto da empresa — e é onde o contexto costuma se perder.

Ganho O deal muda para status = ganho com data de fechamento. E a empresa passa a estagio_funil = cliente.
  • contrato formalizado
  • fatura no Financeiro
  • projeto na operação, com o escopo prometido
  • onboarding no módulo Clientes
  • o FLOW pode executar a transição inteira
Perdido O negócio encerra sem venda — mas a empresa continua na base. Perder não apaga ninguém, e o registro do motivo é o que separa perda de desperdício.
  • motivo obrigatório
  • concorrente, se houver
  • objeção que travou
  • timing e fit
  • aprendizado que volta para Marketing, Produto e Estratégia

PERDER SEM REGISTRAR O MOTIVO é perder duas vezes.

// OPORTUNIDADE TAMBÉM ENVELHECE

TEMPO SEM INTERAÇÃO também é contexto.

Os dois negócios abaixo podem estar na mesma etapa, com o mesmo valor e a mesma probabilidade. E não são a mesma coisa.

exemplo ilustrativo
Negócio A
criado há2 dias
última atividadeontem
etapaProposta · 50%
próxima açãodefinida
Está vivo. A conversa aconteceu ontem e existe um movimento marcado para acontecer.
Negócio B
criado há90 dias
última atividade45 dias
etapaProposta · 50%
próxima açãonenhuma
O forecast conta os dois como 50%. Só um deles é verdade.
É por isso que forecast é hipótese, não certeza. Um pipeline cheio de negócios parados na mesma etapa parece organizado no Kanban e mente na projeção. O tempo sem interação é o sinal — e o FLOW pode reagir a ele antes de virar perda.
// ONDE O COMERCIAL COMEÇA E TERMINA

MARKETING GERA ATENÇÃO. Comercial transforma atenção em decisão.

E o retorno importa tanto quanto a entrega: conversão, objeções e motivos de perda voltam para o Marketing — senão a campanha seguinte repete o erro da anterior.

Marketing Entrega demanda com contexto.
  • campanha e canal
  • conteúdo que atraiu
  • lead com origem registrada
Comercial Devolve o que só ele sabe.
  • qual canal converteu de verdade
  • quais objeções apareceram
  • por que se perdeu
  • qualidade real do lead
Financeiro Venda fechada é fato comercial. Dinheiro recebido é fato financeiro. São dois eventos, e confundi-los é o erro mais caro do funil.
  • venda → fatura
  • fatura → recebimento
  • recebimento → receita
  • receita − custo → margem
Projetos O que foi vendido precisa chegar à operação sem perder contexto. A entrega não deveria recomeçar o briefing do zero — a proposta já disse escopo, prazo e expectativa.
  • escopo prometido
  • prazo acordado
  • o que o cliente disse querer resolver
Clientes Comercial cuida de conquistar. Clientes cuida de manter. A entidade é a mesma; o momento da relação é que mudou.
  • onboarding
  • retenção
  • sucesso e expansão
Catálogo Define o que está sendo vendido: produto, serviço, plano, oferta, preço e atributos. Sem ele, cada proposta reinventa o produto — e duas propostas do mesmo mês oferecem coisas diferentes com o mesmo nome.
archēFLOW Executa o movimento: atribuir vendedor, enriquecer contexto, criar tarefa, enviar mensagem, esperar resposta, atualizar estágio, notificar. E, na proposta aceita, disparar a transição para Financeiro e Projetos.
archēON Interpreta antes da próxima ação. Considera última interação, objeções, oferta, histórico, decisor, prazo e proposta — e sugere a próxima pergunta, não um texto pronto de follow-up.
A fronteira com o Financeiro, dita sem rodeio: o núcleo Faturas existe nos dois módulos. Não é duplicação — Comercial precisa ver a fatura como parte do contexto da venda, Financeiro precisa operar a fatura. Uma entidade, duas perguntas.
// A PERSPECTIVA COMERCIAL

HERMES  negociador.

Hermes não é um bot de follow-up. Ele representa a perspectiva comercial sobre o grafo — cliente, oferta, momento, objeção, histórico.

Quem executa capacidade específica são skills e workflows. O agente não concentra a lógica.

Retrato de Hermes, referência do agente comercial

Hermes

negociador · módulo comercial

“Qual é o caminho mais curto entre a necessidade do lead e o valor que a empresa entrega — e o que está bloqueando essa travessia agora?”

// responsabilidades
  • Acompanhar leads em cada etapa do funil
  • Estruturar e personalizar propostas
  • Conduzir follow-up no timing certo
  • Mapear objeções e preparar respostas
  • Nutrir leads frios com contexto relevante
  • Analisar conversão por etapa e sugerir melhoria
// tom declarado no sistema
  • Ágil, persuasivo, caloroso
  • Nunca insistente — confiante
  • Fala como quem já conhece o caminho
  • Usa o nome do interlocutor
  • Vai ao ponto sem ser rude
o módulo tem 18 vozes cadastradas · a função não muda, o tom muda
HermesZig ZiglarAristótelesMarco Polo ChanakyaMiyamoto MusashiNikéPelé Gordon GekkoAladdinRaposaGuepardo

Hermes é uma referência de postura, não uma ressurreição — o modelo não possui a consciência nem a personalidade histórica dele. A pergunta acima é a que está cadastrada no sistema, palavra por palavra. E repare que ela é diferente da pergunta do módulo: o módulo pergunta qual é a próxima mensagem; o agente pergunta o que está bloqueando a travessia. Uma é operação, a outra é diagnóstico.

// A META

PREVISIBILIDADE sem perder a relação.

Não basta aumentar atividade. O objetivo é a empresa saber em que estado está cada relação — e qual movimento precisa acontecer depois.

sabeQuem está sendo atendidoE quem foi esquecido no meio do mês.
sabeEm qual momentoA etapa real, não a que alguém acha que é.
sabePor quemO responsável, com nome e carteira.
sabeCom qual ofertaO que exatamente foi proposto, em qual versão.
sabeQual o próximo movimentoA coluna next_step, preenchida ou vazia.
sabePor que avança ou paraObjeção registrada e motivo de perda obrigatório.
É isso que a Governança protege. Quem pode alterar pipeline, quem aprova desconto, quando uma oportunidade pode ser encerrada, qual motivo de perda é obrigatório, quem enxerga qual carteira. Não é burocracia: é o que impede o relatório de mentir.
relatório é view, não entidade nova
conversão por etapaticket médiociclo de vendawin rate pipelineforecastorigem do leadmotivo de perda

Oito perguntas diferentes sobre os mesmos negócios. Nenhuma delas precisa de uma tabela nova.

UMA VENDA NÃO COMEÇA na proposta.

COMEÇA QUANDO ALGUÉM percebe valor.

E NÃO TERMINA no “sim”.

TERMINA QUANDO A PROMESSA pode virar relação.

Comercial A arte de mover relações até uma decisão.

QUAL É A PRÓXIMA MENSAGEM que move essa oportunidade para frente?

pessoa ou empresacontatoleadqualificação oportunidadeatividadepropostaobjeção follow-upnegociaçãodecisãovendacliente

Treze palavras. Uma entidade só.