Pidgely para VTEX
Para operaciones VTEX que envían mucho email y se preocupan por dónde llega: conecta tu cuenta con una clave de aplicación y Pidgely envía los emails de pedido con tu marca, desde tu dominio, con tráfico transaccional y de marketing separados.
Conectar mi tienda
Qué hace la integración
- Conexión con credenciales que creas tú: el nombre de tu cuenta VTEX, una clave de aplicación y su token, sin nada que instalar
- Los cinco emails de pedido salen a medida que el pedido del OMS cambia de estado, mediante un hook de pedidos registrado en tu cuenta
- Pidgely registra un hook de pedidos por clave de aplicación y lo renueva en la revisión, porque VTEX deja caducar el hook tras 3 días sin tráfico
- El email de los clientes se lee de Master Data (la entidad CL); donde la clave no llega, VTEX solo entrega su dirección enmascarada de relay
- Varias cuentas, marcas o unidades B2B pueden conectarse, cada una con sus dominios verificados y su propia reputación de envío
Cómo conectar
- En el admin de VTEX, en Configuración de la cuenta → Roles, crea un rol con View order, List Orders, Feed v3 and Hook Admin, documentos de solo lectura de Master Data y un permiso de lectura del catálogo (Get Product and SKU)
- En Configuración de la cuenta → Claves de aplicación, crea una clave, asóciale ese rol y copia la clave y su token
- En Pidgely, abre Tiendas, elige VTEX y pega el nombre de la cuenta, la clave y el token
- Pidgely los comprueba con una llamada a la API de pedidos, guarda todo cifrado y inicia una primera sincronización silenciosa
- Desactiva los mensajes transaccionales equivalentes del lado de VTEX, para que el comprador no reciba duplicados
Bueno saber
Usa una clave hecha solo para Pidgely: VTEX permite un único hook de pedidos por clave de aplicación, así que compartirla con otra integración reemplazaría el hook de esa integración.
VTEX no tiene webhooks de clientes ni de productos y su lista de pedidos no filtra por «actualizado desde»; por eso, cada 6 horas Pidgely vuelve a leer los pedidos creados en los últimos 30 días y lee los productos uno por uno. Los carritos abandonados no se capturan: VTEX los expone solo por el orderForm de la tienda, lo que exigiría un script en ella.
VTEX también trae sus herramientas transaccionales. Pidgely sirve a quien quiere la entregabilidad bajo control; mira emails transaccionales de pedido para el contenido de cada uno. La creación de la clave está en la documentación de VTEX sobre claves de aplicación.
Preguntas frecuentes
¿Qué permisos necesita la clave de VTEX?
El rol necesita View order, List Orders, Feed v3 and Hook Admin, lectura de documentos de Master Data y un permiso de lectura del catálogo, como Get Product and SKU.
¿Por qué una clave solo para Pidgely?
VTEX da un hook de pedidos a cada clave de aplicación. Una clave compartida con otra herramienta vería su hook sobrescrito.
¿Instalo alguna app de la VTEX App Store?
No. La conexión usa una clave de aplicación que creas en el admin, así que no hay nada que instalar.
¿Por qué algunos emails de clientes aparecen enmascarados?
VTEX muestra su dirección de relay cuando la clave no lee Master Data. Dale al rol lectura de la entidad CL y llegarán los emails reales.
¿Con qué rapidez salen los emails de pedido?
Cuando se dispara el hook de pedidos. Si VTEX pierde uno, la revisión cada 6 horas vuelve a leer los pedidos de los últimos 30 días y envía lo que faltó, una vez por pedido y tipo.
Empieza ya
Conecta tu tienda VTEX
Crea una cuenta gratis, verifica tu dominio y conecta la tienda. La primera sincronización empieza al instante.
Crear cuenta gratis