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 en icomm, 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.

Ante cualquier duda adicional sobre este paso, consulta la documentación de VTEX en la siguiente URL: https://help.vtex.com/es/tutorial/application-keys--2iffYzlvvz4BDMr6WGUtet

Configura la integración en la plataforma de icomm

Ve al menú de Integraciones
Ingresa a la opción Mis integraciones
Selecciona la opción VTEX

Completa los datos básicos de la cuenta a sincronizar (con tu instancia de VTEX)

PASO 1: Completa los campos requeridos para sincronizar la integración: Cuenta, Api Key y Api Token. No olvides colocar un nombre a la integración en el campo "Mi integración".

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:

PASO 2: Completa la configuración adicional

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.

PASO 3: Selecciona la base de datos en la 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 "Crear Base de Datos" (opción recomendada).

Configurar los parámetros de envío (opcional). Dentro de esta misma sección podrás definir las condiciones de procesamiento del masterdata mediante los siguientes parámetros:

Enviar no antes de
Permite establecer una hora mínima antes de la cual no se procesará el masterdata diario.
Esta configuración ayuda a garantizar que la información utilizada cuente con un nivel adecuado de actualización según las necesidades de tu negocio y las estrategias implementadas.

No enviar después de
Permite establecer una hora máxima luego de la cual no se procesará el masterdata diario.
Esta configuración ayuda a limitar el procesamiento hasta determinado momento del día, evitando posibles impactos sobre el uso de la información para los envíos y acciones programadas.

Una vez completada la información, haz click en Guardar. El sistema mostrará un mensaje de confirmación.

Nota: La actualización de los datos del dashboard se produce cada 4 horas, mientras que el perfil procesado y enriquecido de datos se calcula e importa cada 24 horas.

icomm utiliza las APIs de Clientes, Órdenes y Productos para obtener toda la información referida anteriormente. Nuestro proceso sincroniza datos diariamente cada (aproximadamente) 4 horas, utilizando los endpoints referidos para obtener las novedades del período transcurrido entre la última sincronización, y el momento actual. Es decir, consultamos por los clientes y/o órdenes creadas o actualizadas en dicho período. Los volúmenes son variados y dependen pura y exclusivamente de la cantidad de clientes o transacciones que se generen en dicho intervalo de tiempo. Es responsabilidad del cliente y el implementador de la plataforma de e-commerce, disponer de los recursos técnicos necesarios para que estas solicitudes no afecten a la performance de su sitio. Más allá de lo cual, las mismas se realizan en forma sincrónica para minimizar cualquier tipo de afectación, la cuál no existirá bajo circunstancias normales y un servidor de performance media.

Consulta otros artículos sobre Integraciones en icomm.

Actualizado el: 08/06/2026

¿Este artículo te resultó útil?

¡Gracias!