Implementando Conversão de Leads em CRM

1. Introdução

Este tutorial vai te guiar passo a passo na implementação da funcionalidade de Conversão de Oportunidades (Opportunity Conversion) do CRM no NocoBase. Vamos apresentar como criar as collections (tabelas de dados) necessárias, configurar páginas de gerenciamento de dados, projetar o fluxo de conversão e configurar gerenciamento de associações, ajudando você a construir todo o processo de negócio com sucesso.

🎉 A solução de CRM do NocoBase está oficialmente no ar! Experimente!

2. Preparação: Criar as Collections Necessárias

Antes de começar, precisamos preparar as 4 collections abaixo e configurar seus relacionamentos.

2.1 LEAD Collection (Lead)

Essa é a collection para armazenar informações de potenciais clientes; os campos são:

Field nameNome de exibiçãoField interfaceDescription
idIdIntegerChave primária
account_idaccount_idIntegerFK ACCOUNT
contact_idcontact_idIntegerFK CONTACT
opportunity_idopportunity_idIntegerFK OPPORTUNITY
nameNome do leadSingle line textNome do potencial cliente
companyEmpresaSingle line textNome da empresa do potencial cliente
emailE-mailEmailE-mail do potencial cliente
phoneTelefonePhoneTelefone de contato
statusStatusSingle selectStatus atual do lead (Não qualificado, Novo lead, Em atendimento, Em follow-up, Em negociação, Concluído)
AccountEmpresaMany to oneAssociada à collection de Empresas
ContactContatoMany to oneAssociada à collection de Contatos
OpportunityOportunidadeMany to oneAssociada à collection de Oportunidades

2.2 ACCOUNT Collection (Empresa)

Para armazenar detalhes da empresa; configuração de campos:

Field nameNome de exibiçãoField interfaceDescription
nameNomeSingle line textNome da conta (empresa ou organização)
industrySetorSingle selectSetor da conta
phoneTelefonePhoneTelefone de contato da conta
websiteSiteURLSite oficial da conta

2.3 CONTACT Collection (Contato)

Collection para armazenar informações de contatos; campos:

Field nameNome de exibiçãoField interfaceDescription
nameNomeSingle line textNome do contato
emailE-mailEmailE-mail do contato
phoneTelefonePhoneTelefone do contato

2.4 OPPORTUNITY Collection (Oportunidade)

Para registrar informações de oportunidade; os campos:

Field nameNome de exibiçãoField interfaceDescription
nameNomeSingle line textNome da oportunidade
stageEtapaSingle selectEtapa da oportunidade (Qualificação, Necessidade, Proposta, Negociação, Fechamento, Sucesso, Falha)
amountValorNumberValor da oportunidade
close_dateData de fechamentoDatetimeData prevista de fechamento

3. Entendendo o Fluxo de Conversão de Oportunidade

3.1 Visão geral do fluxo normal

Uma oportunidade, ao ser convertida de lead, geralmente passa pelas seguintes etapas:

20250225211802

3.2 Explicação dos relacionamentos

Suponha que você criou as 4 collections acima e configurou os relacionamentos de negócio entre elas:

Relacionamentos

4. Criar Páginas de Gerenciamento de Dados

No espaço de trabalho do NocoBase, crie páginas de gerenciamento de dados para cada collection, e adicione alguns leads aleatórios para testar.

Páginas de gerenciamento

5. Implementar a Conversão de Oportunidade

Esta seção foca em como converter um lead em dados de empresa, contato e oportunidade, e garantir que a operação de conversão não seja disparada repetidamente.

5.1 Criar a operação de edição «Converter»

Na tela de detalhes do lead correspondente, crie uma operação de edição com nome «Converter». No popup de conversão, faça as seguintes configurações:

5.1.1 Exibir informações básicas do lead

Exiba as informações básicas do lead em modo somente leitura, garantindo que o usuário não modifique acidentalmente os dados originais.

5.1.2 Exibir campos de relacionamento

