Solución de problemas de tus Magento 2 integraciones

Objetivos de aprendizaje

Aprende a resolver problemas con la configuración de OAuth de Magento 2 siguiendo los pasos de solución de problemas que se describen a continuación. Si sigues teniendo problemas después de seguir estos pasos, dirígete a nuestra comunidad o a nuestro equipo de asistencia. 

Antes de empezar

Si aún no lo has hecho, lee nuestra guía sobre los primeros pasos con Magento 2 para obtener instrucciones paso a paso para configurar tus Magento 2 integraciones.

Klaviyo utiliza el protocolo OAuth para generar un token de acceso y recuperar datos de tu Magento 2 tienda, comercio. Si has personalizado tu instalación de Magento 2, puede hacer que falle el procedimiento OAuth de Klaviyo. Este artículo te guiará a través de una serie de pasos de solución de problemas para identificar dónde se produce el fallo.

Pasos generales para solucionar problemas

Asegúrate de que tu sitio es accesible al público con un certificado SSL válido

Klaviyo'requiere que tu sitio web sea de acceso público, de lo contrario fallarán las llamadas a la interfaz de programación de aplicaciones (API) necesarias para generar los tokens de acceso. 

1. Asegúrate de no haber protegido con contraseña o IP el acceso restringido a tu tienda, comercio.
2. Asegúrate de que tu tienda, comercio es accesible a través de HTTPS con un certificado SSL válido. Puedes probar tu certificado aquí.

Asegúrate de que tu cortafuegos no bloquea las peticiones de Klaviyo

Todo el tráfico saliente de Klaviyo integraciones está detrás de un conjunto de direcciones IP predecibles y estáticas para que puedas tener un alto nivel de confianza en que este tráfico procede de Klaviyo. Lee nuestro artículo para aprender a lista de (entes, sitios, etc.) permitidos Klaviyo integraciones tráfico direcciones IP. 

Comprueba las versiones de tus extensiones Magento 2 y Klaviyo

1. Si utilizas Magento v2.2.0, tendrás que activar manualmente OAuth.
2. Asegúrate de que has instalado la extensión Klaviyo correcta (puede que tengas que actualizarla).

Asegúrate de que el punto de conexión OAuth es accesible

Puede que tengas reglas de reescritura adicionales o que falten, lo que puede hacer que el punto de conexión OAuth Magento 2 predeterminado sea inaccesible. Klaviyo necesita acceder a estos puntos de conexión para generar las credenciales necesarias para el proceso de autorización.

Asegúrate de que las URL que aparecen a continuación son accesibles para tu tienda, comercio:

https://[URL de la tienda]/oauth/token/request

https://[URL de la tienda]/oauth/token/acceso

1. Puedes validar que son accesibles haciendo una petición POST como ésta:

   curl --location --url 'https://[URL de la tienda]/oauth/token/request' --request 'POST' -v

   curl --location --url 'https://[URL de la tienda]/oauth/token/access' --request 'POST' -v

2. Debes esperar una respuesta similar a la siguiente. Es normal que aparezca un error al realizar una petición de este modo, y valida que el punto de conexión está respondiendo correctamente. 
   
3. Si no recibes una respuesta relacionada con OAuth, debes comprobar que no haya redireccionamientos, reglas de reescritura no válidas o errores internos del servidor que impidan el acceso a estas URL.

Esto puede deberse a una sub-ruta tienda, comercio en tu URL. Comprueba si hay un problema en la sub-ruta tienda, comercio accediendo al punto de conexión en:

https://[tienda, comercio URL]/[tienda, comercio Path]/oauth/token/request

https://[tienda, comercio URL]/[tienda, comercio Path]/oauth/token/acceso

Si estos puntos de conexión se resuelven, entonces incluye las siguientes reglas de reescritura en tu .htaccess para solucionar el problema.

RewriteEngine en
RewriteRule /oauth/token/request$ https://%{HTTP_HOST}/[tienda, comercio Path]/oauth/token/request [L,R=301]
RewriteRule /oauth/token/access$ https://%{HTTP_HOST}/[tienda, comercio Path]/oauth/token/access [L,R=301]

Borra las integraciones y vuelve a crearlas

Si has realizado cambios tras un intento previo de integraciones fallido, es una buena idea eliminar las integraciones OAuth originales. Las claves utilizadas pueden no ser válidas y habrá que regenerarlas.

1. Dentro de Magento, navega a Sistemas
2. Selecciona integraciones
3. Localiza el registro Klaviyo integraciones y elimínalo

Una vez eliminado el registro de integraciones, sigue los pasos de nuestra guía Cómo integrar con Magento 2 para crear un nuevo registro de integraciones e inténtalo de nuevo.

Problemas específicos de la versión de Magento

Fallo específico de Magento 2.4.2

Si utilizas Magento 2.4.2, existe un problema conocido por el que fallan las activaciones OAuth. Al activar las integraciones, es posible que aparezca un mensaje de error como el que se muestra a continuación. Aunque no recibas el error, la activación OAuth puede haber fallado. Normalmente, el error se puede encontrar en tus logs de Magento.

Para resolver este error, tendrás que

• Actualiza a Magento 2.4.3. Consulta la documentación de Magento 2 para actualizar tu versión. 
• Aplica un parche como se describe en el repositorio github de Klaviyo para Magento 2.

Fallo de autenticación específico de Magento 2.4.6

¿Estás utilizando Magento 2.4.6 y experimentas un error de autenticación 401 tras integrarte con Klaviyo? Esto podría deberse a un error conocido de Magento que afecta a la versión 2.4.6 de Magento. Para solucionarlo, tendrás que habilitar la autenticación mediante token de portador para que Klaviyo pueda hacer peticiones utilizándola (en lugar de OAuth 1.0). Para activar la autenticación de token de portador:

1. En tu admin de Magento, navega a tienda, comercio > Configuración > Servicios > OAuth > Configuración del consumidor.
2. Para la opción Permitir que los tokens de acceso OAuth se utilicen como tokens de portador independientes, selecciona Sí.
3. Haz clic en Guardar Config.
   

Tras realizar esta actualización, tus errores de autenticación anteriores deberían resolverse y se reanudarán las sincronizaciones de integraciones.

Recursos adicionales

Magento 2 referencia de datos
Guía para soportar múltiples Magento tienda, comercio (para Magento 2.x)