O Que é Migrado e Para Onde
A ferramenta de migração importa clientes, negócios e histórico de atividades do Bitrix24 ou amoCRM para o Mavibot CRM.
Para acessá-la, vá para CRM → Configurações do Pipeline (ícone de engrenagem) → "Migração de CRM" → "Abrir".
Se o seu projeto ainda não tiver pipelines, você verá um link "Migre seus dados" na tela vazia do CRM.
| Dados | Bitrix24 | amoCRM | Destino no Mavibot |
|---|---|---|---|
| Clientes | Contatos | Contatos | Clientes do CRM |
| Empresas | Incluindo detalhes da empresa e informações bancárias | Incluindo detalhes do campo "Pessoa Jurídica" | Empresas dos clientes |
| Negócios | Todos os pipelines | Todos os pipelines | Negócios nos pipelines selecionados |
| Negócios fechados | Opcional | Opcional | Status "Ganhos" e "Perdidos" |
| Leads | Opcional, importados para um pipeline separado | amoCRM não tem leads separados | Pipeline "Leads (Bitrix24)" |
| Tarefas | Atividades e tarefas | Tarefas | Tarefas do CRM |
| Comentários | Comentários da linha do tempo | Notas e SMS | Notas nas conversas dos clientes |
| Chamadas | Incluindo links de gravação | Incluindo links de gravação | Registros de chamadas nas conversas dos clientes |
| Conversas | Canais Abertos, opcionalmente incluindo arquivos | Não disponível: o amoCRM não fornece conversas através de sua API | Conversas dos clientes |
| Campos personalizados | Campos de contato, negócio e lead | Campos de contato e negócio | Variáveis de cliente e negócio |
| Funcionários designados | Através do mapeamento de funcionários | Através do mapeamento de funcionários | Membros da equipe do projeto |
| Tags | Tipo de contato e fonte | Tags | Tags dos clientes |
Antes de Começar
Somente funcionários com permissão para editar dados do CRM no Mavibot podem iniciar uma migração.
No seu CRM anterior, as credenciais de acesso devem ser criadas por um administrador. A ferramenta de migração só pode acessar dados que a pessoa que criou as credenciais está autorizada a visualizar.
- Seu CRM anterior permanece inalterado. A ferramenta de migração apenas lê dados. Você pode continuar trabalhando no Bitrix24 ou amoCRM normalmente.
- Sem clientes duplicados. Se um cliente com o mesmo número de telefone ou endereço de e-mail já existir no Mavibot (por exemplo, alguém que entrou em contato anteriormente via WhatsApp), o perfil existente será atualizado. Apenas campos vazios são preenchidos; valores existentes permanecem inalterados.
- Nenhuma mensagem é enviada aos clientes. Automações, bots e campanhas do CRM não são acionados durante a migração. Clientes importados não são movidos para o topo da lista de conversas.
- Você pode executar a migração novamente com segurança. Registros importados anteriormente são atualizados ou ignorados, e apenas novos dados são adicionados.
Antes de começar, você deve marcar a caixa confirmando:
"Os dados pertencem à nossa empresa, e autorizamos o Mavibot a migrá-los."
A migração não pode começar sem essa confirmação.
Migrando do Bitrix24
Para conectar o Bitrix24, você precisa de um webhook de entrada. Criar um leva aproximadamente dois minutos.
Crie o webhook usando uma conta de administrador do Bitrix24 para que a migração possa acessar todos os negócios e conversas.
- No Bitrix24, vá para Desenvolvedores → Outro → Webhook de Entrada.
- Selecione as permissões listadas na tabela abaixo. Apenas CRM é estritamente necessária, mas sem as outras permissões, alguns dados não serão importados.
- Clique em Salvar e copie a URL do campo "Webhook para chamar API REST". Ela se parece com isto:
https://seu-portal.bitrix24.ru/rest/1/xxxxxxxxxxxx/. - No Mavibot, abra Migração de CRM, selecione a aba Bitrix24 e cole a URL no campo "URL do Webhook de Entrada".
- Confirme que você é o proprietário dos dados e clique em "Verificar Acesso e Descobrir Dados". Em seguida, siga as etapas do assistente de migração descritas abaixo.
| Permissão do Webhook | O Que Ela Fornece | Sem Ela |
|---|---|---|
| CRM | Clientes, empresas, negócios, leads, atividades, comentários | A migração não pode começar |
| Usuários (Básico) | Lista de funcionários para mapeamento | Negócios não terão funcionários designados |
| Canais Abertos | Conversas dos clientes | Conversas não serão importadas |
| Tarefas | Tarefas do módulo de Tarefas | Apenas atividades do CRM serão importadas |
| Telefonia | Duração das chamadas e links de gravação | Chamadas não terão duração ou links de gravação |
| Drive | Arquivos de conversas | Alguns arquivos permanecerão como links nas mensagens |
Se alguma permissão estiver faltando, o assistente exibirá um aviso durante a etapa "Dados Encontrados".
Adicione a permissão necessária nas configurações do webhook do Bitrix24 e clique em "Descobrir Novamente".
O Bitrix24 permite no máximo duas solicitações por segundo, então coletar dados de um portal grande pode levar mais tempo.
Você pode fechar a página enquanto a migração é executada em segundo plano.
Erros de Conexão
| Mensagem de Erro | O Que Fazer |
|---|---|
| "Esta não é uma URL de webhook" | Você inseriu um endereço de portal ou e-mail. Copie a URL do campo "Webhook para chamar API REST" |
| "A URL do webhook deve começar com https://" | Copie a URL completa, incluindo https://
|
| "O Bitrix24 rejeitou o webhook" | O webhook foi excluído ou a URL foi copiada incorretamente. Crie um novo webhook |
| "O webhook não tem permissão de CRM" | Habilite a permissão de CRM nas configurações do webhook |
| "O Bitrix24 não está respondendo" | Verifique o endereço do portal na URL do webhook e tente novamente |
| "O Bitrix24 não removeu o limite de taxa de solicitações" | O portal pode estar ocupado com outras integrações. Tente novamente mais tarde |
Se a seção Desenvolvedores estiver ausente no menu do Bitrix24 ou você não conseguir salvar um webhook, verifique o plano de assinatura do Bitrix24.
Webhooks podem não estar disponíveis no plano gratuito do Bitrix24.
Migrando do amoCRM
Para conectar o amoCRM, você precisa do endereço da sua conta e de um token de longo prazo de uma integração externa.
Apenas um administrador da conta pode gerar o token.
Ao criar a integração, o amoCRM envia um código de verificação para o endereço de e-mail do administrador, então certifique-se de ter acesso a essa caixa de entrada.
- No amoCRM, abra amoMarket → ⋯ (canto superior direito) → Criar Integração → Integração Externa → Criar.
- Preencha o formulário:
- URL de Redirecionamento — qualquer endereço HTTPS, como o seu site. Não é usado para o token.
- Conceder Acesso — selecione "Acesso aos Dados da Conta". Nenhuma outra permissão é necessária.
- Nome e descrição — por exemplo, "Migração para Mavibot".
- Logotipo — qualquer imagem 400×272. Sem um logotipo, o amoCRM pode não salvar a integração.
- Clique em Salvar. O amoCRM pedirá que você confirme a integração. Clique em Enviar Código, insira o código de seis dígitos do e-mail e clique em Confirmar.
- Abra a integração criada e vá para Chaves e Acesso → Gerar Token de Longo Prazo. Selecione um período de expiração. Um mês geralmente é suficiente para a migração.
- Copie o token imediatamente. O amoCRM o exibe apenas uma vez.
- No Mavibot, abra Migração de CRM e selecione a aba amoCRM. Digite
company.amocrm.ruou simplesmentecompanyno campo "Endereço da Conta". O endereçocompany.amocrm.comtambém é suportado. Cole seu token no campo "Token de Longo Prazo". - Confirme que você é o proprietário dos dados e clique em "Verificar Acesso e Descobrir Dados". Em seguida, siga as etapas do assistente descritas abaixo.
O endereço da conta e o token são armazenados de forma criptografada e excluídos quando o registro de migração é removido.
O amoCRM não fornece acesso a conversas através de sua API. O assistente de migração exibe um aviso sobre isso antes do início da migração.
Erros de Conexão
| Mensagem de Erro | O Que Fazer |
|---|---|
| Código de verificação não recebido | O código é enviado para o e-mail associado à sua conta amoCRM. Verifique sua pasta de Spam ou crie a integração usando outra conta de administrador |
| "O endereço da conta deve ser um domínio como company.amocrm.ru, não um endereço de e-mail" | Digite o domínio mostrado na barra de endereços do seu navegador quando o amoCRM estiver aberto |
| "O amoCRM rejeitou o token" | O token foi copiado incorretamente, expirou ou foi revogado. Gere um novo |
| "A assinatura do amoCRM expirou" | Os dados ainda podem estar acessíveis por 30 dias após a expiração. Renove sua assinatura ou entre em contato com o amoCRM |
| "O amoCRM bloqueou o acesso" | A integração pode estar sem a permissão "Acesso aos Dados da Conta", ou a conta pode estar temporariamente bloqueada devido a solicitações excessivas. Verifique o acesso e tente novamente mais tarde |
| "O amoCRM não está respondendo" ou "O amoCRM não conseguiu encontrar..." | Verifique o endereço da conta e tente novamente |
Etapas do Assistente de Migração
Após conectar seu CRM, o processo de migração é o mesmo para Bitrix24 e amoCRM.
Nenhum dado é gravado no Mavibot até você chegar à etapa "Migrar".
1. Coleta de Dados
O assistente recupera dados do seu CRM anterior e mostra qual seção está sendo processada no momento.
Você pode fechar a página enquanto a coleta de dados continua em segundo plano.
2. "Dados Encontrados"
O assistente exibe o número de pipelines, negócios, contatos, empresas, tarefas, chamadas e funcionários encontrados.
A seção "Itens para Revisar" mostra quais dados não podem ser migrados e por quê, como permissões de webhook ausentes.
3. Mapeamento
Configure como os dados do seu CRM anterior devem ser mapeados para o Mavibot.
Pipelines e Etapas
Para cada pipeline de origem, selecione um pipeline existente no Mavibot ou escolha "Criar Novo Pipeline".
Etapas com nomes correspondentes são mapeadas automaticamente. Etapas ausentes são criadas na mesma ordem do seu CRM anterior.
Funcionários
Funcionários com endereços de e-mail correspondentes são mapeados automaticamente e marcados como "Correspondidos por E-mail".
Para todos os outros, selecione o funcionário apropriado ou deixe como "Não Designado".
Campos para Variáveis
Selecione os campos personalizados que deseja migrar e revise suas chaves de variável.
Você pode usar imediatamente essas chaves de variável em bots e campanhas.
O Que Migrar
Configure as seguintes opções:
- Incluir negócios fechados.
- Importar apenas dados criados após uma data especificada.
- Para Bitrix24, opcionalmente incluir leads não convertidos, conversas de Canais Abertos e arquivos de conversas.
Quando um filtro de data é selecionado, todos os clientes e empresas são importados, enquanto negócios, tarefas, comentários, chamadas e conversas são importados apenas a partir da data especificada.
Clique em "Salvar Mapeamento" quando terminar.
4. "Revisão"
O assistente calcula o que acontecerá durante a migração sem gravar nenhum dado.
Para cada categoria de dados, ele exibe:
- Será Criado — registros que serão adicionados.
- Já Existe — registros já encontrados no Mavibot.
- Ignorado — registros que não podem ser importados.
Para clientes, "Já Existe" significa que um número de telefone ou endereço de e-mail correspondente foi encontrado no Mavibot.
Você pode ajustar o mapeamento e executar a revisão novamente.
5. "Migrar"
A migração é executada em segundo plano, então você pode fechar a página.
O botão Parar interrompe o processo.
Registros já importados permanecem no Mavibot, e executar a migração novamente continua sem criar duplicatas.
6. Resultados da Migração
A tela final exibe uma tabela com:
- Criados
- Já Existem
- Ignorados
Também inclui uma lista de registros ignorados com explicações.
Para baixar o relatório completo, clique em "Baixar Relatório CSV".
Para visualizar os registros importados, clique em "Abrir CRM".
Importando Novos Dados Mais Tarde
Se sua equipe continuar trabalhando no CRM anterior, você pode usar "Migrar Novos Dados" para importar alterações recentes.
Novos registros serão adicionados, enquanto negócios importados anteriormente terão suas etapas, valores e funcionários designados atualizados.
O botão "Descobrir Novamente" apenas atualiza os dados coletados, por exemplo, após adicionar novas permissões a um webhook.
O Que Não Pode Ser Migrado
Qualquer dado que não possa ser importado aparece no relatório de migração junto com o motivo.
As seguintes limitações são conhecidas antecipadamente:
- Conversas do amoCRM. O amoCRM não fornece histórico de conversas através de sua API. Notas, mensagens SMS e chamadas ainda podem ser importadas.
- Arquivos do amoCRM. Notas contendo arquivos são importadas com o nome do arquivo, mas os arquivos reais permanecem no amoCRM. Campos personalizados do tipo "Arquivo" não podem ser importados de nenhum dos CRMs.
- Campos personalizados de empresas. O Mavibot armazena apenas o nome da empresa e os detalhes da empresa.
- Histórico do sistema do amoCRM. Alterações de etapas e mensagens enviadas por robôs de automação não são importadas.
- Leads convertidos do Bitrix24. O lead original é ignorado, mas o negócio e o contato criados a partir desse lead são importados.
- Registros sem um relacionamento válido. Por exemplo, um negócio pertencente a um pipeline excluído ou uma tarefa vinculada a um negócio excluído. Negócios sem contatos não são perdidos: eles são vinculados a um perfil de empresa ou a um perfil "Sem Contato".
- Gravações de chamadas. Apenas links para gravações no CRM anterior são importados. Esses links podem parar de funcionar após o portal ou conta antigo ser desconectado.
Números de Telefone e Endereços de E-mail
O primeiro número de telefone e o primeiro endereço de e-mail são adicionados aos campos principais do perfil do cliente.
Números de telefone adicionais, números completos com ramais e valores que não correspondem aos formatos padrão de telefone ou e-mail são salvos nas variáveis "Números de Telefone" e "Endereços de E-mail".
Após a Migração
Os negócios importados aparecem nos pipelines do seu Mavibot CRM.
O histórico de atividades do cliente é exibido nas conversas do cliente, incluindo notas, chamadas e mensagens importadas com suas datas originais.
As variáveis do perfil do cliente contêm o "ID Bitrix24" ou "ID amoCRM", bem como informações adicionais, como:
- Origem
- Moeda
- Data de fechamento
- Motivo da perda do negócio
- Etiquetas
Na parte inferior do assistente de migração, você encontrará uma lista "Migrações".
Ela exibe o status de cada migração e o número de clientes e negócios importados para o Mavibot.
Desconecte Seu CRM Anterior
Após a conclusão da migração, revogue o acesso ao seu CRM anterior.
Bitrix24
Exclua o webhook em Desenvolvedores → Integrações.
amoCRM
Vá para amoMarket → Sua Integração → Revogar Acesso.
Mavibot
Você pode clicar em "Excluir Migração" para remover o URL do webhook ou token e os dados de migração coletados.
Os clientes e negócios importados permanecerão no Mavibot.
Perguntas Frequentes
Posso executar a migração novamente?
Sim. Use o botão "Migrar Novos Dados".
Nenhum registro duplicado será criado. Os registros importados anteriormente serão atualizados e novos registros serão adicionados.
Um cliente já entrou em contato conosco por um mensageiro. Um perfil duplicado será criado?
Não.
O Mavibot encontra automaticamente clientes existentes com números de telefone ou endereços de e-mail correspondentes.
Seus perfis existentes são atualizados e os negócios importados são vinculados a esses perfis.
Por que alguns negócios estão sem funcionários designados?
O funcionário pode não ter sido mapeado, ou o webhook do Bitrix24 pode não ter a permissão Usuários.
Adicione o funcionário ao seu projeto Mavibot, selecione-o nas configurações de mapeamento e clique em "Migrar Novos Dados".
O funcionário designado será atualizado.
Onde posso ver quais registros não foram importados?
Abra os resultados da migração e revise a lista de registros ignorados.
Você também pode baixar o relatório CSV.
Cada registro ignorado inclui uma explicação.
Os robôs e campanhas do CRM serão executados para negócios importados?
Não.
A migração é executada silenciosamente. Automações, bots e campanhas do CRM não são acionados, e os clientes não recebem nenhuma mensagem.
E se eu migrei dados para o projeto errado? Posso desfazer?
Não há reversão automática.
Os clientes e negócios importados permanecem no Mavibot mesmo após clicar em "Excluir Migração".
Antes de começar, certifique-se de ter selecionado o projeto correto e revise cuidadosamente os resultados na etapa "Revisão".