# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-08-27T16:02:54.936Z

## Página

- Título: Prospecção B2B: mapeamento da conversão automática
- URL humana: https://agilize.app/docs/configuracao/crm-dados/mapeamento-conversao-prospeccao-b2b
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como configurar campos, tags, origem, funil e etapa usados ao converter pré-leads B2B em empresas, contatos e leads no CRM.

## Seções

- Antes de configurar
- Acessar a configuração
- Entender a tela
- Definir a aplicação automática
- Revisar os campos base
- Adicionar enriquecimento automático
- Usar sugestões de mapeamento
- Pausar, remover ou restaurar conexões

## Conteúdo da página

# Prospecção B2B: mapeamento da conversão automática

O mapeamento da conversão define como os dados públicos de um pré-lead preenchem os cadastros de empresa, contato e lead no CRM. A configuração é feita uma vez por projeto e passa a ser usada nas próximas conversões da Prospecção B2B.

Este guia é voltado a administradores. Vendedores e SDRs consultam um resumo do mapeamento no modal de conversão, mas não alteram as regras do projeto.

## Antes de configurar

Confirme estes pontos:

- você é administrador do projeto;
- as tags que devem ser aplicadas já estão cadastradas para empresa, contato ou lead;
- a origem comercial desejada já existe;
- o funil e a etapa inicial já estão configurados;
- os campos personalizados que receberão dados como CNPJ, capital social, sócios, datas ou scores já foram criados para a entidade correta.

Se ainda faltarem campos personalizados, consulte [Campos e dados obrigatórios](/docs/configuracao/crm-dados/campos-e-dados-obrigatorios). Para preparar o destino do lead, consulte [Funis, etapas e origens](/docs/configuracao/crm-dados/funis-etapas-e-origens).

## Acessar a configuração

