VTEX
Actualizado 24 de agosto de 2026
La integración de VTEX importa a Pluspoint los pedidos completados de su tienda. Cada pedido importado crea o identifica un contacto y añade una entrada de VTEX fechada a su línea de tiempo. Esa entrada es lo que escucha una automatización posterior a la compra. Conéctela cuando quiera que una compra dispare una encuesta, un mensaje o un cupón sin exportar nada a mano.
Antes de empezar
- Permiso de Configuración de cuenta establecido en Completo: la pestaña Integraciones está oculta para todos los demás.
- Acceso a su VTEX Admin, con permiso para generar claves de aplicación.
- Una localización de Pluspoint a la que vincular la tienda.
- Una suscripción activa y dentro de sus límites de localizaciones y usuarios.
Dónde encontrarlo
Ajustes → Integraciones, o vaya a https://app.pluspoint.io/account-settings/integrations.
Generar una App Key y un App Token en VTEX
La App Key identifica la aplicación que se conecta a su tienda y el App Token la autoriza. Pluspoint necesita ambos, más el nombre de su cuenta.
- Inicie sesión en su VTEX Admin.
- Vaya a Account Management → Apps.
- Haga clic en Generate App Key and Token.
- Elija Internal app keys como tipo de clave. Es el nivel de acceso que Pluspoint necesita.
- En los permisos, incluya el recurso View order. Forma parte de OMS - Full access y de IntegrationProfile - Fulfillment Oms. Sin él, Pluspoint no puede leer los detalles de los pedidos.
- Haga clic en Generate.
- Copie la App Key y el App Token de inmediato.
Advertencia La App Key y el App Token dan acceso a su tienda VTEX. Guárdelos en un lugar seguro y no los comparta más allá de la persona que hace esta configuración.
Conectar su tienda VTEX
- Vaya a Ajustes → Integraciones.
- Seleccione Añadir integración y busque VTEX.
- Seleccione Conectar.
- Rellene los tres campos de credenciales que se enumeran más abajo en Campos de credenciales.
- Seleccione Conectar.
Antes de guardar las credenciales, Pluspoint las valida. Si VTEX las rechaza, la conexión falla con “La autenticación de VTEX falló” y no se guarda nada.
Si la conexión se completa, se abre la ventana Gestionar integración para que asocie la cuenta a una localización.
Campos de credenciales
| Campo | Qué introducir |
|---|---|
| Nombre de cuenta | El nombre de su cuenta de VTEX: el identificador de la tienda que aparece en la URL de su VTEX Admin |
| Application Token | El App Token generado en VTEX |
| Application Key | La App Key generada en VTEX |
Los tres son obligatorios y no se comprueba el formato ni la longitud de ninguno.
Vincular la tienda a una localización
Los pedidos se importan por localización, así que la cuenta de VTEX debe asociarse a una.
- Abra la ventana Gestionar integración: se abre sola después de conectar, y más tarde con el botón Administrar de la fila de VTEX.
- Elija Conectar a localización y seleccione la localización en el desplegable Localización, o elija No conectar para dejarla sin asociar.
- Seleccione Guardar.
Puede hacer lo mismo desde la localización: Localizaciones → Gestionar localizaciones → abra la localización → Integraciones → la fila VTEX → Conectar Perfil.
El desplegable Localización oculta las localizaciones que ya tienen una conexión de VTEX, de modo que una localización solo puede llevar una tienda.
Cómo funciona la importación de pedidos
| Comportamiento | Detalle |
|---|---|
| Programación | Una vez al día a las 12:00 UTC |
| Qué se importa | Los pedidos del día anterior que devuelve VTEX, para cada localización vinculada a una cuenta de VTEX. Solo los pedidos completos: los pedidos incompletos se ignoran |
| Coincidencia de contactos | Por el número de teléfono limpio del comprador, o por su dirección de email |
| Actualización de contactos | El nombre, los apellidos, el email o el número de teléfono que falten se completan en un contacto existente; los valores existentes no se tocan |
| Emails enmascarados | Las direcciones de proxy de VTEX terminadas en .ct.vtex.com.br se convierten de vuelta a la dirección real antes de guardar el contacto |
| Evento registrado | Un evento de pedido de VTEX llega a la línea de tiempo de actividad del contacto, que es lo que escucha el disparador Pedido de VTEX |
| Clientes recurrentes | El evento del pedido solo se escribe para un contacto que todavía no tiene ningún evento de integración en su línea de tiempo. Por tanto, un comprador que repite no genera un segundo evento. Tampoco lo genera un comprador cuyo contacto ya lleva un evento de otra integración conectada |
| Envíos | Ninguno. La importación registra datos; lo que se envía al comprador procede de una automatización que usted cree |
| Cuentas por cuenta de Pluspoint | Una. Conectar de nuevo sobrescribe el nombre de cuenta, la clave y el token guardados |
La importación es un lote diario: nada llega al comprador antes de la ejecución de las 12:00 UTC siguiente a su pedido. Cuente con ese margen al planificar cualquier espera adicional.
Convertir los pedidos en un mensaje posterior a la compra
Conectar la tienda es solo la primera mitad. Para actuar sobre un pedido, cree una automatización en Campañas → Automatizadas: crearla requiere acceso completo a Campañas y un plan que incluya Campañas.
Lo más habitual es una encuesta de satisfacción posterior a la compra:
- Vaya a Campañas → Automatizadas y haga clic en Crear automatización.
- Póngale un nombre, por ejemplo “Encuesta posterior a la compra”.
- Haga clic en el nodo Disparador y seleccione Pedido de VTEX en Eventos desencadenantes. Esta opción solo aparece cuando la integración de VTEX está conectada.
- Si quiere, active Una vez por contacto y, si quiere, acote el público en Quién puede entrar.
- Haga clic en el + de la conexión situada debajo del disparador y añada un Esperar si quiere dar margen a la entrega. Una espera colocada justo después del disparador se mide desde el propio evento del pedido: “3 días” son tres días después del pedido, no tres días después de que la automatización se enterara.
- Haga clic otra vez en el + y añada Enviar encuesta desde el grupo Enviar.
- Elija el Canal y la plantilla de Encuesta. Solo se listan las plantillas con Habilitar envío de encuestas activado.
- Si el canal es Email, elija un diseño de email de la Biblioteca que tenga un botón Enlace de encuesta. Si es WhatsApp Business, elija una plantilla de WhatsApp aprobada cuyo botón de URL sea un enlace de encuesta. SMS y WhatsApp (Beta) usan el texto de la propia Plantilla mensaje de la encuesta.
- Haga clic en Guardar y, después, active Activado en la lista Automatizadas. Hasta que lo haga, la automatización es un borrador y no envía nada.
Automatizar encuestas explica al completo el lienzo de automatización, la preparación de las plantillas y los tiempos de envío.
Desconectar VTEX
- En la fila VTEX, seleccione Borrar. La misma confirmación está disponible desde el botón rojo Borrar dentro de la ventana Gestionar integración.
- Confirme en el cuadro ¿Borrar integración?.
El vínculo de VTEX de su localización pasa a Desconectado, así que no se importan más pedidos. Los contactos y la actividad ya importados permanecen, y cualquier automatización que use el disparador Pedido de VTEX simplemente deja de recibir entradas nuevas.
Resolución de problemas
| Síntoma | Causa | Solución |
|---|---|---|
| VTEX no está en la lista de Añadir integración | Ya está conectado | Solo existe una cuenta de VTEX por cuenta de Pluspoint, así que la fila desaparece de la lista una vez conectada. Use Administrar o Borrar en la fila existente |
| Falta la pestaña Integraciones o aparece atenuada | No tiene Configuración de cuenta en Completo, o la suscripción ha caducado o supera los límites del plan | Pida ayuda a un propietario de la cuenta o a un administrador con acceso completo, o resuelva el problema de facturación en Ajustes → Facturación |
| ”La autenticación de VTEX falló” | Las credenciales son incorrectas, o la clave no tiene permiso para leer pedidos | Genere una App Key y un App Token nuevos en VTEX con acceso de lectura de pedidos e inténtelo de nuevo |
| El panel de la localización indica Integración no conectada | La conexión de VTEX a nivel de cuenta falta o está inactiva | Use Ir a integraciones y conecte VTEX primero: ese paso necesita Configuración de cuenta en Completo |
| Falta una localización en el desplegable Localización | Ya tiene una conexión de VTEX | Desconecte primero la tienda de esa localización |
| Falta Pedido de VTEX en la lista de disparadores de automatización | VTEX no está conectado en esta cuenta | Conéctelo en Ajustes → Integraciones |
| No aparece ningún contacto tras conectar | La importación diaria todavía no se ha ejecutado, o la localización no está vinculada | El proceso se ejecuta una vez al día a las 12:00 UTC y lee los pedidos del día anterior. Confirme el vínculo en Gestionar integración o en la localización |
| Llegan contactos pero no se envía nada | Importar pedidos no envía nada por sí solo, o la automatización sigue siendo un borrador | Cree una automatización con el disparador Pedido de VTEX, revise su interruptor Activado y busque nodos con el borde rojo |
| Algunos compradores nunca reciben la invitación | Están dados de baja, no tienen dirección para el canal elegido, o están dentro de la ventana de protección sobre encuestar de la plantilla | Revise la ficha del contacto y la Protección sobre encuestar en la pestaña Compartir de la plantilla |
| Un comprador recurrente no vuelve a ser encuestado | El evento del pedido solo se escribe en un contacto que todavía no tiene ningún evento de integración | Use otro disparador, como un Evento personalizado enviado desde sus propios sistemas, si necesita que cuente cada pedido |