No popup, exiba os três campos de relacionamento abaixo, ativando «Criação rápida» em cada um, para criar dados imediatamente quando não for encontrado um match.

Exibir campos de relacionamento

5.1.3 Configurar mapeamento padrão da criação rápida

No popup de configurações da «Criação rápida», configure valores padrão para cada campo de relacionamento, mapeando automaticamente as informações do lead para a collection alvo. Regras de mapeamento:

  • Lead/Nome do lead → Empresa/Nome
  • Lead/E-mail → Empresa/E-mail
  • Lead/Telefone → Empresa/Telefone
  • Lead/Nome do lead → Contato/Nome
  • Lead/E-mail → Contato/E-mail
  • Lead/Telefone → Contato/Telefone
  • Lead/Nome do lead → Oportunidade/Nome
  • Lead/Status → Oportunidade/Etapa

Print de configuração:

Mapeamento padrão 1

Em seguida, vamos adicionar um feedback amigável à operação de submeter: 20250226154935 20250226154952

Efeito de submissão: Mapeamento padrão 2

5.1.4 Verificar efeito da conversão

Após configurar, ao executar a conversão, o sistema cria e relaciona novos dados de empresa, contato e oportunidade, conforme o mapeamento. Exemplo:

5.2 Evitar Conversão Duplicada

Para evitar que o mesmo lead seja convertido várias vezes, podemos controlar das seguintes formas:

5.2.1 Atualizar status do lead

Na operação de submeter do formulário de conversão, adicione um passo de atualização automática de dados, mudando o status do lead para «Convertido».

Print de configuração:

Atualizar status 1 Atualizar status 2 Demonstração: 202502252130-transfer

5.2.2 Configurar regra de vinculação do botão

Adicione uma regra de vinculação ao botão de conversão: quando o status do lead for «Convertido», esconde o botão automaticamente, evitando operações duplicadas.

Print de configuração:

Vinculação botão 1 Vinculação botão 2 Vinculação botão 3

6. Configurar Blocos de Gerenciamento de Associações na Página de Detalhes

Para que os usuários possam ver os dados associados nas páginas de detalhes de cada Collection, você precisa configurar os blocos de lista ou blocos de detalhes correspondentes.

6.1 Configurar Página de Detalhes da Collection Empresa

Na página de detalhes da empresa (por exemplo, no popup de edição/detalhes do contato), adicione os seguintes blocos de lista:

  • Lista de contatos
  • Lista de oportunidades
  • Lista de leads

Print de exemplo:

Página de detalhes da empresa

6.2 Adicionar Condições de Filtro

Adicione regras de filtragem em cada bloco de lista, garantindo que só exibam os dados associados ao ID da empresa atual.

Print de configuração:

Filtro 1 Filtro 2

6.3 Configurar Página de Detalhes do Contato e da Oportunidade

No popup de detalhes da Collection de Contato, adicione os seguintes blocos:

  • Lista de oportunidades
  • Detalhes da empresa
  • Lista de leads (filtrado por ID)

Print:

Detalhes do contato

Na página de detalhes da oportunidade, adicione também:

  • Lista de contatos
  • Detalhes da empresa
  • Lista de leads (filtrado por ID)

Print:

Detalhes da oportunidade

7. Conclusão

Com os passos acima, você implementou com sucesso uma funcionalidade simples de conversão de oportunidade em CRM, e configurou o gerenciamento de associações entre contatos, empresas e leads. Esperamos que este tutorial, de forma clara e gradual, tenha te ajudado a dominar a construção de todo o processo de negócio, trazendo praticidade e eficiência operacional ao seu projeto.


Se encontrar qualquer problema durante o processo, sinta-se à vontade para conversar na comunidade NocoBase ou consultar a documentação oficial. Esperamos que este guia possa ajudar você a implementar a revisão de cadastro de usuário conforme suas necessidades reais e estender flexivelmente. Bom uso e sucesso no projeto!