Acesse [https://my.agilize.app/crm/lead-finder-b2b/mapping](https://my.agilize.app/crm/lead-finder-b2b/mapping).

Acesso pela tela: na barra superior, abra **Iniciar > Prospecção B2B**. No topo da funcionalidade, clique no ícone **Configurar conversão**.

O ícone aparece apenas para administradores. Um acesso direto sem esse perfil retorna para a operação ou pode ser bloqueado pela permissão da conta.

## Entender a tela

![Tela Configuração da conversão da Prospecção B2B com entidades, campos base e enriquecimento automático](/docs/images/usuarios/prospeccao-b2b/configuracao-conversao-automatica.png)

A tela separa a configuração em três entidades:

| Entidade | Resultado no CRM |
| --- | --- |
| Empresa | Cadastro organizacional. |
| Contato | Pessoa e canais de relacionamento. |
| Lead | Oportunidade posicionada em um funil e uma etapa. |

O resumo do topo mostra o total de campos configurados, a quantidade de adicionais e se existem alterações não salvas. Cada entidade mantém seu próprio conjunto de regras.

## Definir a aplicação automática

Na área **Aplicação automática**, configure os valores fixos que devem acompanhar a entidade criada:

| Configuração | Efeito |
| --- | --- |
| Tag de empresa | Adiciona a tag escolhida às empresas criadas pela conversão. |
| Tag de contato | Adiciona a tag escolhida aos contatos criados pela conversão. |
| Tag de lead | Adiciona a tag escolhida aos leads criados pela conversão. |
| Origem do lead | Preenche a origem comercial dos leads convertidos. |
| Funil padrão | Sugere o funil no modal usado pelo vendedor ou SDR. |
| Etapa padrão | Sugere uma etapa pertencente ao funil escolhido. |

O vendedor pode alterar o funil e a etapa antes de confirmar uma conversão. A etapa padrão só pode ser selecionada depois do funil e precisa pertencer a ele.

Use tags e origem para classificar a entrada. Não crie classificações duplicadas apenas para reproduzir um campo que já existe no CRM.

## Revisar os campos base

Em **Campos base**, o destino no CRM já está definido. Você escolhe qual dado do pré-lead preencherá esse destino.

Exemplos dos campos base disponíveis:

| Entidade | Destinos base |
| --- | --- |
| Empresa | Nome, telefones, e-mails, site e observações. |
| Contato | Nome, telefones, e-mails e observações. |
| Lead | Nome, telefones, e-mails, observações, ticket estimado e score. |

Os campos marcados como **Essencial** ficam protegidos para que a estrutura mínima da entidade continue válida. Outros campos base podem ser removidos quando não fizerem sentido para a operação.

Ao trocar a origem de um campo, confira o sentido do dado. Por exemplo, **Nome fantasia ou razão social** é um destino coerente para o nome da empresa ou do lead; **Telefones selecionados** deve preencher um campo de telefones.

## Adicionar enriquecimento automático

Em **Campos adicionais**, conecte dados do pré-lead a campos personalizados do CRM:

1. Selecione **Empresa**, **Contato** ou **Lead**.
2. Clique em **Adicionar campo**.
3. Em **Dado do pré-lead**, escolha a informação de origem.
4. Em **Campo personalizado no CRM**, escolha o destino.
5. Repita para os dados necessários.
6. Revise a compatibilidade e clique em **Salvar e aplicar**.

Entre os dados de origem disponíveis estão:

- identificação: nome fantasia, razão social, CNPJ completo e CNPJ raiz;
- atividade: CNAE e descrição da atividade principal;
- dados cadastrais: abertura, porte, natureza jurídica, capital social, Simples e MEI;
- localização: UF, município, CEP e endereço;
- contatos: site, telefones e e-mails selecionados;
- sócios: nomes e qualificações;
- qualidade: score de prioridade, potencial cadastral e qualidade do contato;
- conversão: nome informado para o contato, resumo cadastral e nota de origem.

A tela filtra os destinos conforme o tipo do dado. Campos de número recebem valores numéricos; campos de data recebem datas; campos de lista precisam de valores compatíveis com as opções cadastradas.

Um campo personalizado de lead pode estar limitado a funis específicos. Quando isso ocorrer, a tela mostra o aviso **Disponível somente em**. O valor só será aplicado quando o lead for convertido para um funil permitido.

## Usar sugestões de mapeamento

Quando o nome e o tipo de um campo personalizado indicam um destino conhecido, a tela pode oferecer **Aplicar sugestões**. Exemplos comuns incluem CNPJ, capital social, sócio principal, data de abertura, CNAE, cidade e scores.

Use a sugestão como ponto de partida:

1. clique em **Aplicar sugestões**;
2. revise cada origem e destino adicionados;
3. remova conexões sem utilidade;
4. confirme as restrições por funil;
5. salve somente depois da revisão.

A sugestão não substitui a decisão sobre quais dados são úteis para o processo comercial.

## Pausar, remover ou restaurar conexões

Para campos adicionais:

- desligue a chave para pausar uma conexão sem removê-la;
- use o ícone de lixeira para remover a conexão;
- evite mapear mais de uma origem para o mesmo destino.

Use **Restaurar padrões** para recuperar os campos base recomendados da entidade selecionada. A restauração não é aplicada imediatamente: revise e clique em **Salvar e aplicar**.

Use **Desfazer alterações** para voltar à última versão salva enquanto ainda estiver na tela.

## Salvar e validar

Antes de salvar:

- revise as três entidades;
- confirme tags, origem, funil e etapa;
- mantenha todos os campos essenciais ativos;
- elimine conexões incompletas;
- confira se cada campo adicional pertence à entidade correta;
- valide restrições de funil e tipo de campo.

Clique em **Salvar e aplicar**. O rodapé passa a mostrar a versão e o horário do salvamento.

As conversões continuam usando a última versão salva enquanto houver alterações pendentes. A nova configuração vale para conversões futuras e não atualiza automaticamente empresas, contatos ou leads que já existem no CRM.

## Fazer um teste controlado

Depois de salvar:

1. abra um pré-lead de demonstração em **Minha operação**;
2. clique em **Converter no CRM**;
3. selecione apenas as entidades necessárias para o teste;
4. revise o resumo dos campos no modal;
5. confirme o funil e a etapa;
6. conclua a conversão;
7. abra os registros criados e confira campos base, adicionais, tags, origem e vínculos.

Não use uma empresa real apenas para testar. Se o registro de demonstração precisar ser removido, siga o processo de governança da sua conta.

## Problemas comuns

| Situação | Causa provável | Correção |
| --- | --- | --- |
| O ícone de configuração não aparece | O usuário não é administrador. | Peça a um administrador do projeto para revisar o mapeamento. |
| O campo personalizado não aparece como destino | O campo foi criado para outra entidade ou não está disponível. | Revise o cadastro do campo para empresa, contato ou lead. |
| Uma origem não aparece para o campo | O tipo do dado é incompatível com o destino. | Escolha um campo de destino com tipo compatível. |
| A etapa não pode ser selecionada | Nenhum funil foi escolhido ou a etapa pertence a outro funil. | Selecione o funil correto e depois a etapa. |
| O campo adicional não foi preenchido | O pré-lead não tinha valor, a conexão estava pausada ou o funil não era permitido. | Revise o dado de origem, a chave da conexão e a restrição do campo. |
| A conversão ainda usou a regra antiga | As alterações não foram salvas. | Volte à tela e clique em **Salvar e aplicar**. |
| Um cadastro antigo não mudou | O mapeamento não é retroativo. | Corrija o registro existente manualmente ou pelo fluxo autorizado da conta. |
| A tela impede o salvamento | Existe conexão incompleta, incompatível ou campo essencial ausente. | Revise a mensagem exibida no rodapé e corrija a conexão indicada. |

## Próximos passos

- Oriente o time com [Operação da Prospecção B2B para vendedor e SDR](/docs/usuarios/crm-relacionamento/outros/prospeccao-b2b-operacao-vendedor-sdr).
- Revise os destinos em [Campos e dados obrigatórios](/docs/configuracao/crm-dados/campos-e-dados-obrigatorios).
- Confirme a entrada comercial em [Funis, etapas e origens](/docs/configuracao/crm-dados/funis-etapas-e-origens).
- Padronize a classificação em [Tags e regras](/docs/configuracao/crm-dados/tags-automacoes-e-regras).
- Valide o resultado em [CRM e oportunidades](/docs/usuarios/crm-relacionamento/crm-e-oportunidades) e [Contatos e empresas](/docs/usuarios/crm-relacionamento/contatos-e-empresas).
- Consulte [Qualidade de dados e prevenção de duplicidade](/docs/configuracao/crm-dados/qualidade-dados-prevencao-duplicidade) antes de ampliar a operação.