Búsqueda

Tu transición del antiguo complemento de Shopware 6 al nuevo

Con la nueva versión de nuestro plugin para Shopware 6, te ofrecemos un rendimiento aún mejor y funciones mejoradas. El proceso de migración está parcialmente automatizado a través de un modal y solo te llevará unos minutos.
En esta guía, te explicaremos paso a paso cómo pasar de tu integración actual al nuevo plugin.

Nota importante: 
La conexión antigua se desconectará automáticamente en cuanto hagas clic en la ventana modal de migración opción de transferencia automática a Aplicar configuración . Si eliges la configuración manual Configurar manualmente , no se producirá la desactivación automática.

Limitaciones de la versión actual

  • Modificar los datos de sincronización: ¿ quieres ajustar más adelante la configuración, como los datos de los destinatarios o la asignación de campos de datos? Desconecta tu cuenta de CleverReach desde la página de configuración del plugin y repite el proceso de configuración.

  • Creación de segmentos: La creación automática de segmentos no está disponible actualmente

  • Importación de la lista de bloqueados: La opción de excluir a ciertos clientes de la transferencia tampoco está implementada todavía.

  • Modo sin conexión: La detección automática cuando se ha eliminado el grupo vinculado en CleverReach aún no se ha integrado. Por eso, por favor, no elimines manualmente la lista de destinatarios vinculada en CleverReach.

Ya tenemos otros requisitos y peticiones en nuestra lista interna. Si quieres alguna función específica o nueva, no dudes en usar la encuesta de opiniones directamente en el plugin.

Las diferencias más importantes de un vistazo

Sección Novedades de la interfaz actualizada
Rendimiento y arquitectura Rediseñado por completo para ofrecer un mejor rendimiento y una sincronización más estable
Historial de pedidos Datos de los últimos 12 meses (por defecto), ajustables hasta 24 meses
Formularios Uso del nuevo módulo de formularios de CleverReach. Los formularios antiguos ya no son compatibles.
Idiomas Interfaz del plugin disponible en alemán, inglés y neerlandés
Permisos y modelo de roles Asignación detallada de permisos a través de la gestión de permisos de Shopware (mira la sección de abajo)
.htaccess mecanismo de validación El plugin detecta automáticamente si hay protección con contraseña activada y muestra los siguientes pasos necesarios

Requisitos previos y preparación

Para que la migración y la sincronización posterior vayan bien, asegúrate de tener en cuenta lo siguiente de antemano:

Versión de Shopware: La nueva integración con Shopware 6 está disponible a partir de la versión 6.6 (las versiones 6.6 y 6.7 son compatibles)

Versión de PHP: Tu servidor necesita PHP 8.2 o superior.

Conexión existente: El antiguo plugin de CleverReach está instalado, activo y correctamente conectado a tu cuenta de CleverReach.

Protección con contraseña (.htaccess / Autenticación básica):

Si tu tienda (por ejemplo, un entorno de prueba o de desarrollo) está protegida con contraseña, CleverReach debe autorizar los puntos finales de la API. Para ello, añade las siguientes dos rutas de API desde el .htaccess autenticación (lista blanca):

/api/crsw-on-prem-CleverReach/webhook/receiver
/api/crsw-on-prem-CleverReach/webhook/abandonedCart

(Si no lo añades a la lista blanca, la importación fallará y la sincronización se quedará colgada).

Paso 1: Instala el nuevo plugin

  1. Inicia sesión en tu cuenta de Shopware y ve a Extensiones > Tienda.
  2. Busca el nuevo plugin de CleverReach y haz clic en Instalar extensión.

Paso 2: Abre la ventana modal de migración e inicia la transferencia de datos

  1. Haz clic en la opción de menú Mis extensiones. Aquí ya aparecen tanto el plugin antiguo como el nuevo de CleverReach. Activa el nuevo plugin con el control deslizante. 

  2. En el menú, haz clic en Marketing y selecciona el nuevo plugin de CleverReach .

  3. En cuanto abras el nuevo complemento por primera vez, el sistema detecta automáticamente la conexión existente. Aparece una ventana (modal) con dos opciones:

    Importación automática (recomendada): El complemento importa la lista de destinatarios ya vinculada directamente desde el complemento anterior.

    Nota técnica importante: Además, durante este paso, la conexión entre el antiguo plugin y CleverReach se desconecta automáticamente, y el plugin se desactiva automáticamente en las extensiones de Shopware. Se trata de un mecanismo de seguridad diseñado para:

    • Evitar sincronizaciones duplicadas.

    • Mantener el rendimiento de tu tienda.

    • En el siguiente paso, podrás conectar nuestra nueva app a tu cuenta de CleverReach .

    Conexión manual: Selecciona esta opción si quieres conectarte a otra cuenta de CleverReach . Nota: La aplicación antigua no se desactivará. Ten en cuenta que esto puede provocar inconsistencias en los datos.

  4. En el siguiente paso, selecciona qué listas de destinatarios quieres importar y haz clic en Siguiente.

