Cómo realizar Integración con VTEX
Introducción
La integración con el E-Commerce VTEX permite enviar de forma automática los datos del MASTERDATA de clientes hacia un perfil ICOMMKT, así como el enriquecimiento de los mismos a partir de información procesada de las diversas compras realizadas por cada uno de ellos.
- Entre estos datos podemos encontrar:
• Fecha de última compra
• Días desde última compra
• Fecha de primera compra
• Días desde primera compra
• Productos comprados en los últimos 30, 60, 90, 180, 360, 360 + días
• Categorías de Productos comprados en los últimos 30, 60, 90, 180, 360, 360 + días
• Cantidad de compras realizadas en los últimos 30, 60, 90, 180, 360, 360 + días
• Monto de compras realizadas en los últimos 30, 60, 90, 180, 360, 360 + días
• Monto promedio de compras realizadas en los últimos 30, 60, 90, 180, 360, 360 + días
• RFM de compras realizadas en los últimos 30, 60, 90, 180, 360, 360 + días
• Códigos de descuento aplicados en los últimos 30, 60, 90, 180, 360, 360 + días.
• Marcas de Última Compra
• Categorías de Última Compra
• Códigos Promo de Última Compra
• RFM_Group
• RFM_Segment
Integración paso a paso
Para activar la integración, previamente se deben generar Roles de Usuario dentro de la plataforma de VTEX.
- Dentro del ADMIN de VTEX
- Accede a Configuraciones de la cuenta
- Accede a Roles de Usuario
- Crea un nuevo Rol de Usuario ICOMMKT_Integration con las siguientes características:
- Permisos:
a) Agregar producto/ OMS/ Atributo Visualizar Pedidos (View Order) y (List Orders)
b) Agregar producto/ Dynamic Storage/ Atributo Acceso sólo para lectura en las entidades de datos (Read Only Documents).
c) Agregar producto/ Catalog / Atributos:
- Field list
- Value field list
- Category
- Providers
- Groups
- Brands
- SKU
- a) Ingresa a Configuración de la cuenta en tu plataforma de Vtex
b) Selecciona la opción Claves de aplicación
c) Selecciona el botón Agregar clave general
d) Escribe la clave y haz click en el botón Agregar roles
e) Selecciona el rol Icommkt_Integration y confirma Agregar rol
f) Accederás a la ventana Mis claves donde debes seleccionar el botón Generar nueva
g) Escribe el nombre de la etiqueta y haz click en Generar
h) Estos pasos te llevarán a una ventana donde se muestra el token por única vez
i) Comparte la clave generada con el equipo de Customer Success para verificar la integración.
- Configura la integración en la plataforma de Icomm
- Ve al menú de Configuración
- Ingresa a la opción Integraciones
- Selecciona la opción VTEX
- Completa los datos básicos de la cuenta a sincronizar (con tu instancia de VTEX)
- Completa los campos requeridos para sincronizar la integración: Cuenta, Api Key y Api Token.
- Presiona el botón Verificar para proceder a la siguiente fase.
Después de presionar "Verificar", la plataforma informará si se pudo o no realizar la conexión con VTEX.
No se pudo conectar
Si la plataforma no logró sincronizar la conexión se mostrará el siguiente mensaje:
Conexión exitosa
Si Icomm logra conectarse con la plataforma VTEX se mostrará el siguiente mensaje:
- Configura los datos del sitio y el canal
En caso de una conexión exitosa, podrás continuar con la configuración de la integración.
- Sales Channel: despliega la lista y selecciona los canales disponibles en VTEX o bien elige la opción "Seleccionar Todos".
- E-commerce URL: completa el enlace de tu sitio web.
- Selecciona el perfil ICOMMKT en el cual se almacenarán los datos
Puedes seleccionar un perfil existente, o bien solicitar la creación de uno nuevo a través del botón NUEVO PERFIL (opción recomendada).
- Al utilizar la opción de NUEVO PERFIL, el sistema solicitará un nombre.
- Una vez completado el nombre, click en OK
• El sistema generará el perfil solicitado con la estructura de campos base del VTEX MASTERDATA.
- Para finalizar, presiona el botón Guardar
El sistema mostrará un mensaje de confirmación.
Actualizado el: 17/01/2025
¡Gracias!