Problemas de conexión

Si el complemento no puede conectarse a tu instancia de Mautic, verás errores al utilizar el botón Probar conexión o cuando cualquier módulo intente sincronizar datos. A continuación se muestran los problemas de conexión más comunes y cómo solucionarlos.

API no habilitada en Mautic

Síntoma: El botón Probar conexión devuelve un error de autenticación o una respuesta 403 Prohibido.

Solución: La API de Mautic está desactivada de forma predeterminada. Debe activarla manualmente.

Inicie sesión en su instancia de Mautic como administrador.
Ir a Configuración (icono de engranaje) > Configuración.
Haga clic en el Configuración de la API pestaña.
Establecer ¿API habilitada? a Sí.
Haga clic Guardar y cerrar.

Autenticación básica no habilitada en Mautic

Síntoma: Estás utilizando la autenticación básica y la prueba de conexión devuelve un error 401 No autorizado, aunque tu nombre de usuario y contraseña sean correctos.

Solución: Mautic requiere que la autenticación básica HTTP esté habilitada explícitamente, además de la propia API.

En Mautic, vaya a Configuración > Configuración > Configuración de la API.
Establecer ¿Habilitar la autenticación básica HTTP? a Sí.
Haga clic Guardar y cerrar.

URL de Mautic incorrecta

Síntoma: La conexión de prueba falla con el error «No se pudo resolver el host» o se obtiene una respuesta HTML inesperada en lugar de JSON.

Solución: Verifique dos veces la URL de Mautic en la pestaña Conexión. Los errores comunes incluyen:

Incluir una barra inclinada al final (por ejemplo, https://mautic.example.com/ en lugar de https://mautic.example.com)
Uso http:// cuando su instancia de Mautic requiere https://
Incluyendo el /api ruta (el complemento la agrega automáticamente)
Un error tipográfico en el nombre de dominio

La URL debe ser la dirección base de su instalación de Mautic, como por ejemplo https://mautic.example.com o https://example.com/mautic.

Credenciales incorrectas

Síntoma: La conexión de prueba devuelve un error 401 No autorizado.

Solución: Verifique que el nombre de usuario y la contraseña (para Basic Auth) o el ID de cliente y el secreto (para OAuth2) sean correctos. Intente iniciar sesión en Mautic directamente con las mismas credenciales para confirmar que funcionan. Si ha cambiado recientemente su contraseña de Mautic, también deberá actualizarla en la configuración del complemento.

Tenga en cuenta que el campo de contraseña de la pestaña Conexión aparecerá en blanco después de guardar. Esto es normal, ya que el complemento la almacena cifrada. Solo introduzca un nuevo valor si necesita cambiar la contraseña.

Token OAuth2 caducado

Síntoma: La conexión funcionaba anteriormente, pero ahora devuelve un error 401 o un mensaje de «concesión no válida».

Solución: Los tokens OAuth2 tienen una fecha de vencimiento. El complemento actualiza automáticamente los tokens cuando vencen, pero esto puede fallar en determinadas situaciones:

El token de actualización ha caducado (algunas configuraciones de Mautic establecen una duración corta para los tokens de actualización).
Las credenciales del cliente OAuth2 se modificaron en Mautic.
Se reinstaló el servidor Mautic o se restauró su base de datos a partir de una copia de seguridad anterior.

Para solucionarlo, vaya a WooCommerce > Integración con Mautic > Conexión, vuelva a introducir sus credenciales OAuth2 y haga clic en Autorizar para completar el flujo OAuth2 de nuevo.

Errores de certificado SSL

Síntoma: El registro de depuración muestra un error como «Problema con el certificado SSL: no se puede obtener el certificado del emisor local» o «Error al verificar el certificado SSL».

Solución: Esto significa que tu servidor WordPress no confía en el certificado SSL de tu instancia Mautic. Esto suele ocurrir cuando:

Tu instancia de Mautic utiliza un certificado autofirmado.
El paquete CA de tu servidor WordPress está desactualizado.
El certificado SSL de Mautic ha caducado.

Para resolver esto, comprueba que tu certificado SSL de Mautic sea válido y no haya caducado. Si se trata de un certificado autofirmado, es posible que tengas que pedirle a tu proveedor de alojamiento que añada el certificado al paquete de CA de confianza del servidor. También puedes probar el certificado visitando la URL de Mautic en un navegador y comprobando si hay advertencias sobre el certificado.

El firewall del servidor bloquea las solicitudes salientes

Síntoma: La conexión de prueba se queda colgada durante mucho tiempo y luego falla con un error de tiempo de espera o de «conexión rechazada».

Solución: Algunos proveedores de alojamiento bloquean las solicitudes HTTP salientes de tu servidor WordPress. El plugin necesita realizar solicitudes HTTPS salientes al punto final de la API de tu instancia de Mautic.

Póngase en contacto con su proveedor de alojamiento y pídale que confirme que las solicitudes HTTPS salientes en el puerto 443 están permitidas desde su servidor. Facilíteles el nombre de dominio de su instancia de Mautic para que puedan incluirlo en la lista blanca si es necesario.

Mautic detrás de la autenticación HTTP o el modo de mantenimiento

Síntoma: La conexión de prueba devuelve un error 401 o 503, aunque tus credenciales de Mautic sean correctas y la API esté habilitada.

Solución: Si su instancia de Mautic está protegida por autenticación HTTP a nivel de servidor (como .htpasswd protección), las solicitudes de la API del complemento se bloquearán antes incluso de llegar a Mautic. Deberá eliminar la autenticación HTTP o configurar una excepción para el /api/ camino.

Del mismo modo, si Mautic está en modo de mantenimiento, la API no responderá. Revisa tu instancia de Mautic y asegúrate de que esté completamente en línea y accesible.

Consejos generales para la depuración

Siempre habilitar Modo de depuración en la pestaña Conexión cuando investigues problemas de conexión. Los registros mostrarán el código de estado HTTP exacto y el mensaje de error devuelto por Mautic.
Intenta abrir https://your-mautic-url.com/api/contacts?limit=1 en tu navegador mientras estás conectado a Mautic. Si ves una respuesta JSON, la API está funcionando. Si ves una página de error, el problema está en el lado de Mautic.
Revisar WooCommerce > Estado > Registros para archivos de registro con la fuente Integración de Mautic con WooCommerce.
Si ha realizado cambios en la configuración de Mautic, borre la caché de Mautic eliminando el contenido de la carpeta var/cache directorio en su instalación de Mautic, o ejecutando php bin/console cache:clear desde la línea de comandos de Mautic.