Como Migrar do HubSpot para o Bitrix24: Plano Passo a Passo

O que é Migrado - e o que Não É

Em uma migração padrão do HubSpot para o Bitrix24, contatos, empresas, negócios e produtos são transferidos sem problemas via importação de CSV/Excel, enquanto o histórico de atividades só é migrado com scripts personalizados, e arquivos anexados, lógica de automações e propriedades do painel lateral não podem ser migrados pelos meios convencionais.

Antes de confirmar uma migração, é importante saber exatamente quais objetos de dados são transferidos sem complicações e quais exigem esforço adicional. A tabela abaixo reflete o que nosso histórico de projetos aponta como viável em um engajamento padrão.

Regra fundamental da nossa prática: apenas os dados da parte principal (lado esquerdo) de um card de CRM são transferidos via importação padrão. Histórico de atividades, arquivos anexados e lógica de automações precisam ser reconstruídos.

Fase 1: Auditoria e Inventário

A Fase 1 produz um inventário completo de todos os objetos de CRM do HubSpot, pipelines, automações, integrações, usuários e templates antes de qualquer movimentação de dados, e é o momento certo para excluir registros obsoletos que inflariam desnecessariamente o escopo e o custo da migração.

O objetivo da primeira fase é ter uma visão completa de tudo o que existe na sua conta HubSpot antes que um único registro seja movido.

O que documentar:

• Todos os objetos de CRM: contatos, empresas, negócios, produtos, objetos personalizados
• Quantidade de pipelines e configuração de etapas por pipeline
• Automações, sequências e workflows ativos
• Integrações com terceiros (provedores de e-mail, telefonia, ferramentas de chat, formulários, ERPs)
• Lista de usuários, perfis e direitos de acesso
• Templates de documentos e arquivos gerados

Dica prática: exporte cada tipo de objeto do HubSpot em CSV nesta etapa. Você usará esses arquivos tanto como fonte de dados quanto como referência para verificações de integridade após a migração. Se o seu conjunto de dados contiver objetos desatualizados ou inutilizados, este é o momento certo para excluí-los - migrar dados mortos aumenta o escopo do projeto e desacelera o novo portal.

Fase 2: Configurar o Novo Portal Bitrix24

A Fase 2 constrói todo o ambiente de destino no Bitrix24 - estrutura da empresa, campos personalizados, pipelines, direitos de acesso e configurações do sistema - antes de qualquer carregamento de registros, garantindo que os dados sejam inseridos em uma estrutura completamente preparada.

A migração de dados só funciona de forma limpa quando o ambiente de destino está pronto. Esta fase monta a estrutura antes de qualquer carregamento de registros.

Etapas:

1. Estrutura da empresa - criar departamentos, cargos e contas de usuário que espelhem o organograma atual.
2. Campos personalizados - replicar cada propriedade do HubSpot (texto, número, data, lista, etc.) como campos equivalentes no Bitrix24.
3. Pipelines e etapas de CRM - reconstruir cada pipeline do HubSpot como um funil de negócios (ou processo inteligente) no Bitrix24, com nomes de etapas e status finais correspondentes (ganho / perdido).
4. Matriz de direitos de acesso - configurar permissões baseadas em perfil para leads, negócios, contatos e empresas, restringindo visualização, edição e exportação por perfil.
5. Configurações básicas do sistema - menu de navegação, eventos de e-mail, configurações de notificações.

Somente as configurações vinculadas a dados efetivamente utilizados devem ser criadas. Entidades obsoletas identificadas na fase de auditoria são excluídas aqui.

Fase 3: Migração de Dados

A Fase 3 é a fase técnica central, utilizando importação via CSV/Excel para a maioria dos projetos de PME (2 a 15 horas por tipo de entidade) ou scripts personalizados em PHP/CLI para ambientes complexos, com carregamento em duas passagens e mapeamento de IDs para preservar todos os relacionamentos entre entidades.

Esta é a fase técnica central. Dependendo da complexidade do projeto, duas abordagens são utilizadas:

Importação padrão (CSV/Excel)

Para a maioria das migrações de PME, os dados são exportados do HubSpot, limpos e formatados conforme o template do Bitrix24, e importados pela ferramenta de importação nativa. A migração ocorre em múltiplas passagens:

• Passagem 1 - carga inicial
• Passagem 2 - carga delta (registros alterados durante a janela de migração)

Estimativas de tempo típicas com base em projetos reais:

• Contatos: 2 a 4 horas
• Empresas: 2 a 4 horas
• Negócios: 2 a 15 horas (dependendo do volume e da complexidade do pipeline)
• Produtos: 2 a 4 horas

Scripts de migração personalizados (para projetos complexos)

Para ambientes maiores ou mais complexos, scripts personalizados em PHP/CLI são desenvolvidos. A ordem de migração segue as dependências entre entidades:

Usuários → Estrutura organizacional → Blocos de informação → Entidades de CRM → Histórico

Os scripts gerenciam o mapeamento de IDs (IDs antigos do HubSpot → novos IDs do Bitrix24) para que os relacionamentos entre entidades (por exemplo, um negócio vinculado a um contato vinculado a uma empresa) sejam preservados. Todos os scripts são testados em uma cópia do banco de dados antes da execução em produção.

O fluxo de dados durante uma migração com scripts.

flowchart LR
    HS[HubSpot Export\nCSV / API] --> CLEAN[Data Cleaning\n& Field Mapping]
    CLEAN --> SCRIPTS[Migration Scripts\nPHP/CLI]
    SCRIPTS --> USERS[Users &\nOrg Structure]
    SCRIPTS --> CRM[CRM Entities\nContacts → Companies → Deals]
    SCRIPTS --> TL[Timeline\nActivities]
    USERS --> B24[Bitrix24 Portal]
    CRM --> B24
    TL --> B24
    B24 --> CHECK[Integrity Check\n& Report]

