> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.icommkt.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/menuprincipalok_1kraa3o.jpg)

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

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/view-order-list-orders_eajchh.png)

  b) Agregar producto/ Dynamic Storage/ Atributo Acceso sólo para lectura en las entidades de datos (Read Only Documents).

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/dynamicstorage_g10zeb.png)

c) Agregar producto/ Catalog / Atributos: 

            
* Field list
            
* Value field list
            
* Category
            
* Providers
            
* Groups
            
* Brands
            
* SKU

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/catalog_1c1kqn5.png)

3. a) Ingresa a **Configuración de la cuenta** en tu plataforma de Vtex

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/1_s32yml.png)

b) Selecciona la opción **Claves de aplicación**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/2_37ticd.png)

c) Selecciona el botón **Agregar clave general**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/3_7lf2ix.png)

d) Escribe la clave y haz click en el botón **Agregar roles**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/4_uc2hx5.png)

e) Selecciona el rol **Icommkt_Integration** y confirma **Agregar rol**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/6_1345f5a.png)

f) Accederás a la ventana **Mis claves** donde debes seleccionar el botón **Generar nueva**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/7_f5osiw.png)

g) Escribe el nombre de la etiqueta y haz click en **Generar**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/8_1ef0mdj.png)

h) Estos pasos te llevarán a una ventana donde se muestra el token por única vez

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/9_z1zqte.png)

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

4. 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**

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_hlvuo.png)


5. 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". 

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_1a7jzto.png)

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

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/image-26_1eax7wt.png)

**Conexión exitosa**

Si icomm logra conectarse con la plataforma VTEX se mostrará el siguiente mensaje:

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/image-29_1cg87ql.png)

6. PASO 2: Completa la configuración adicional
![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_113e2al.png)
* **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.


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

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_3p9t9o.png)
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:

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_1w83vla.png)
**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.&#160;**

| Consulta otros artículos sobre [Integraciones en icomm](https://icommkt.crisp.help/es/category/integraciones-1od6o0k/).