Paso 3: Configurar los ajustes de importación

En este paso, hay un montón de opciones de configuración para la importación. 

  • Qué grupos de clientes importar (suscriptores del boletín, clientes que han realizado una compra, otros contactos)
  • Si quieres transferir el historial de pedidos (por defecto: los últimos 12 meses, ajustable a hasta 24 meses)
  • Si se debe realizar una importación de etiquetas 
  • Si se deben asignar los campos de datos. 

Por último, haz clic en Iniciar importación.

Nota: La importación se ejecuta en segundo plano. Puedes cambiar de pestaña o seguir trabajando en otros menús. Mantén abierta la pestaña del navegador hasta que el proceso haya finalizado.

Paso 4: Finalización y comprobación del funcionamiento

Una vez finalizada la migración, recibirás una confirmación en la ventana modal. Tu nuevo panel de control ya está listo y podrás volver a aprovechar al máximo tu integración con CleverReach. 

Nota: El antiguo plugin se ha desactivado automáticamente. Ahora puedes desinstalar y eliminar con total seguridad la versión antigua del plugin de tu backend de Shopware.

¿Qué sigue igual y qué cambia?

Uso de etiquetas
El formato de las etiquetas coincide exactamente con el de la interfaz anterior. Por lo tanto, tus segmentos y automatizaciones existentes seguirán funcionando a la perfección y no necesitarán ningún ajuste.

Uso de formularios
La nueva integración utiliza nuestro módulo de formularios actual. Los formularios antiguos ya no son compatibles. Crea el formulario que quieras directamente en CleverReach para poder integrarlo después a través de la interfaz.

Creación de segmentos
De momento no está previsto crear nuevos segmentos directamente a través de la integración. Sin embargo, puedes seguir usando tus segmentos actuales sin restricciones: Como el formato de las etiquetas no cambia, todas las segmentaciones y los filtros por campos de datos funcionarán como siempre.

Uso de automatizaciones
¿Ya has configurado automatizaciones basadas en etiquetas? Estas seguirán ejecutándose sin ninguna intervención manual. Simplemente te recomendamos que compruebes rápidamente que todos los desencadenantes se activan como estaba previsto.

Modelo de permisos y roles

Con la gestión de permisos de Shopware, puedes asignar diferentes roles de acceso al plugin de CleverReach:

