Integrar tu cuenta de WoowUp con VTEX IO te permitirá importar tu catálogo de productos, datos de clientes, ventas, carritos abandonados, también podrás activar con un solo clic el Webtracking y las Notificaciones Smart Web Push.
Datos con los que posteriormente podrás realizar acciones de Marketing enfocadas en las preferencias de tus contactos.
Para que puedas integrar WoowUp y VTEX IO deberás seguir el paso a paso que a continuación detallamos.
Ten en cuenta que solo el usuario Master de la tienda tiene los permisos necesarios para trabajar con tokens.
Si ya has integrado tus cuentas de WoowUp y VTEX previamente, no es necesario que hagas estos pasos y puedes ir directamente a la sección de Instalación de la app de WoowUp que se encuentra en el store de VTEX IO
Crear un perfil de acceso VTEX
En este tutorial se explicará cómo crear un perfil de acceso para poder integrar tu tienda VTEX con WoowUp. Básicamente lo que vamos a intentar hacer es crear un nuevo perfil de acceso en tu panel de VTEX con los permisos necesarios como para tomar la información del catálogo.
Creación del perfil
Lo primero que debes hacer es ingresar a tu cuenta de VTEX, en la parte superior derecha en las configuraciones del perfil ingresar en la opción Configuración de la cuenta y seleccionas Roles de usuario.
Te llevará a una nueva pantalla donde crearemos el nuevo rol de usuario.
Para crear el nuevo rol de usuario selecciona la opción Custom, ingresamos un nombre para este perfil que puede ser "Acceso WoowUp" o el nombre que desees.
Ahora configuraremos los Productos y recursos, con este paso asignaremos los permisos necesarios para poder acceder a la información.
Primero le daremos acceso dentro de OMS a los permisos que se ven a continuación, con esto ya podemos descargar las ventas realizadas.
Luego hacer click en "Configurar producto"
Necesitaremos descargar el árbol de categorías de la tienda, por lo que requerimos que nos des acceso, selecciona la opción Catalog y marca los itemss que se ven a continuación.
Nuevamente haz click en "Configurar producto"
Para poder configurar los Triggers de carrito abandonado.
Selecciona la opción Dynamic Storage, haz click en la opción Agregar todos los recursos.
Por último lo que tenemos que hacer es agregar un usuario, debes agregar el mail del usuario master en VTEX.
Una vez culminados los pasos anteriores es necesario crear la appKey y el appToken, te explicamos el paso a paso.
Crear el appKEY y appTOKEN
Para crear el appKEY y appTOKEN ingresa en la parte superior derecha en las configuraciones del perfil ingresar en la opción Configuración de la cuenta, seleccionas Claves de aplicación.
Te llevará a una nueva pantalla donde deberás asignar un nombre a esa etiqueta que puede ser "Acceso WoowUp" o el nombre que desees.
También deberás de agregar el rol y en este paso tildarás la opción que habíamos creado previamente con el nombre "Acceso WoowUp" o el que hayas decidido.
IMPORTANTE: Te mostrará una clave secreta por única vez, debes copiarla y tenerla en un lugar seguro ya que la utilizaremos más adelante en la integración.
Vamos al siguiente paso que es integrar las cuentas de WoowUp y VTEX IO.
Instalación de la app de WoowUp que se encuentra en el store de VTEX IO
Desde tu cuenta de VTEX IO ingresa en la sección Configuración de la cuenta, seleccionas Apps y en el buscador escribe WoowUp.
Seleccionas WoowUp y abrirá una página en la que debes seleccionar "Obtener App".
Te mostrará un cartel de confirmación de "compra", para comenzar con la instalación haz click en Instalar app.
IMPORTANTE: La app de WoowUp es gratuita y este paso es solo para confirmarlo.
Te llevará al store de VTEX IO donde seleccionarás INSTALAR.
Para iniciar la configuración de la instalación es necesario que aceptes los Términos y condiciones de contratación del servicio.
Configurando la aplicación
Una vez terminados los pasos previos debemos configuraremos la aplicación.
En este paso deberás agregar los siguientes datos que consigues dentro de WoowUp:
VTEX Integration Key, debes ir a las configuraciones, integraciones, ingresar en VTEX y copiar el VTEX Integration Key. Este es un código único para cuenta.
Public Key de WoowUP, ingresa en las configuraciones, en el menú de la izquierda seleccionar Mi cuenta, al final encontrarás la Clave pública. Esta es una clave única para cuenta.
Inntance ID, ingresa en las configuraciones, en el menú de la izquierda la penúltima opción Notificaciones Push y copias el código. Este es un código único para cuenta.
La activación del Webtracking y las Notificaciones Smart Web Push es opcional.
Ten en cuenta que si deseas activar las Notificaciones Smart Web Push debes haber contratado el servicio previamente, para ello ponte en contacto con nuestro equipo de Customer Success Manager.
Completada la información previamente requerida y guardado el cambio deberás volver al menú de VTEX y en la parte inferior seleccionar "Otros" (Puede que tengas que refrescar tu pantalla).
Te mostrará el siguiente formulario, los campos obligatorios vendrán completos por default y solo debes completar los opcionales en caso de que así lo desees.
Si ya has integrado tus cuentas de WoowUp y VTEX previamente, no es necesario agregar las appKey y appToken.
Los datos que completan este formulario son:
URL: Ingresamos la Dirección web de tu tienda.
Estados de venta para descargar:
Estos son los estados por defecto disponibles para descargar:
- waiting-for-sellers-confirmation
- payment-pending
- payment-approved
- ready-for-handling
- handling
- invoiced
- canceled
Si conoce los estados de las facturas puedes ingresarlo en el campo "Estados de ventas para descargar" (separados por "," y sin espacios), también ten en cuenta que según la configuración de tu cuenta puedes encontrar que estos estados no sean exactamente iguales, por lo que puedes modificar según corresponda.
Nombre de la tienda: Ingresar el nombre de tu tienda en VTEX.
Por default ya Está el prefijo de los dominios.vtexcommercestable.com.br
Campo Obligatorio
Seller: Nombre del seller. Campo opcional
App Key/App Token: Es la clave que generamos previamente, es un código alfanumérico largo que te muestra por única vez al generar la clave de aplicación. Campo Obligatorio
Descarga de categorias: Eleges si activar o no esta opción. Campo Obligatorio
Sales Channel: Ingresamos el canal de ventas si es que existiese. Campo opcional
Woowup VTEX Token: Este campo lo obtenemos ingresando a Woowup → Configuración → Integraciones → VTEX. Podrás copiar el código VTEX Token provisto.
Campo Obligatorio
Una vez que completaste todo el formulario seleccionas la opción de guardar, te mostrará un mensaje de que la integración fue exitosa.
¡Felicitaciones! Ya integraste tu cuenta de VTEX IO con WoowUP.