Solución de problemas con tu integración de WooCommerce

Objetivos del artículo

Aprende a 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 estás teniendo problemas que no aparecen en esta lista, comunícate en la Community o con nuestro equipo de soporte.

Antes de empezar

Si aún no lo has hecho, lee nuestra guía sobre los primeros pasos con WooCommerce para obtener instrucciones paso a paso sobre la integración. Si quieres actualizar el complemento, consulta nuestro artículo sobre cómo actualizar el complemento de WooCommerce.

Escenarios de solución de problemas

Consulta los siguientes escenarios según el mensaje de error que recibiste en la aplicación para resolver el problema.

"Para evitar interrupciones de funcionalidad, es posible que debas desactivar los siguientes complementos: Nombre(s) del complemento"

Si tienes complementos de caché o de redirección con actividad en WordPress, pueden interferir con la integración de Klaviyo y causar problemas de conexión. Recomendamos desactivar estos complementos durante el proceso de configuración de la integración.

“No podemos completar tu configuración”

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

Para resolverlo, recomendamos tanto añadir a la lista de permitidos el tráfico de integraciones de Klaviyo como desactivar Bot Fight Mode (si lo tienes habilitado).

1. Descubre cómo incluir en la lista de (entes, sitios, etc.) permitidos las direcciones IP del tráfico de integraciones de Klaviyo.
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 Bot Fight Mode, selecciona Desactivado.

“Asegúrate de que tu tienda WooCommerce tenga https y SSL habilitados”

Klaviyo espera que la URL de tu tienda cumpla con los protocolos HTTPS, lo que significa que el sitio web tiene un certificado SSL válido. Si el sitio web está en HTTP en lugar de HTTPS, podrías tener 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 interfaz de programación de aplicaciones (API) con las credenciales proporcionadas”

Es posible que recibas este error si tienes personalizaciones implementadas para evitar el acceso a la interfaz de programación de aplicaciones (API) para usuarios que no han iniciado sesión. Normalmente, esta es una función en el archivo functions.php de WordPress, que activa una respuesta con 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 de la interfaz de programación de aplicaciones (API) de REST de WooCommerce.

"No se puede acceder a la interfaz de programación de aplicaciones (API) de pedidos, revisa la configuración de 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 interfaz de programación de aplicaciones (API) no devuelve un valor que Klaviyo espera o no devuelve nada en absoluto.

Como la integración aún no se ha conectado oficialmente con Klaviyo, esto significa que debe resolverse dentro de WooCommerce.

Para obtener más información sobre este error, debes hacer una llamada a la interfaz de programación de aplicaciones (API) al punto de conexión de recuento de pedidos, lo que proporcionará más información sobre lo que se está pasando a Klaviyo. Aquí tienes un ejemplo de solicitud cURL. Para usarla, completa la URL de la tienda, la clave de consumidor y el secreto de consumidor:

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

“El complemento de Klaviyo está desactualizado”

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

Error 404 al conectarse a Klaviyo desde WordPress

Para resolverlo, confirma que tienes los enlaces permanentes habilitados para el 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 enlaces que no sea Simple.
3. Confirma al hacer clic en Guardar cambios.
   

4. Cuando termines, vuelve a integrar con Klaviyo.

Falló la instalación: no pudimos instalar la extensión

Es posible que encuentres un error de "Error de instalación" al intentar instalar las integraciones a través de WooCommerce marketplace.

Si no puedes instalar correctamente desde el marketplace de WooCommerce, también puedes instalar el complemento desde el administrador de complementos de WordPress.

1. Ve al administrador de WordPress y entra en Complementos.
2. Selecciona Añadir complemento.
3. Busca Klaviyo en Buscar complementos.
4. Selecciona Instalar ahora.
5. Selecciona Activar.
6. Selecciona Marketing en la navegación del lado izquierdo y luego haz clic en Klaviyo.
7. Haz clic en Conectar cuenta para comenzar y, luego, continúa con Habilitar las integraciones de WooCommerce en el artículo Primeros pasos con WooCommerce.
   

Recursos adicionales