Solucionar problemas con tu integración con Magento 2

Objetivos del artículo

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, comunícate en nuestra Community o con nuestro equipo de soporte.

Antes de empezar

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

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

Pasos generales para la solución de problemas

Asegúrate de que tu sitio sea accesible públicamente y cuente con un certificado SSL válido

El procedimiento de OAuth de Klaviyo requiere que el sitio web sea accesible públicamente; de lo contrario, fallarán las llamadas necesarias a la interfaz de programación de aplicaciones (API) para generar los tokens de acceso.

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

Asegúrate de que el firewall no esté bloqueando las solicitudes de Klaviyo

Todo el tráfico saliente de integraciones de Klaviyo está detrás de un conjunto de direcciones IP estáticas y predecibles para que puedas tener un alto nivel de confianza de que este tráfico proviene de Klaviyo. Lee nuestro artículo para conocer cómo incluir en la lista de (entes, sitios, etc.) permitidos las direcciones IP del tráfico de integraciones de Klaviyo.

Verifica las versiones de Magento 2 y del complemento de Klaviyo

1. Si usas Magento v2.2.0, tendrás que habilitar OAuth manualmente.
2. Asegúrate de haber instalado la extensión correcta de Klaviyo (es posible que debas actualizar).

Asegúrate de que los puntos de conexión de OAuth sean accesibles

Es posible que haya reglas de reescritura adicionales o faltantes, lo que puede hacer que los puntos de conexión de OAuth predeterminados de Magento 2 sean inaccesibles. 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 siguientes URL sean accesibles para tu tienda:

https://[Store URL]/oauth/token/request

https://[Store URL]/oauth/token/access

1. Puedes validar que sean accesibles haciendo una solicitud POST como esta:
   

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

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

2. Deberías esperar una respuesta similar a la siguiente. Es normal ver un error al realizar una solicitud de esta manera, y confirma que los punto de conexión respondan correctamente.
   
3. Si no recibes una respuesta relacionada con OAuth, revisa 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 subruta de tienda en la URL. Prueba si hay un problema de subruta de tienda accediendo a los puntos de conexión en:

https://[Store URL]/[Store Path]/oauth/token/request

https://[Store URL]/[Store Path]/oauth/token/access

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

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

Elimina la integración y vuelve a crearla

Si hiciste cambios después de un intento de integración fallido anterior, es buena idea eliminar la integración de OAuth original. Es posible que las claves usadas no sean válidas y deban regenerarse.

1. En Magento, ve a Sistemas
2. Select integraciones
3. Ubica el registro de la integración de Klaviyo y elimínalo

Una vez que se elimine 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 intentarlo de nuevo.

Problemas específicos de la versión de Magento

Error específico de Magento 2.4.2

Si usas Magento 2.4.2, hay un problema conocido que provoca que fallen las activaciones de OAuth. Al activar la integración, es posible que veas un mensaje de error como el que se muestra a continuación. Aunque no recibas el error, es posible que la activación de OAuth haya fallado. Normalmente, el error se puede encontrar en los registros de Magento.

Para resolver este error, tendrás que hacer una de las siguientes acciones:

• 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 de github de Klaviyo para Magento 2.

Falla de autenticación específica de Magento 2.4.6

¿Usas Magento 2.4.6 y tienes un error de autenticación 401 después de integrar con Klaviyo? Esto podría deberse a un error conocido de Magento que afecta la versión 2.4.6 de Magento. Para resolverlo, tendrás que habilitar la autenticación con token de portador para que Klaviyo pueda hacer solicitudes con este (en lugar de OAuth 1.0). Para habilitar la autenticación con token de portador:

1. En el panel de administración de Magento, ve a Tiendas > Configuración > Servicios > OAuth > Configuración de consumidor.
2. Para la configuración Permitir que los tokens de acceso de OAuth se usen como tokens portadores independientes, selecciona Sí.
3. Haz clic en Guardar configuración.

Después de hacer esta actualización, los errores de autenticación anteriores deberían resolverse y se reanudarán las sincronizaciones de integraciones.