Solucionar problemas con la integración de WooCommerce

Qué aprenderás

Descubre cómo resolver problemas con la configuración de tus integraciones de WooCommerce siguiendo el escenario de solución de problemas correspondiente que se describe a continuación. Si tienes problemas que no aparecen en esta lista, ponte en contacto en la Community o con nuestro equipo de asistencia.

Antes de empezar

Si aún no lo has hecho, consulta nuestra guía sobre Primeros pasos con WooCommerce para obtener instrucciones paso a paso sobre la integración. Por ejemplo, si quieres actualizar tu plugin, consulta nuestro artículo sobre cómo actualizar tu plugin de WooCommerce.

Escenarios de solución de problemas

Consulta los siguientes escenarios en función del mensaje de error que recibas en la aplicación para resolver el problema.

"Para evitar interrupciones de la funcionalidad, puede que tengas que desactivar los siguientes plugins: Nombre(s) del plugin"

Si tienes plugins de caché activos o plugins de redirección en WordPress, pueden interferir con la integración de Klaviyo y causar problemas de conexión. Te recomendamos desactivar estos plugins durante el proceso de configuración de las integraciones.

«No podemos completar tu instalación»

Este mensaje significa que tu firewall está bloqueando las solicitudes de Klaviyo, que tienes Bot Fight Mode habilitado en Cloudflare o ambas cosas.

Para solucionarlo, recomendamos tanto permitir el tráfico de integraciones de Klaviyo como desactivar el modo Bot Fight (si lo tienes habilitado).

1. Descubre cómo añadir direcciones de IP de tráfico de las integraciones de Klaviyo a la lista de permitidos.
2. Para desactivar el modo Bot Fight en Cloudflare:
   1. Inicia sesión en el panel de Cloudflare.
   2. Selecciona tu cuenta y dominio.
   3. Ve a Seguridad > Bots.
   4. Para el modo Bot Fight, selecciona Desactivado.

«Asegúrate de que tu tienda de WooCommerce tiene https y SSL habilitados»

Klaviyo espera que la URL de tu tienda cumpla los protocolos HTTPS, lo que significa que el sitio web tiene un certificado SSL válido. Si tu sitio web está en HTTP en lugar de HTTPS, es posible que tengas problemas.

Puedes comprobar si tu certificado SSL es válido en SSL Server Test (Powered by Qualys SSL Labs).

Klaviyo requiere que las pruebas se aprueben con calificaciones A.

«No se puede acceder a la API con las credenciales proporcionadas»

Puede que recibas este error si tienes personalizaciones implementadas para evitar el acceso a la API de usuarios que no han iniciado sesión. Normalmente, se trata de una función en el archivo de WordPress functions.php, que desencadena una respuesta con un código de estado 401.

Si tienes una personalización como esta, elimínala o coméntala para eliminar el error. Para obtener más información sobre este error, consulta las preguntas frecuentes sobre la API REST de WooCommerce.

«No se puede acceder a la API de pedidos. Consulta la configuración de la conexión e inténtalo de nuevo»

Este error significa que, cuando Klaviyo intenta validar la integración de WooCommerce y obtener un recuento de pedidos, su API no devuelve un valor que Klaviyo espera o no devuelve nada.

Dado que la integración aún no se ha conectado oficialmente a Klaviyo, esto significa que debe resolverse en WooCommerce.

Para obtener más información sobre este error, tienes que hacer una llamada a la API al punto de conexión de recuento de pedidos, que proporcionará más detalles clave sobre lo que se está enviando a Klaviyo. Aquí tienes un ejemplo de solicitud cURL. Para usarlo, introduce la URL de tu tienda, la clave de consumidor y el secreto de consumidor:

curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET

«Tu plugin de Klaviyo está desactualizado»

En ocasiones, el webhook tardará en llegar a Klaviyo, lo que hará que veas temporalmente la página de configuración anterior. Esto debería resolverse por sí solo al cabo de unos minutos.

404 al conectar con Klaviyo desde WordPress

Para resolverlo, debes confirmar que tienes los enlaces permanentes habilitados para tu sitio de WordPress. La autenticación de WooCommerce no funcionará a menos que los enlaces permanentes estén habilitados.

1. Ve a tu sitio de WordPress y dirígete a Ajustes > Enlaces permanentes.
2. En Configuración común, elige cualquier estructura de enlace que no sea Sin formato.
3. Confírmalo haciendo clic en Guardar cambios.
   

4. Cuando hayas terminado, vuelve a integrar con Klaviyo.

Error en la instalación: no hemos podido instalar tu extensión

Puede que encuentres un error de «Error en la instalación» al intentar instalar las integraciones a través del marketplace de WooCommerce.

En caso de que no puedas instalarlo correctamente desde el marketplace de WooCommerce, también puedes instalar el plugin desde el administrador de plugins de Wordpress.

1. Ve a la administración de WordPress y dirígete a plugins.
2. Selecciona Añadir plugin.
3. Busca Klaviyo en Buscar plugins.
4. Selecciona Instalar ahora.
5. Selecciona Activar.
6. Selecciona Marketing en la navegación de la izquierda y, después, haz clic en Klaviyo.
7. Haz clic en Conectar cuenta para empezar y, a continuación, ve a Habilitar las integraciones de WooCommerce en el artículo Primeros pasos con WooCommerce.
   

Recursos adicionales