Artículos sobre: Integraciones

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.


  1. Dentro del ADMIN de VTEX
  • Accede a Configuraciones de la cuenta
  • Accede a Roles de Usuario



  1. 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



  1. 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


  1. 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




  1. 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.



  • 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:



  1. 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.



  1. 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).



  • 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: 27/10/2025

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!