> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de migración de CRM independiente

> Nueva guía de migración de CRM para pasar del despliegue independiente del plugin-crm al componente CRM integrado en Midaz v3.5.0 y Helm Chart v5.x.

<Badge stroke icon="calendar-days" iconType="regular">9 de marzo de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Actualización de documentación</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisión recomendada</Badge>

## Afecta

***

Equipos que migran desde el despliegue independiente del plugin CRM al componente CRM embebido en Midaz.

Esta actualización aplica al portal público de documentación. No cambia el comportamiento de la API en tiempo de ejecución a menos que la documentación del producto enlazada indique lo contrario.

## Qué cambió

***

Se publicó una nueva [guía de migración](/es/midaz/crm/crm-migration-guide) para ayudar a los equipos a hacer la transición del despliegue independiente `plugin-crm` al componente CRM integrado en Midaz.

A partir de **Midaz v3.5.0** y **Helm Chart v5.x**, CRM ya no se despliega como un plugin separado. Ahora está embebido directamente en el monorepo de Midaz y en el chart de Helm.

### Qué cubre la guía

***

### Comparación de arquitectura

Una comparación lado a lado de la arquitectura de plugin independiente (repositorio separado, ciclo de release independiente, chart de Helm dedicado en el namespace `midaz-plugins`) frente al componente integrado (monorepo en `components/crm/`, chart de Helm único, namespace compartido).

### Migración paso a paso

La guía recorre el proceso completo de migración:

1. **Evaluación previa a la migración**: verifica la versión actual del plugin y el estado de los datos
2. **Mapeo de configuración**: cómo se traducen los valores de Helm independientes al chart integrado
3. **Continuidad de datos**: asegurar que los datos existentes de CRM se transfieran sin pérdidas
4. **Procedimiento de cutover**: pasos para cambiar del despliegue independiente al integrado
5. **Validación**: confirmar que la migración se completó con éxito

### Procedimiento de rollback

Si surgen problemas durante la migración, la guía incluye un procedimiento de rollback para restaurar el despliegue independiente.

### Solución de problemas

Problemas comunes de migración y sus resoluciones, incluidos conflictos de namespace, desajustes de configuración y problemas de acceso a datos.

<Info>
  Los nuevos despliegues de Midaz (v5.x+) no necesitan esta guía. CRM se habilita directamente en los valores de Helm como se describe en la [guía de instalación de Midaz](/es/platform/helm/midaz/midaz-installation).
</Info>

### Actualización de navegación

***

CRM ahora aparece como un módulo nativo de Midaz en la navegación de la documentación, en lugar de bajo la sección de plugins. La página de resumen de CRM se actualizó para reflejar su estado integrado.

Esta guía está disponible en inglés, portugués y español.

## Impacto

***

Esta es una actualización de documentación. Las integraciones existentes no requieren migración a partir de esta nota de versión.

## Qué necesitas hacer

***

<Steps>
  <Step>
    Revisa la guía de migración de CRM antes de planificar cambios en el despliegue de CRM.
  </Step>
</Steps>

### Plazo

Ninguno.

### Por qué

La guía documenta cómo pasar de CRM independiente al componente CRM nativo de Midaz actual.