Si los contactos o los pedidos no se sincronizan entre WooCommerce y Mautic, siga los pasos que se indican a continuación para identificar y solucionar el problema. Comience por el principio de la lista, ya que las causas más comunes se enumeran en primer lugar.
Módulo no habilitado
Síntoma: No se sincronizan datos con Mautic, aunque la prueba de conexión se realiza correctamente.
Solución: Cada función de sincronización se controla mediante su propio módulo, y los módulos deben habilitarse individualmente. Vaya a Integración de WooCommerce > Mautic y marque la pestaña correspondiente:
- Para sincronizar los contactos, abra el Sincronización de contactos y asegúrate de que el módulo esté activado.
- Para sincronizar los pedidos, abra el Sincronización de pedidos y asegúrate de que el módulo esté activado.
- Para sincronizar los carritos abandonados, abra el Carrito abandonado y asegúrate de que el módulo esté activado.
Recuerda que el módulo de autenticación debe estar conectado y funcionando antes de que cualquier otro módulo pueda sincronizar datos.
Campos personalizados de Mautic no creados
Síntoma: La conexión funciona y el módulo está habilitado, pero datos específicos como los detalles del pedido, el valor de por vida o los datos del carrito no aparecen en los contactos de Mautic.
Solución: El complemento escribe datos en 6 campos personalizados en Mautic. Si estos campos no existen en su instancia de Mautic, la API ignorará los datos sin avisar. Debe crear los siguientes campos manualmente en Mautic en Configuración > Campos personalizados:
mautic_woo_order_data(Texto)mautic_woo_cart_data(Texto)mautic_woo_recovery_url(URL)mautic_woo_total_spent(Número)mautic_woo_order_count(Número)mautic_woo_coupon_code(Texto)
Ver el Campos de Mautic sección de esta documentación para obtener información detallada sobre cada campo, incluyendo el alias y el tipo correctos.
WP-Cron no se activa
Síntoma: Los trabajos de sincronización masiva se atascan, la detección de carritos abandonados no funciona o las tareas programadas parecen no ejecutarse nunca.
Solución: WordPress cron (WP-Cron) solo se ejecuta cuando alguien visita tu sitio. En sitios con poco tráfico, esto significa que las tareas programadas pueden retrasarse horas o incluso días.
Para garantizar que WP-Cron funcione de manera confiable, configura una tarea cron real en el servidor que acceda a tu sitio. wp-cron.php punto final a intervalos regulares. A continuación se explica cómo hacerlo:
- Agregue la siguiente línea a su
wp-config.phparchivo para desactivar el cron activado por defecto por los visitantes:define( 'DISABLE_WP_CRON', true ); - Configura una tarea cron del sistema (a través del panel de control de tu alojamiento o SSH) para llamar a WP-Cron cada 5 minutos. El comando es el siguiente:
*/5 * * * * wget -q -O /dev/null https://yoursite.com/wp-cron.php
La mayoría de los proveedores de alojamiento ofrecen un programador de tareas cron en su panel de control. Si no está seguro de cómo configurarlo, póngase en contacto con su proveedor de alojamiento para obtener ayuda.
La sincronización de pedidos solo se activa en estados específicos.
Síntoma: Algunos pedidos se sincronizan, pero otros no. Los pedidos nuevos o en proceso no aparecen en Mautic.
Solución: De forma predeterminada, el módulo Order Sync solo se activa cuando un pedido alcanza el Terminado o Reembolsado estado. Los pedidos que aún se encuentren en proceso, en espera o pendientes de pago no se sincronizarán hasta que su estado cambie a uno de los estados rastreados.
Esto es intencionado, ya que sincronizar pedidos incompletos podría enviar datos inexactos a Mautic. Si necesita realizar un seguimiento de estados de pedidos adicionales, consulte la pestaña Sincronización de pedidos para ver las configuraciones disponibles.
La sincronización de contactos requiere un evento de registro.
Síntoma: El módulo Contact Sync está habilitado, pero los clientes existentes no aparecen en Mautic.
Solución: La sincronización automática de contactos se activa cuando un nuevo cliente registra una cuenta en tu tienda o cuando un cliente actualiza su perfil. No sincroniza retroactivamente a todos los clientes existentes.
Para sincronizar los clientes existentes, utilice la Sincronización masiva función en la pestaña Sincronización de contactos. Esto pone en cola a todos los clientes existentes y los procesa por lotes a través de WP-Cron.
La sincronización masiva parece estar atascada
Síntoma: Ha iniciado una sincronización masiva, pero la barra de progreso no se ha movido o lleva mucho tiempo en funcionamiento.
Solución: La sincronización masiva procesa los registros por lotes utilizando WP-Cron. Si WP-Cron no funciona de manera confiable, los lotes no se procesarán. Consulte la WP-Cron no se activa Consulte la sección anterior para saber cómo configurar una tarea cron adecuada en el servidor.
También puede comprobar el progreso y buscar errores en dos lugares:
- Registro de sincronización – Ir a WooCommerce > Integración con Mautic > Herramientas y revise el Registro de sincronización en busca de mensajes de error en registros individuales.
- Registros de depuración – Ir a WooCommerce > Estado > Registros y busca archivos con el código fuente Integración de Mautic con WooCommerceCon el modo de depuración activado, verá información detallada sobre cada lote a medida que se procesa.
Comprobación del registro de sincronización en busca de errores
El registro de sincronización es la forma más rápida de identificar por qué un contacto o pedido específico no se ha sincronizado. Para acceder a él:
- Ir a WooCommerce > Integración con Mautic > Herramientas.
- Mira el Registro de sincronización sección.
- Cada entrada muestra el tipo de objeto (contacto o pedido), el estado de la sincronización (correcta o fallida) y cualquier mensaje de error devuelto por la API de Mautic.
Los mensajes de error comunes que pueden aparecer en el registro de sincronización incluyen:
- «El campo no existe». – Falta un campo personalizado obligatorio en Mautic. Consulte el Campos personalizados de Mautic no creados sección anterior.
- «Contacto duplicado» – Mautic ya tiene un contacto con el mismo correo electrónico y ha rechazado la actualización. Revisa la configuración de Mautic para el manejo de duplicados.
- «401 No autorizado» – Las credenciales de autenticación no son válidas o han caducado. Vuelva a comprobar la configuración de la conexión.
- «429 Demasiadas solicitudes» – Has alcanzado el límite de frecuencia de la API de Mautic. El complemento volverá a intentarlo en la próxima ejecución de cron. Si esto ocurre con frecuencia, considera aumentar el intervalo entre lotes o reducir el tamaño de los lotes.