Solución de problemas de integración en Magento 2

Aprenderá

Aprenda 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 sigue teniendo problemas después de seguir estos pasos, póngase en contacto con nuestra Comunidad o con nuestro Equipo de Soporte. 

Antes de empezar

Si aún no lo ha hecho, lea nuestra guía Introducción a Magento 2 para obtener instrucciones paso a paso para configurar su integración con Magento 2.

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

Pasos generales para la solución de problemas

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

El procedimiento OAuth de Klaviyo requiere que su sitio web sea accesible públicamente, de lo contrario fallarán las llamadas a la API necesarias para generar los tokens de acceso. 

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

Asegúrese de que su cortafuegos no está bloqueando las peticiones de Klaviyo

Todo el tráfico saliente de integración de Klaviyo está detrás de un conjunto de direcciones IP predecibles y estáticas para que pueda tener un alto nivel de confianza de que este tráfico proviene de Klaviyo. Lea nuestro artículo para aprender cómo allowlist Klaviyo direcciones IP de tráfico de integración. 

Compruebe las versiones de sus extensiones Magento 2 y Klaviyo

1. Si utiliza Magento v2.2.0, tendrá que habilitar manualmente OAuth.
2. Asegúrese de que ha instalado la extensión correcta de Klaviyo (puede que necesite actualizarla).

Asegúrese de que los puntos finales de OAuth son accesibles

Es posible que tenga reglas de reescritura adicionales o que falten, lo que puede hacer que los puntos finales OAuth por defecto de Magento 2 sean inaccesibles. Klaviyo necesita acceder a estos puntos finales para generar las credenciales necesarias para el proceso de autorización.

Asegúrese de que las URL que aparecen a continuación son accesibles para su tienda:

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

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

1. Puede validar que son accesibles realizando 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. Debe esperar una respuesta similar a la siguiente. Es normal ver un error al realizar una solicitud de esta manera, y valida que los puntos finales están respondiendo correctamente. 
   
3. Si no recibe una respuesta relacionada con OAuth, debe 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 ser causado por una sub-ruta de la tienda en su URL. Compruebe si hay un problema de sub-ruta de la tienda accediendo a los puntos finales en:

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

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

Si estos puntos finales se resuelven, entonces incluya las siguientes reglas de reescritura en su .htaccess para solucionar el problema.

RewriteEngine activado
RewriteRule /oauth/token/request$ https://%{HTTP_HOST}/[Ruta de la tienda]/oauth/token/request [L,R=301]
RewriteRule /oauth/token/access$ https://%{HTTP_HOST}/[Ruta de la tienda]/oauth/token/access [L,R=301]

Borre la integración y vuelva a crearla

Si ha realizado cambios tras un intento de integración anterior fallido, es una buena idea eliminar la integración OAuth original. Las claves utilizadas pueden no ser válidas y será necesario regenerarlas.

1. Dentro de Magento, navegue hasta Sistemas
2. Seleccionar integraciones
3. Localice el registro de integración de Klaviyo y elimínelo

Una vez eliminado el registro de integración, siga los pasos de nuestra guía sobre cómo integrar con Magento 2 para crear un nuevo registro de integración e inténtelo de nuevo.

Problemas específicos de la versión de Magento

Fallo específico de Magento 2.4.2

Si está utilizando Magento 2.4.2, existe un problema conocido por el que fallan las activaciones OAuth. Al activar la integración, es posible que aparezca un mensaje de error como el que se muestra a continuación. Incluso si no recibe el error, la activación OAuth puede haber fallado. Normalmente, el error se puede encontrar en sus registros de Magento.

Para resolver este error, deberá:

• Actualice a Magento 2.4.3. Consulte la documentación de Magento 2 para actualizar su versión. 
• Aplique 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á usted en Magento 2.4.6 y experimenta un error de autenticación 401 después de integrarse 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á que habilitar la autenticación mediante token de portador para que Klaviyo pueda realizar solicitudes utilizándola (en lugar de OAuth 1.0). Para activar la autenticación de token de portador:

1. En su admin de Magento, navegue a Tiendas > Configuración > Servicios > OAuth > Configuración del consumidor.
2. Para el ajuste Permitir que los tokens de acceso OAuth se utilicen como tokens de portador independientes, seleccione Sí.
3. Haga clic en Guardar Config.
   

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

Recursos adicionales

Referencia de datos de Magento 2
Guía para soportar múltiples tiendas Magento (para Magento 2.x)