Qué se migra y a dónde
La herramienta de migración importa clientes, negocios e historial de actividades desde Bitrix24 o amoCRM a Mavibot CRM.
Para acceder a ella, ve a CRM → Configuración del pipeline (icono de engranaje) → "Migración de CRM" → "Abrir".
Si tu proyecto aún no tiene pipelines, verás un enlace "Migra tus datos" en la pantalla vacía del CRM.
| Datos | Bitrix24 | amoCRM | Destino en Mavibot |
|---|---|---|---|
| Clientes | Contactos | Contactos | Clientes del CRM |
| Empresas | Incluyendo detalles de la empresa e información bancaria | Incluyendo detalles del campo "Entidad legal" | Empresas de clientes |
| Negocios | Todos los pipelines | Todos los pipelines | Negocios en los pipelines seleccionados |
| Negocios cerrados | Opcional | Opcional | Estados "Ganado" y "Perdido" |
| Prospectos | Opcional, importados en un pipeline separado | amoCRM no tiene prospectos separados | Pipeline "Prospectos (Bitrix24)" |
| Tareas | Actividades y tareas | Tareas | Tareas del CRM |
| Comentarios | Comentarios de la línea de tiempo | Notas y SMS | Notas en las conversaciones de los clientes |
| Llamadas | Incluyendo enlaces de grabación | Incluyendo enlaces de grabación | Registros de llamadas en las conversaciones de los clientes |
| Conversaciones | Canales abiertos, opcionalmente incluyendo archivos | No disponible: amoCRM no proporciona conversaciones a través de su API | Conversaciones de clientes |
| Campos personalizados | Campos de contacto, negocio y prospecto | Campos de contacto y negocio | Variables de cliente y negocio |
| Empleados asignados | Mediante mapeo de empleados | Mediante mapeo de empleados | Miembros del equipo del proyecto |
| Etiquetas | Tipo de contacto y fuente | Etiquetas | Etiquetas de clientes |
Antes de comenzar
Solo los empleados con permiso para editar datos del CRM en Mavibot pueden iniciar una migración.
En tu CRM anterior, las credenciales de acceso deben ser creadas por un administrador. La herramienta de migración solo puede acceder a los datos que la persona que creó las credenciales está autorizada a ver.
- Tu CRM anterior permanece sin cambios. La herramienta de migración solo lee datos. Puedes seguir trabajando en Bitrix24 o amoCRM como de costumbre.
- Sin clientes duplicados. Si ya existe un cliente con el mismo número de teléfono o dirección de correo electrónico en Mavibot (por ejemplo, alguien que te contactó previamente por WhatsApp), su perfil existente se actualizará. Solo se completan los campos vacíos; los valores existentes permanecen sin cambios.
- No se envían mensajes a los clientes. Las automatizaciones, bots y campañas del CRM no se activan durante la migración. Los clientes importados no se mueven a la parte superior de la lista de conversaciones.
- Puedes ejecutar la migración nuevamente de forma segura. Los registros importados previamente se actualizan o se omiten, y solo se agregan datos nuevos.
Antes de comenzar, debes marcar la casilla de confirmación:
"Los datos pertenecen a nuestra empresa y autorizamos a Mavibot a migrarlos."
La migración no puede comenzar sin esta confirmación.
Migrar desde Bitrix24
Para conectar Bitrix24, necesitas un webhook entrante. Crear uno toma aproximadamente dos minutos.
Crea el webhook con una cuenta de administrador de Bitrix24 para que la migración pueda acceder a todos los negocios y conversaciones.
- En Bitrix24, ve a Desarrolladores → Otro → Webhook entrante.
- Selecciona los permisos enumerados en la tabla a continuación. Solo CRM es estrictamente necesario, pero sin los otros permisos, algunos datos no se importarán.
- Haz clic en Guardar y copia la URL del campo "Webhook para llamar a la API REST". Se ve así:
https://tu-portal.bitrix24.ru/rest/1/xxxxxxxxxxxx/. - En Mavibot, abre Migración de CRM, selecciona la pestaña Bitrix24 y pega la URL en el campo "URL del webhook entrante".
- Confirma que eres dueño de los datos y haz clic en "Verificar acceso y descubrir datos". Luego sigue los pasos del asistente de migración descritos a continuación.
| Permiso del webhook | Qué proporciona | Sin él |
|---|---|---|
| CRM | Clientes, empresas, negocios, prospectos, actividades, comentarios | La migración no puede comenzar |
| Usuarios (Básico) | Lista de empleados para mapeo | Los negocios no tendrán empleados asignados |
| Canales abiertos | Conversaciones de clientes | Las conversaciones no se importarán |
| Tareas | Tareas del módulo de Tareas | Solo se importarán actividades del CRM |
| Telefonía | Duración de llamadas y enlaces de grabación | Las llamadas no tendrán duración ni enlaces de grabación |
| Drive | Archivos de conversaciones | Algunos archivos permanecerán como enlaces en los mensajes |
Si falta algún permiso, el asistente mostrará una advertencia durante el paso "Datos encontrados".
Agrega el permiso requerido en la configuración del webhook de Bitrix24 y haz clic en "Descubrir de nuevo".
Bitrix24 permite no más de dos solicitudes por segundo, por lo que recopilar datos de un portal grande puede llevar más tiempo.
Puedes cerrar la página mientras la migración se ejecuta en segundo plano.
Errores de conexión
| Mensaje de error | Qué hacer |
|---|---|
| "Esta no es una URL de webhook" | Ingresaste una dirección de portal o correo electrónico. Copia la URL del campo "Webhook para llamar a la API REST" |
| "La URL del webhook debe comenzar con https://" | Copia la URL completa, incluyendo https://
|
| "Bitrix24 rechazó el webhook" | El webhook fue eliminado o la URL se copió incorrectamente. Crea un nuevo webhook |
| "El webhook no tiene permiso de CRM" | Habilita el permiso de CRM en la configuración del webhook |
| "Bitrix24 no responde" | Verifica la dirección del portal en la URL del webhook e inténtalo de nuevo |
| "Bitrix24 no ha levantado el límite de tasa de solicitudes" | El portal puede estar ocupado con otras integraciones. Inténtalo de nuevo más tarde |
Si la sección Desarrolladores falta en tu menú de Bitrix24 o no puedes guardar un webhook, verifica tu plan de suscripción de Bitrix24.
Los webhooks pueden no estar disponibles en el plan gratuito de Bitrix24.
Migrar desde amoCRM
Para conectar amoCRM, necesitas la dirección de tu cuenta y un token de larga duración de una integración externa.
Solo un administrador de la cuenta puede generar el token.
Al crear la integración, amoCRM envía un código de verificación al correo electrónico del administrador, así que asegúrate de tener acceso a esa bandeja de entrada.
- En amoCRM, abre amoMarket → ⋯ (esquina superior derecha) → Crear integración → Integración externa → Crear.
- Completa el formulario:
- URL de redirección — cualquier dirección HTTPS, como tu sitio web. No se usa para el token.
- Otorgar acceso — selecciona "Acceso a los datos de la cuenta". No se requieren otros permisos.
- Nombre y descripción — por ejemplo, "Migración a Mavibot".
- Logotipo — cualquier imagen de 400×272. Sin un logotipo, amoCRM puede no guardar la integración.
- Haz clic en Guardar. amoCRM te pedirá que confirmes la integración. Haz clic en Enviar código, ingresa el código de seis dígitos del correo electrónico y haz clic en Confirmar.
- Abre la integración creada y ve a Claves y acceso → Generar token de larga duración. Selecciona un período de vencimiento. Un mes suele ser suficiente para la migración.
- Copia el token inmediatamente. amoCRM lo muestra solo una vez.
- En Mavibot, abre Migración de CRM y selecciona la pestaña amoCRM. Ingresa
company.amocrm.ruo simplementecompanyen el campo "Dirección de la cuenta". La direccióncompany.amocrm.comtambién es compatible. Pega tu token en el campo "Token de larga duración". - Confirma que eres dueño de los datos y haz clic en "Verificar acceso y descubrir datos". Luego sigue los pasos del asistente descritos a continuación.
La dirección de la cuenta y el token se almacenan en forma cifrada y se eliminan cuando se elimina el registro de migración.
amoCRM no proporciona acceso a conversaciones a través de su API. El asistente de migración muestra una advertencia sobre esto antes de que comience la migración.
Errores de conexión
| Mensaje de error | Qué hacer |
|---|---|
| Código de verificación no recibido | El código se envía al correo electrónico asociado con tu cuenta de amoCRM. Revisa tu carpeta de Spam o crea la integración con otra cuenta de administrador |
| "La dirección de la cuenta debe ser un dominio como company.amocrm.ru, no una dirección de correo electrónico" | Ingresa el dominio que se muestra en la barra de direcciones de tu navegador cuando amoCRM está abierto |
| "amoCRM rechazó el token" | El token se copió incorrectamente, ha expirado o fue revocado. Genera uno nuevo |
| "La suscripción de amoCRM ha expirado" | Los datos pueden seguir siendo accesibles durante 30 días después de la expiración. Renueva tu suscripción o contacta a amoCRM |
| "amoCRM ha bloqueado el acceso" | La integración puede carecer del permiso "Acceso a los datos de la cuenta", o la cuenta puede estar temporalmente bloqueada debido a solicitudes excesivas. Verifica el acceso e inténtalo de nuevo más tarde |
| "amoCRM no responde" o "amoCRM no pudo encontrar…" | Verifica la dirección de la cuenta e inténtalo de nuevo |
Pasos del asistente de migración
Después de conectar tu CRM, el proceso de migración es el mismo para Bitrix24 y amoCRM.
No se escribe ningún dato en Mavibot hasta que llegues al paso "Migrar".
1. Recopilación de datos
El asistente recupera datos de tu CRM anterior y muestra qué sección se está procesando actualmente.
Puedes cerrar la página mientras la recopilación de datos continúa en segundo plano.
2. "Datos encontrados"
El asistente muestra el número de pipelines, negocios, contactos, empresas, tareas, llamadas y empleados encontrados.
La sección "Cosas para revisar" muestra qué datos no se pueden migrar y por qué, como permisos de webhook faltantes.
3. Mapeo
Configura cómo se deben mapear los datos de tu CRM anterior a Mavibot.
Pipelines y etapas
Para cada pipeline de origen, selecciona un pipeline existente de Mavibot o elige "Crear nuevo pipeline".
Las etapas con nombres coincidentes se mapean automáticamente. Las etapas faltantes se crean en el mismo orden que en tu CRM anterior.
Empleados
Los empleados con direcciones de correo electrónico coincidentes se mapean automáticamente y se marcan como "Coincididos por correo electrónico".
Para todos los demás, selecciona el empleado apropiado o deja "Sin asignar".
Campos a variables
Selecciona los campos personalizados que deseas migrar y revisa sus claves de variable.
Puedes usar estas claves de variable inmediatamente en bots y campañas.
Qué migrar
Configura las siguientes opciones:
- Incluir negocios cerrados.
- Importar solo datos creados después de una fecha específica.
- Para Bitrix24, opcionalmente incluir prospectos no convertidos, conversaciones de Canales abiertos y archivos de conversaciones.
Cuando se selecciona un filtro de fecha, todos los clientes y empresas se importan, mientras que los negocios, tareas, comentarios, llamadas y conversaciones se importan solo desde la fecha especificada en adelante.
Haz clic en "Guardar mapeo" cuando termines.
4. "Revisar"
El asistente calcula lo que sucederá durante la migración sin escribir ningún dato.
Para cada categoría de datos, muestra:
- Se creará — registros que se agregarán.
- Ya existe — registros ya encontrados en Mavibot.
- Omitidos — registros que no se pueden importar.
Para los clientes, "Ya existe" significa que se encontró un número de teléfono o dirección de correo electrónico coincidente en Mavibot.
Puedes ajustar el mapeo y ejecutar la revisión nuevamente.
5. "Migrar"
La migración se ejecuta en segundo plano, por lo que puedes cerrar la página.
El botón Detener interrumpe el proceso.
Los registros ya importados permanecen en Mavibot, y ejecutar la migración nuevamente continúa sin crear duplicados.
6. Resultados de la migración
La pantalla final muestra una tabla con:
- Creados
- Ya existen
- Omitidos
También incluye una lista de registros omitidos con explicaciones.
Para descargar el informe completo, haz clic en "Descargar informe CSV".
Para ver los registros importados, haz clic en "Abrir CRM".
Importar nuevos datos más tarde
Si tu equipo continúa trabajando en el CRM anterior, puedes usar "Migrar nuevos datos" para importar cambios recientes.
Se agregarán nuevos registros, mientras que los negocios importados previamente tendrán sus etapas, montos y empleados asignados actualizados.
El botón "Descubrir de nuevo" solo actualiza los datos recopilados, por ejemplo, después de agregar nuevos permisos a un webhook.
Qué no se puede migrar
Cualquier dato que no se pueda importar aparece en el informe de migración junto con la razón.
Las siguientes limitaciones se conocen de antemano:
- Conversaciones de amoCRM. amoCRM no proporciona historial de conversaciones a través de su API. Las notas, mensajes SMS y llamadas aún se pueden importar.
- Archivos de amoCRM. Las notas que contienen archivos se importan con el nombre del archivo, pero los archivos reales permanecen en amoCRM. Los campos personalizados de tipo "Archivo" no se pueden importar desde ninguno de los dos CRM.
- Campos personalizados de empresas. Mavibot solo almacena el nombre de la empresa y los detalles de la empresa.
- Historial del sistema de amoCRM. Los cambios de etapa y los mensajes enviados por robots de automatización no se importan.
- Prospectos convertidos de Bitrix24. El prospecto original se omite, pero el negocio y el contacto creados a partir de ese prospecto se importan.
- Registros sin una relación válida. Por ejemplo, un negocio que pertenece a un pipeline eliminado o una tarea vinculada a un negocio eliminado. Los negocios sin contactos no se pierden: se vinculan a un perfil de empresa o a un perfil "Sin contacto".
- Grabaciones de llamadas. Solo se importan enlaces a grabaciones en el CRM anterior. Estos enlaces pueden dejar de funcionar después de que se desconecte el portal o la cuenta anterior.
Números de teléfono y direcciones de correo electrónico
El primer número de teléfono y la primera dirección de correo electrónico se añaden a los campos principales del perfil del cliente.
Los números de teléfono adicionales, los números completos con extensiones y los valores que no coinciden con los formatos estándar de teléfono o correo electrónico se guardan en las variables "Números de teléfono" y "Direcciones de correo electrónico".
Después de la migración
Los acuerdos importados aparecen en los pipelines de su Mavibot CRM.
El historial de actividad del cliente se muestra en las conversaciones del cliente, incluyendo notas, llamadas y mensajes importados con sus fechas originales.
Las variables del perfil del cliente contienen el "ID de Bitrix24" o "ID de amoCRM", así como información adicional como:
- Fuente
- Moneda
- Fecha de cierre
- Motivo de pérdida del acuerdo
- Etiquetas
En la parte inferior del asistente de migración, encontrará una lista "Migraciones".
Muestra el estado de cada migración y el número de clientes y acuerdos importados en Mavibot.
Desconecte su CRM anterior
Una vez completada la migración, revoque el acceso a su CRM anterior.
Bitrix24
Elimine el webhook en Desarrolladores → Integraciones.
amoCRM
Vaya a amoMarket → Su integración → Revocar acceso.
Mavibot
Puede hacer clic en "Eliminar migración" para eliminar la URL del webhook o el token y los datos de migración recopilados.
Los clientes y acuerdos importados permanecerán en Mavibot.
Preguntas frecuentes
¿Puedo volver a ejecutar la migración?
Sí. Use el botón "Migrar nuevos datos".
No se crearán registros duplicados. Los registros importados previamente se actualizarán y se añadirán nuevos registros.
Un cliente ya nos contactó a través de un mensajero. ¿Se creará un perfil duplicado?
No.
Mavibot encuentra automáticamente clientes existentes con números de teléfono o direcciones de correo electrónico coincidentes.
Sus perfiles existentes se actualizan y los acuerdos importados se vinculan a esos perfiles.
¿Por qué faltan empleados asignados en algunos acuerdos?
El empleado puede no haber sido mapeado, o el webhook de Bitrix24 puede no tener el permiso Usuarios.
Añada al empleado a su proyecto de Mavibot, selecciónelo en la configuración de mapeo y haga clic en "Migrar nuevos datos".
El empleado asignado se actualizará.
¿Dónde puedo ver qué registros no se importaron?
Abra los resultados de la migración y revise la lista de registros omitidos.
También puede descargar el informe CSV.
Cada registro omitido incluye una explicación.
¿Se ejecutarán robots y campañas de CRM para los acuerdos importados?
No.
La migración se ejecuta silenciosamente. Las automatizaciones, bots y campañas de CRM no se activan, y los clientes no reciben ningún mensaje.
¿Qué pasa si migré datos al proyecto equivocado? ¿Puedo deshacerlo?
No hay una reversión automática.
Los clientes y acuerdos importados permanecen en Mavibot incluso después de hacer clic en "Eliminar migración".
Antes de comenzar, asegúrese de haber seleccionado el proyecto correcto y revise cuidadosamente los resultados en el paso "Revisión".