Cómo configurar cupones (para Magento 1.x)
La integración de Klaviyo para Magento 1 ya no acepta instalaciones nuevas y llegará al final completo del soporte a finales de 2027. Klaviyo Support ya no puede ayudar con solicitudes relacionadas con Magento 1.
Objetivos del artículo
Magento admite reglas de precio del carrito de compras que se pueden usar para aplicar un descuento al pedido de un cliente. Se pueden crear códigos de cupón para reglas de precio existentes, de modo que los compradores puedan usar un código para aplicar un descuento durante el pago.
La función de cupones de Klaviyo para Magento permite que las tiendas con una integración existente de Magento 1.x hagan lo siguiente:
- Crea nuevos cupones en Klaviyo asociados con reglas de precio existentes en Magento.
- Incluye cupones únicos en los mensajes de correo electrónico y SMS/MMS del flujo, para que cada destinatario reciba un código único.
Esta guía explicará cómo configurar cupones de Magento en Klaviyo.
Los cupones únicos generados por Magento están disponibles en los mensajes del flujo de correo electrónico y SMS/MMS. No están disponibles en los correos electrónicos de campaña. Enviar códigos de cupón únicos en una campaña puede requerir miles de códigos por segundo, y los límites de la tasa del servidor de Magento pueden afectar la generación de código en ese volumen.
Requisitos
Estos pasos requieren una integración de Magento 1 existente y habilitada, y la extensión de Klaviyo instalada en Magento. Para obtener más información sobre los datos sincronizados por la integración, consulta la referencia de datos de Magento 1.
Habilitar la interfaz de programación de aplicaciones (API) REST
Empieza por habilitar la interfaz de programación de aplicaciones (API) REST creando un nuevo rol REST y otorgándole acceso completo, y luego asigna el rol a uno de tus usuarios administradores.
- Haz clic en Sistema > Servicios web > REST - Roles.
- Crea un nuevo rol de Administrador. En el campo Role Name, ingresa un nombre, por ejemplo, "Administrator".
- Haz clic en la pestaña Recursos de la interfaz de programación de aplicaciones (API) de rol a la izquierda. Configura Acceso a recursos como Todo y haz clic en Guardar rol.
- Luego, navega a Sistema > Servicios web > REST - Atributos.
- Selecciona Administrador en la lista de tipos de usuario.
- Configura Acceso a recursos en Todos y haz clic en Guardar.
- A continuación, ve a System > Permissions > Users.
- Selecciona un usuario administrador de la lista y haz clic en Editar usuario.
- Haz clic en la pestaña Rol de REST en la barra lateral izquierda.
- Haz clic en el botón de opción para asignar el nuevo rol de administrador de REST al usuario.
- Haz clic en Guardar usuario.
Ahora habilitaste la interfaz de programación de aplicaciones (API) REST para tu tienda de Magento.
Si no estás seguro de si tu interfaz de programación de aplicaciones (API) de REST está configurada correctamente, revisa los pasos que se describen en nuestro recurso sobre solución de problemas de cupones para Magento 1x.
Genera credenciales REST en Magento
Para habilitar las funciones de cupón de Magento de Klaviyo, genera credenciales de REST para la interfaz de programación de aplicaciones (API) con el usuario administrador al que le asignaste el rol de REST y luego ingrésalas en Klaviyo.
- Inicia sesión como el usuario administrador al que asignaste el rol REST en la sección Habilitar la interfaz de programación de aplicaciones (API) REST anterior.
- Haz clic en Sistema > Configuración y luego haz clic en Klaviyo en la sección Clientes.
- Haz clic en Generar tokens OAuth.
Se completarán la Clave de consumidor, el Secreto de consumidor, el Token de autorización y el Secreto de autorización. En el siguiente paso, copiarás y pegarás estos valores en tu cuenta de Klaviyo.
Configura cupones de Magento en Klaviyo
Tu servidor de Magento debe ser compatible con firmas HMAC-SHA1 para la autenticación de OAuth.
- Desde tu cuenta de Klaviyo, ve a tu integración de Magento.
- En la pestaña Configuración, ve a Avanzado > Cupones y selecciona Activar cupones.
- Ingresa tu Consumer key, Consumer secret, Authorization token y Authorization secret desde Magento.
- Haz clic en Guardar.
Después de que la configuración se guarde correctamente, puedes crear un cupón desde la página de Cupones.
Crea un cupón de Magento en Klaviyo
Abre la página de Cupones en Klaviyo y selecciona la pestaña Cupones de Magento 1.
Antes de crear un nuevo cupón, primero tendrás que definir una regla de precios en Magento que incluya todas las especificaciones del cupón. No se pueden crear reglas de precios desde Klaviyo. Un nuevo cupón creado en Klaviyo debe hacer referencia a una regla de precios preexistente en Magento.
Al crear una regla de precios en Magento, ten en cuenta que la opción para asociar una nueva regla de precios con un cupón específico debe dejarse configurada como cupón específico y debes tener seleccionada la casilla Use Auto Generation.
- Haz clic en Crear cupón de Magento 1.
- Ingresa el Nombre y el ID de regla de Magento:
- Nombre: Usa un nombre único con solo letras, números y guiones bajos, y con un máximo de 32 caracteres. No puedes cambiar el nombre después de crear el cupón.
- ID de regla de Magento: Ingresa el ID de la regla de precios que creaste en Magento para asociarla con este cupón.
- Haz clic en Crear cupón. Una vez que la creación se completa correctamente, Klaviyo te devuelve a la lista de cupones de Magento.
Después de crearla, puedes revisar los siguientes detalles en Klaviyo:
- Cupón: El nombre del cupón en la lista.
- Plazo con actividad: Abre el cupón para ver las fechas que proporciona su regla de precios de Magento. El periodo de tiempo puede mostrar:
- Con actividad, sin caducidad
- Fecha A: sin vencimiento
- Fecha A - Fecha B
- Fecha de caducidad B
- Creado: La fecha en que se creó el cupón.
- Última actualización: La fecha en que se actualizó el cupón por última vez.
Para editar un cupón, haz clic en su nombre, actualiza el ID de regla de Magento y haz clic en Actualizar cupón. Para eliminar un cupón, abre el menú de la fila, selecciona Eliminar y confirma la eliminación.
Usa un cupón de Magento en un correo electrónico de flujo
Una vez que se crea un cupón, insértalo en un email de flujo con la siguiente etiqueta de plantilla. Para mostrar el mismo código en varios lugares, repite la etiqueta con el mismo nombre de cupón.
{% coupon_code 'CouponName' %}Reemplaza CouponName por el nombre del cupón. Por ejemplo:
Usar el mismo cupón en un mensaje de flujo de email y de SMS/MMS permite que Klaviyo reutilice el código ya asignado a ese destinatario. Repetir el nombre del cupón no garantiza un código nuevo para cada mensaje.
Usa cupones únicos en los mensajes de SMS de flujo
El cupón único también está disponible para tus mensajes SMS/MMS en los flujos. Genera los códigos tal como lo harías para el correo electrónico. Luego, usa la etiqueta de plantilla a continuación para añadir el código de cupón a tu mensaje SMS o MMS:
{% coupon_code 'CouponName' %}.
En el fragmento, cambia CouponName por el nombre de tu cupón y agrega el fragmento al mensaje de tu flujo de SMS o MMS.
Puedes usar 1 nombre de cupón por mensaje SMS/MMS. Si agregas nombres de cupón diferentes, verás un error. En el correo electrónico, puedes usar mostrar/ocultar bloques para enviar cupones diferentes según dónde viva alguien o lo que haya hecho. Para mostrar 1 oferta por destinatario, configura las condiciones para que aparezca solo el bloque de cupón previsto.
Soluciona problemas de errores
No se pueden activar los cupones ni conectarse a la interfaz de programación de aplicaciones (API) de REST
Es posible que veas “Unable to activate cupones due to an authentication issue” en la configuración de integraciones o “Unable to connect to the REST interfaz de programación de aplicaciones (API) with the specified REST credentials.” Revisa que estas credenciales sean válidas en el administrador de Magento.”
Primero, comprueba que las 4 credenciales REST se copiaron correctamente. Si son correctas, revisa estas posibles causas:
- El servidor de Magento no está configurado para admitir firmas HMAC-SHA1 para la autenticación OAuth.
- Es posible que no hayas habilitado el acceso completo a los roles para la interfaz de programación de aplicaciones (API) REST.
Confirma que el servidor de Magento admite firmas HMAC-SHA1 para la autenticación de OAuth. Luego, revisa los siguientes permisos de REST y la configuración del servidor:
- Descomenta o agrega la regla de reescritura en el archivo .htaccess .htaccess. Esta es la línea que querrás asegurarte de que esté sin comentar:
RewriteRule ^api/rest api.php?type=rest [QSA,L] - Comprueba que tu rol de REST esté configurado correctamente.
Sigue los pasos en la sección Habilitar la interfaz de programación de aplicaciones (API) de arriba. - Si usas Apache, revisa que pase el encabezado
Authorizationa PHP. La conexión REST de Magento usa credenciales de OAuth. Consulta esta guía para pasar el encabezado Authorization para obtener detalles de configuración del servidor.
Si el error menciona específicamente un certificado SSL, revisa que tu tienda de Magento tenga instalado un certificado SSL válido y de confianza.
Todos los destinatarios reciben el mismo código de cupón
Al crear una regla de precios en Magento, la opción para asociar una nueva regla de precios con un cupón específico debe dejarse configurada como Cupón específico y debes tener seleccionada la casilla de verificación “Usar generación automática”.
Haz clic en la regla de precio en Magento y, en General Information, desplázate hacia abajo hasta la opción de línea "cupón" y cambia esta configuración a "cupón específico". Luego, marca la casilla de generación automática aquí. Esto debería solucionar el problema y permitirnos generar un nuevo código de cupón único para cada destinatario del correo electrónico.