O que não é migrado pelos meios padrão:

• Arquivos anexados a registros
• Comentários e entradas do log de atividades (requer scripts)
• Registros de processos inteligentes (sem API de importação padrão; devem ser carregados manualmente ou via aplicativo personalizado)

Fase 4: Automações e Processos de Negócio

A Fase 4 reimplementa todos os workflows do HubSpot do zero usando robôs e gatilhos do Bitrix24, com um escopo típico para uma equipe de vendas de médio porte de até 15 robôs por pipeline, cobrindo transferências de negócios, criação de tarefas, notificações e cálculos agregados.

Os workflows do HubSpot não são portados diretamente para o Bitrix24. Eles precisam ser reimplementados usando as ferramentas nativas do Bitrix24: robôs (ações automatizadas disparadas por mudança de etapa) e gatilhos (condições que acionam um robô).

Cenários de automação típicos reconstruídos nesta fase:

• Transferência automática de negócios entre pipelines ao concluir uma etapa, com cópia mantida no pipeline de origem para fins de relatório
• Criação de tarefas com lembretes quando um negócio permanece em uma etapa além de um prazo definido
• Notificações para os gestores responsáveis em caso de alteração no status de um negócio
• Cálculos agregados (por exemplo, somar a receita de subprocessos vinculados ao card do negócio principal)
• Preenchimento automático de campos de status e cópia de dados entre entidades

Cada cenário é testado de ponta a ponta antes da aprovação. Até 15 robôs por pipeline é um escopo típico de projeto para uma equipe de vendas de médio porte.

Fase 5: Reconexão das Integrações

A Fase 5 reconecta todas as integrações - VoIP, WhatsApp, contas de e-mail, ferramentas de captura de leads, marketplaces e ERPs - inteiramente do zero, pois tokens OAuth e credenciais de API não são transferidos, com tempo de reconexão variando de 2 a 15 horas dependendo da quantidade de sistemas.

Todas as integrações precisam ser reconectadas do zero no novo portal. Isso vale mesmo na migração entre dois ambientes na nuvem - o contexto do servidor muda, portanto tokens OAuth, URLs de webhook e credenciais de API precisam ser reinseridos.

Integrações típicas reconectadas em um projeto de migração:

• VoIP / telefonia (registro de chamadas, click-to-call)
• Conectores de WhatsApp / mensageria
• Contas de e-mail (10 ou mais caixas de entrada não é incomum; cada uma é reconectada individualmente; guias de configuração são fornecidos)
• Ferramentas de landing page / captura de leads (por exemplo, construtores de sites)
• Marketplaces e plataformas de classificados
• ERP ou sistemas de contabilidade

Responsabilidade do cliente: o cliente fornece todas as credenciais, chaves de API e acessos administrativos dos serviços de terceiros. O tempo de integração varia de 2 a 15 horas, dependendo do número de sistemas e da disponibilidade de conectores padrão no marketplace.

É necessária uma assinatura do Bitrix24 Marketplace para instalar aplicativos conectores disponíveis no marketplace.

Fase 6: Testes e Go-Live

A Fase 6 realiza um teste de aceite conjunto cobrindo contagens de registros, vínculos entre entidades, automações, integrações, direitos de acesso e templates de documentos, seguido da configuração do HubSpot em modo somente leitura e da oferta de um mês de suporte em garantia para problemas relacionados à migração.

Antes de migrar a equipe para o Bitrix24, um teste de aceite conjunto é realizado com o cliente.

Checklist:

• As contagens de registros no Bitrix24 correspondem aos números do inventário pré-migração
• Os vínculos entre entidades (negócio ↔ contato ↔ empresa) estão intactos
• As etapas do pipeline e os valores dos campos estão corretos em uma amostra de registros
• As automações são disparadas corretamente em negócios de teste
• As integrações processam mensagens reais (chamada de teste, envio de formulário de teste, e-mail de teste)
• Os direitos de acesso impedem ações não autorizadas entre os perfis
• Os templates de documentos são gerados corretamente com os novos IDs de campo

Após o aceite, a instância antiga do HubSpot é configurada como somente leitura (não excluída) por um período definido. O monitoramento pós-lançamento cobre as primeiras semanas de operação em produção.

Um mês de suporte em garantia é padrão em nossos contratos de projeto, cobrindo problemas diretamente relacionados ao escopo acordado de migração e configuração.

Prazo e Orçamento

Uma migração do HubSpot para o Bitrix24 leva tipicamente 2 semanas para equipes pequenas e 8 semanas ou mais para portais complexos, com orçamento variando de aproximadamente $1.000 a $5.000+ USD dependendo do volume de dados, número de integrações, complexidade das automações e necessidade de desenvolvimento de scripts personalizados.

O orçamento varia significativamente por região e escopo. Com base em nosso histórico de projetos, uma migração de nuvem para nuvem com integrações situa-se em uma faixa comparável a $1.000 - $5.000+ USD, dependendo do volume de dados, número de integrações e complexidade das automações. Projetos complexos com desenvolvimento de scripts personalizados ficam na extremidade mais alta. Estimativas precisas requerem uma chamada de escopo e auditoria dos dados.

Fatores que aumentam o escopo (e o custo):

• Dados não documentados ou ocultos descobertos durante a migração
• Propriedades personalizadas do HubSpot sem equivalente direto no Bitrix24
• Registros de processos inteligentes que não podem ser importados pelas ferramentas padrão
• Integração com ERP ou outros sistemas corporativos
• Múltiplas rodadas de testes e correções
• Atrasos por parte do cliente no fornecimento de dados ou credenciais