Referencia de requisitos del sistema para la integración con Magento

Qué aprenderás

Conoce los requisitos del sistema para una sincronización óptima con Magento 1 o 2. El administrador de tu tienda de Magento es responsable de las especificaciones y la configuración del sistema. Asegurarte de que tu sistema esté configurado para funcionar con Klaviyo te permitirá disfrutar de una experiencia de integración fluida.

No se admiten versiones de Magento 2 anteriores a la 2.4.0.

Configura los permisos de la API

Para una integración existente de Magento 1, el usuario de la API SOAP necesita acceso completo a los recursos. Asegúrate de que Acceso a recursos esté configurado como Todo.

Para Magento 2, instala y configura la extensión de Klaviyo y, a continuación, configura OAuth y aprueba los permisos de API solicitados. Sigue la guía de integración de Magento 2 para completar la configuración en Magento y habilitar la integración en Klaviyo.

Sin los permisos de API necesarios, Klaviyo no podrá interactuar correctamente con las API de tu tienda de Magento, lo que impedirá que la integración recupere datos de tu tienda.

Habilitar el acceso a los puntos de conexión de la API necesarios

Klaviyo solicita datos de puntos de conexión específicos. Las configuraciones de tu sistema deben permitir el acceso a estos puntos de conexión; considera el impacto de los controles de seguridad o la lógica de redirección de URL en la accesibilidad de estos puntos de conexión para Klaviyo. Si Klaviyo no tiene acceso a los puntos de conexión de API esperados, algunos o todos los datos de Magento no podrán sincronizarse y verás la elaboración de informes de errores en la aplicación.

Para Magento 2, la tienda debe tener un nombre de host accesible públicamente. Permite que Klaviyo acceda a /oauth/token/request y /oauth/token/access para la autenticación de OAuth, así como a la API REST en /index.php/rest. Si la autenticación falla, sigue la guía de solución de problemas de Magento 2.

Todo el tráfico saliente de las integraciones de Klaviyo está protegido por un conjunto de direcciones IP estáticas y predecibles para que puedas tener un alto nivel de confianza en que este tráfico proviene de Klaviyo; recomendamos incluir estas direcciones en la lista de permitidos.

Capacidad del sistema para solicitudes de API de sincronización del histórico de datos

Cuando activas la integración, Klaviyo pone automáticamente en cola solicitudes de la API para sincronizar el histórico de datos, incluidos los registros de clientes, los registros de pedidos y el catálogo de productos. Intentamos hacerlo rápidamente para que los profesionales del marketing puedan usar estos datos en sus cuentas lo antes posible. También intentamos hacerlo de forma responsable, limitando la simultaneidad y gestionando los reintentos de forma elegante. Si tu tienda tiene un gran volumen de histórico de datos, una capacidad de recursos limitada u otras aplicaciones que realicen solicitudes sustanciales a la API, recomendamos consultar con tu administrador de Magento para asegurarte de que tu infraestructura está equipada para admitir la sincronización del histórico de datos. Es posible que tu administrador quiera plantearse aumentar temporalmente los recursos o aplicar el escalado automático.

Verifica la validez del certificado SSL

Un certificado SSL autentica digitalmente la identidad de un sitio web y permite una conexión cifrada entre un navegador web y un servidor web. El certificado SSL del sitio web está alojado en el servidor de origen del sitio. Un certificado SSL válido es fundamental para aceptar pagos de forma segura, proteger los inicios de sesión con contraseña y proteger los formularios web. SSL Server Test se puede usar para verificar el certificado SSL de un sitio web.

Las integraciones de Magento pueden desactivarse si caduca el certificado SSL del sitio web. En este caso, los certificados de dominio e intermedios deben actualizarse en el proveedor de hosting. Si no tienes claro dónde se encuentran los certificados, ponte en contacto con el proveedor de hosting para obtener ayuda.

Asignación de memoria del servidor suficiente

El espacio en disco para productos, imágenes de productos, emails almacenados y páginas de contenido estático es independiente de la memoria de PHP. Disponer de suficiente espacio en disco no significa que PHP tenga memoria suficiente para procesar las solicitudes de API de Klaviyo.

Recomendamos que se asigne más de 1 gigabyte de memoria a tu integración de Klaviyo, pero 512 megabytes es el mínimo requerido. Si tu servidor no puede asignar recursos suficientes para responder a las solicitudes de Klaviyo, se producirán errores de integración. La integración Klaviyo-Magento comienza con una sincronización del histórico de datos, por lo que se recomienda verificar la configuración de memoria en Magento y en tu servidor antes de activar la integración.

Comprueba la configuración de PHP memory_limit que usa el servidor web de Magento. El valor predeterminado de PHP es de 128 megabytes, pero la configuración de alojamiento puede anularlo. El administrador de Magento puede actualizar esta configuración en php.ini. Para Magento 2, sigue también la guía de configuración de PHP de Adobe.

Usa marcas de tiempo UTC para sincronizar

Klaviyo utiliza la hora universal coordinada (UTC) para solicitar datos recientes de Magento e interpretar las marcas de tiempo que devuelven las API. Las marcas de tiempo incorrectas pueden hacer que se pierdan registros durante la sincronización o que aparezcan en el momento equivocado en Klaviyo.

Pide al administrador de Magento que verifique que las marcas de tiempo que devuelven las API de la tienda están en UTC. Si faltan registros recientes o muestran horas incorrectas, revisa esas marcas de tiempo y la configuración del servidor antes de cambiar los ajustes de zona horaria de la tienda.

Recursos adicionales