Como Migrar do Pipeprive

Essa integração é orientada a importação: depois de configuradas as credenciais do Pipedrive, o BomControle executa uma tarefa de importação em segundo plano que lê dados via API do Pipedrive e cria ou atualiza registros no módulo CRM. Os itens importados incluem:

• Organizações (empresas) – tratadas como leads de pessoa jurídica no BomControle;

• Pessoas – contatos associados às organizações;

• Funis de vendas e etapas;

• Oportunidades – negócios em andamento;

• Campos customizados e respectivos valores.

Essa importação não é contínua em tempo real. Sempre que desejar atualizar os dados, você deve executar novamente a importação. Quando concluída a importação, o sistema envia um e‑mail e uma notificação interna com o resumo dos itens importados, atualizados e eventuais erros.

Acessando a área de importação

1. Logue no BomControle com sua conta.

2. No canto superior direito da interface clique no ícone de engrenagem (⚙️). Ele abre um menu de configurações.

3. Selecione Importação de Dados. Você verá uma tela com as opções de importação (Pipedrive, CA e NFE). A figura abaixo mostra a seção de importações com destaque para o Pipedrive:

Na tela acima:

1. identifica a seção Pipedrive – o texto ressalta que serão importadas oportunidades, leads e funil de vendas.

2. é o botão “Importar” que abre o formulário de configuração da integração.

Configurando a integração do Pipedrive

Ao clicar em Importar na linha do Pipedrive, um formulário modal é exibido. Esse formulário solicita os dados necessários para que o BomControle se autentique na API do Pipedrive e associe os registros importados à empresa e ao vendedor no BomControle. Na figura abaixo destacamos os campos principais:

1. Company Domain – insira o domínio da sua conta no Pipedrive. No Pipedrive, esse valor fica em Company Settings > General > Company Domain. É o identificador que aparece na URL ao acessar sua conta.

2. API Token – insira o token de API gerado no Pipedrive. No Pipedrive, vá em Personal Preferences > API, copie o token mostrado e cole aqui.

3. Empresa – selecione a empresa do BomControle que receberá as oportunidades/leads importados. Esta associação é importante para que as informações fiquem atreladas à empresa correta no CRM.

4. Vendedor – selecione o usuário do BomControle que será definido como responsável (owner) das oportunidades e leads vindos do Pipedrive.

5. Salvar e importar – após preencher todos os campos, clique nesse botão para salvar as credenciais e iniciar a importação. Se você só deseja cancelar a operação, utilize o botão Cancelar no canto inferior esquerdo.

Obtendo os dados no Pipedrive

Company Domain: acesse o Pipedrive com um usuário administrador e vá em Company Settings > General. Copie o valor mostrado no campo Company Domain.

API Token: acesse Personal Preferences > API, clique em Generate new token (se ainda não houver um token) e copie o código apresentado. Mantenha esse token em segurança.

Como funciona o processo de importação

1. Salvar as credenciais: quando você clica em Salvar e importar, o BomControle armazena o domínio, o token, a empresa e o vendedor nas configurações. O BomControle cria ou atualiza esse registro e, em seguida, executa uma tarefa de importação.

2. Execução da impportação: a importação é executada em segundo plano que por sua vez executa uma série de passos de importação:

   • Organizações: o serviço faz chamadas na API do Pipedrive, pagina os resultados e, para cada organização, verifica se já existe um lead de pessoa jurídica com o mesmo código do Pipedrive. Se não houver, cria um novo lead; se existir, atualiza as informações.

   • Pessoas (contatos): são obtidas via API do Pipedrive. Para cada pessoa, o serviço busca a organização correspondente e cria ou atualiza o contato associado.

   • Funis de vendas, etapas e oportunidades: também são consultados via API e criados/atualizados no BomControle. Campos customizados são trazidos para manter a consistência dos dados.

   • Notificação: ao final do processo, o BomControle monta um e‑mail/aviso com os totais de registros importados, atualizados, erros e totais e envia para o usuário responsável.

3. Resumo e conclusão: o usuário recebe uma notificação por e‑mail e na interface do BomControle informando que a importação terminou e indicando quantos itens foram importados/atualizados ou se houve erros. Caso ocorra algum erro crítico (por exemplo, token inválido ou falta de acesso), a notificação trará a mensagem de erro para facilitar a correção.

Atualizações posteriores

O sistema não mantém sincronização contínua. Após a conclusão da tarefa, os dados são armazenados no BomControle, e nenhuma atualização automática é realizada quando você cria ou altera itens no Pipedrive. Para importar novos registros ou sincronizar mudanças feitas posteriormente no Pipedrive, basta abrir novamente a tela de importação, conferir/ajustar o Company Domain, API Token, Empresa e Vendedor, e clicar em Salvar e importar outra vez. Uma nova tarefa de importação será enfileirada e executada.

Acompanhando os registros importados

Depois de receber a notificação de conclusão, navegue até o módulo CRM do BomControle para visualizar os leads, contatos e oportunidades importados. Como o serviço verifica a existência de registros através do código no Pipedrive, os leads e oportunidades não são duplicados; em vez disso, os dados existentes são atualizados. Para validar e complementar as informações importadas, edite os registros no CRM conforme necessário.

Dicas e boas práticas

• Verifique as credenciais antes de iniciar a importação: token expirado ou domínio incorreto causam falhas de autenticação. Caso ocorra erro, gere um novo token no Pipedrive e atualize a configuração.

• Escolha corretamente a Empresa e o Vendedor: isso determina a quem os leads e oportunidades serão atribuídos no BomControle.

• Planeje importações periódicas: como a integração não é em tempo real, defina uma periodicidade (por exemplo, semanal) para executar a importação novamente e manter as bases alinhadas.

• Acompanhe as notificações: o resumo enviado pelo BomControle informa quantos registros foram criados, atualizados ou apresentaram erros – use esse feedback para verificar se há inconsistências a corrigir no Pipedrive.

Conclusão

A integração do BomControle com o Pipedrive facilita o carregamento inicial de leads, contatos, funis e oportunidades. Com poucos passos você configura as credenciais e aciona a importação. O processo em segundo plano evita bloquear o uso do sistema e ao final você é informado sobre o resultado. Sempre que houver novas informações ou alterações no Pipedrive, basta repetir a operação para atualizar sua base no BomControle.