Rol Puede No puede
Admin Acceso completo a todas las funciones -
Visor Ver el panel de control y los datos (informes, registros, estado); acceder al módulo a través del menú Cambiar la configuración; activar acciones (resincronizar, importar); conectar/desconectar la cuenta; borrar la configuración
Editor Cambiar la configuración (DOI, carrito abandonado, formularios), activar la resincronización o la actualización del panel de control Desconectar la cuenta, borrar la configuración, eliminar la integración
Borrar Ver módulo, desconectar la integración Cambiar la configuración, activar la sincronización o acciones, conectar la cuenta
  • Problema/Tema Causa/Solución
    La importación de CleverReach se queda atascada cuando está activada la protección con contraseña (.htaccess)

    Causa: En entornos protegidos con contraseña (autenticación básica / entorno de prueba), la importación se queda atascada en un bucle infinito (Icono girando sin parar), porque los procesos en segundo plano están bloqueados (401 error).

    Solución: Desactiva temporalmente la protección con contraseña para la importación, o habilita las siguientes rutas de API en la configuración de tu servidor:

    • /api/crsw-on-prem-CleverReach/webhook/receiver

    •   /api/crsw-on-prem-CleverReach/webhook/abandonedCart

    La sincronización no se inicia

    Comprueba: 

    1. ¿Están en marcha los trabajadores de la cola de mensajes o los trabajadores de administración?

    2. ¿Es válida la autenticación de CleverReach?

    3. ¿Hay errores en los archivos de registro del plugin?
    La sincronización se interrumpe antes de completarse

    Comprueba:

    1. La cola de mensajes.

    2. Los archivos de registro del plugin.

    3. La validez de la conexión OAuth.
    Problemas con sincronizaciones grandes (50 000 entradas o más)

    Causa: El valor por defecto del tiempo de espera de la consulta es de 3600 segundos (1 hora). Si el proceso tarda más, un trabajador volverá a recuperar el mensaje.

    Solución: Establece el tiempo de espera del transporte del DSN redeliver_timeout en un valor más alto (recomendado: 8 horas):

    • MESSENGER_TRANSPORT_DSN=doctrine://default?auto_setup=0&redeliver_timeout=28800
    No se están enviando los correos sobre carritos de la compra abandonados . 

    Comprueba lo siguiente:

    1. ¿Está activada la automatización de CleverReach para «Carritos abandonados » está activada?

    2. ¿Están funcionando los trabajadores de las tareas programadas (Tareas programadas) ?

    3. ¿Muestran los registros algún error de webhook o de automatización?
    Los correos sobre carritos de la compra abandonados se envían con un pequeño retraso Explicación: El plugin realiza una comprobación programada cada 15 minutos (Ejecución programada) para detectar nuevos carritos de la compra abandonados. Dependiendo del intervalo de tiempo, el envío puede retrasarse ligeramente .
    El grupo vinculado no debe eliminarse en CleverReach

    Explicación: El «modo sin conexión» para detectar automáticamente los grupos eliminados aún no está integrado.

    Solución: No elimines manualmente la lista de destinatarios vinculada en CleverReach.
    Los formularios antiguos ya no funcionan tras cambiar de plugin Solución: Al cambiar al nuevo plugin, los formularios que antes estaban integrados en los Shopware Experience Worlds deben sustituirse manualmente por los nuevos formularios.
    Sincronización bidireccional de los formularios de CleverReach Flow a Shopware Solución: Para garantizar la sincronización en ambas direcciones, el Flow Form de CleverReach debe configurarse con la misma lista de destinatarios que el plugin.
  • Pregunta Respuesta
    ¿Puedo cambiar fácilmente de la interfaz antigua a la nueva sin perder ningún dato? Sí. La migración está parcialmente automatizada a través de una ventana modal y solo tarda unos minutos. Tu lista de destinatarios actual se transferirá automáticamente. Durante este proceso, el antiguo plugin de CleverReach también se desactivará automáticamente. Tras seleccionar la lista de destinatarios, puedes configurar individualmente datos adicionales para la importación.
    ¿Tengo que desinstalar primero el plugin antiguo? No. Deja el plugin antiguo activo por ahora. En cuanto el primer paso (ventana modal de migración) del nuevo plugin se haya completado con éxito, la conexión antigua se desconectará automáticamente y el plugin antiguo se desactivará. Una vez que hayas completado la importación en la nueva interfaz, podrás desinstalar el plugin antiguo.
    ¿Qué versión de Shopware necesito para el nuevo plugin? El plugin es compatible con Shopware 6.6 y 6.7, así como con PHP 8.2 o superior.
    ¿Qué datos se transfieren durante la migración? Con el modal de migración del nuevo plugin, puedes elegir si queremos cargar los datos automáticamente o configurarlos manualmente. Si eliges «Automático», leeremos la lista de destinatarios de CleverReach ya conectada y la importaremos al nuevo plugin. Siempre podrás cambiar esta configuración más adelante. Además, en los siguientes pasos de configuración, podrás seleccionar individualmente otras nuevas opciones de importación (datos de pedidos, etiquetas, campos de datos).
    ¿Tengo que volver a insertar mis formularios de suscripción al boletín? Sí. La nueva interfaz usa nuestro nuevo módulo de formularios. Los antiguos formularios de tus mundos de experiencia ya no funcionarán con la nueva interfaz y hay que sustituirlos por formularios nuevos.
    ¿Qué pasa con la confirmación de doble opt-in cuando uso CleverReach? Si activas la función de doble opt-in de CleverReach, CleverReach envía el correo de confirmación y el de Shopware se omite. Todo el proceso de confirmación se lleva a cabo entonces a través de tu formulario de CleverReach.
    ¿Seguirán funcionando mis segmentos y automatizaciones actuales? Sí. El formato de las etiquetas sigue siendo idéntico al de la interfaz anterior, así que los segmentos y las automatizaciones basadas en etiquetas seguirán funcionando sin que tengas que hacer nada. Te recomendamos que compruebes rápidamente que todo funciona bien tras la migración.
    ¿Pueden acceder a la integración varios empleados con diferentes permisos? Sí. Con la gestión de permisos de Shopware, puedes asignar diferentes roles: desde acceso de solo lectura (ver solo el panel de control o los registros) hasta permisos de edición (cambiar la configuración, activar la sincronización o la importación) y acceso de administrador completo.
    El correo sobre el carrito abandonado no llega exactamente a la hora establecida. ¿Es normal? Sí, el plugin comprueba si hay nuevos carritos abandonados cada 15 minutos, así que el envío puede retrasarse hasta este tiempo.
    Mi tienda está protegida con contraseña (p. ej., entorno de pruebas) y la importación se ha atascado. ¿Qué debo hacer? En entornos protegidos con contraseña (autenticación básica), la protección con contraseña bloquea los procesos en segundo plano de la importación (error 401), lo que hace que se cargue indefinidamente. Permite las dos rutas de API siguientes en tu configuración de .htaccess (lista blanca) o desactiva temporalmente la protección con contraseña para la importación:
    /api/crsw-on-prem-CleverReach/webhook/receiver
    /api/crsw-on-prem-CleverReach/webhook/abandonedCart

Ayuda y asistencia

Si tienes alguna duda o necesitas ayuda, no dudes en ponerte en contacto con nuestro equipo de atención al cliente cuando quieras.