> ## Documentation Index > Fetch the complete documentation index at: https://woku.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # Conector Shopify > Conecta tu tienda Shopify con woku y evalúa automáticamente la experiencia de compra y los productos de cada pedido pagado, sin escribir código El **conector Shopify de woku** convierte cada pedido pagado de tu tienda en una evaluación automática de la **experiencia de compra** y, si lo activas, de los **productos** comprados. woku invita al comprador por **WhatsApp o email**, gestiona los recordatorios y organiza todo en carpetas por tienda y por categoría. No modifica tu storefront ni tu checkout: solo lee los pedidos pagados y el catálogo para crear las evaluaciones. ## Cómo funciona 1. El comprador paga un pedido en tu tienda. Shopify notifica a woku que el pedido quedó **pagado**. 2. woku crea un **woku por pedido** que evalúa la experiencia de compra (con tu logo o la imagen que configures) y lo guarda en la carpeta de tu tienda. 3. woku invita al comprador por **WhatsApp** y, si no responde, envía recordatorios que escalan a **email**. 4. Si activaste la **evaluación de productos**, unos días después el comprador recibe además una invitación para calificar los productos que compró. 5. Las respuestas llegan a woku como cualquier otra reseña: alimentan tus métricas, alertas y reportes. ## Cómo conectar tu tienda El conector no está publicado en el Shopify App Store: no se instala buscándolo ahí. La única forma de conectarlo es desde woku, como se describe abajo. En **Empresa → Integraciones → Shopify**, ingresa el dominio de tu tienda (por ejemplo `mitienda.myshopify.com`) y presiona **Continuar a Shopify**. Shopify te muestra la pantalla de autorización con los permisos que usa el conector: lectura de pedidos, de productos y de clientes. Al autorizar, te redirige de vuelta a [admin.woku.app](https://admin.woku.app). woku detecta la instalación pendiente y te muestra el aviso **Tienda de Shopify detectada** con el dominio de tu tienda. Presiona **Conectar** para vincularla. En ese momento woku registra la suscripción a los pedidos pagados y la integración queda activa. ## Qué configuras en woku Una vez conectada la tienda, en **Empresa → Integraciones → Shopify** puedes ajustar: | Configuración | Descripción | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Idioma de las invitaciones | `Español` o `English`. Las evaluaciones se crean en ambos idiomas y este es el idioma por defecto de los envíos. | | Modo prueba | Crea las evaluaciones de cada pedido pero **no envía invitaciones**. Útil para validar la integración antes de contactar clientes reales. | | Experiencia de compra | **Siempre activa.** Se evalúa al marcar el pedido como pagado. | | Evaluación de productos | Activa o desactiva la encuesta de productos (activada por defecto). Si la desactivas, solo se evalúa la compra en general, sin detalle de producto. | | Agrupar wokus por | Cómo se organizan las evaluaciones de producto en carpetas: por **colección** o por **tipo de producto**. | | Días de espera antes de enviar | Cuántos días después de la compra se envía la encuesta de productos (0 a 90, por defecto 7). El envío sale entre las **10:00 y las 12:00**, hora local de la tienda. | ### Personaliza la invitación En la sección **Invitación de experiencia de compra** puedes definir el **texto** de la invitación en español e inglés y subir una **imagen** propia. Si los dejas vacíos, woku usa el texto por defecto (por ejemplo "Compra online en Mi Tienda") y el logo de tu empresa. ## La experiencia del comprador Si el pedido trae teléfono, antes de enviar la invitación woku registra al comprador como **cliente** de tu empresa (y, si el pedido también trae email, vincula el teléfono al cliente de ese email). Así, cuando el comprador responde por WhatsApp, woku lo reconoce de inmediato sin pedirle su email, y sus respuestas quedan asociadas a su historial como cliente. ### Evaluación de la experiencia de compra Por cada pedido pagado, woku crea **una evaluación por pedido** e invita al comprador con esta secuencia: * **Hasta 3 envíos**: el primero al momento de la compra, y recordatorios a las **8 horas** y a las **16 horas** si no hay respuesta. * Los dos primeros envíos van por **WhatsApp** (si el pedido tiene teléfono); el tercero escala a **email**. * Si el pedido **no tiene teléfono**, todos los envíos van por email. Si solo tiene teléfono, todos van por WhatsApp. Si un envío por WhatsApp no puede salir, woku usa el email como respaldo en ese intento. * En cuanto el comprador **responde**, los recordatorios se detienen. * Si a las **24 horas** no hay respuesta, la invitación expira y no se insiste más por ese pedido. woku envía **una invitación a la vez por comprador**. Si un mismo cliente hace varios pedidos seguidos, las invitaciones se encolan y se envían de forma secuencial (con una pausa de una hora después de cada respuesta), en lugar de llegarle todas juntas. Los pedidos que esperan más de 7 días en la cola se descartan para no invitar con datos antiguos. ### Evaluación de productos Si está activada, woku programa además una encuesta sobre los **productos** del pedido, con la misma cadencia de reintentos que la experiencia de compra (hasta 3 envíos, cierre a las 24 horas del primero), con estas diferencias: * Cada producto tiene **un woku compartido**: todas las opiniones de todos los compradores de ese producto se acumulan en la misma evaluación, identificada por el producto de Shopify. * Si el pedido tiene **más de un producto distinto**, woku agrupa las evaluaciones en un **Flow** (una sola invitación que recorre todos los productos), enviado por email. * Si el pedido tiene **un solo producto**, la primera invitación va por WhatsApp y email a la vez. * El envío inicial sale los **días configurados** después de la compra (por defecto 7), entre las **10:00 y las 12:00** hora local de la tienda, para dar tiempo a que el pedido llegue. ## Qué datos del pedido usa woku Para crear y enviar las evaluaciones, woku consulta el pedido en Shopify y usa: * **Identificación del pedido**: número e identificador, para vincular cada evaluación con su pedido (quedan como trackers consultables en woku: `shopify_order_id`, `shopify_shop_domain` y `shopify_product_id`). * **Contacto del comprador**: el email y el teléfono asociados al pedido y a sus direcciones. Si el pedido no trae un contacto directo, woku usa el del perfil del comprador en la tienda, de ahí el permiso de lectura de clientes. El teléfono se normaliza a formato internacional para WhatsApp. * **Productos comprados**: nombre, imagen (la de la variante comprada o, en su defecto, la imagen destacada del producto), colección y tipo de producto, para crear los wokus de producto y organizarlos en carpetas. * **Zona horaria de la tienda**, para respetar la ventana de envío de la encuesta de productos. El conector requiere que el pedido tenga **al menos un dato de contacto**. Si el pedido no tiene teléfono ni email, la evaluación se crea igualmente en woku pero no se envía ninguna invitación. ## Organización en carpetas woku crea automáticamente esta estructura en tu empresa: ``` 📁 Mi Tienda (carpeta de la tienda) ├── 📁 Experiencia de Compra (un woku por pedido) ├── 📁 Colección A (wokus de producto, según agrupación) ├── 📁 Colección B └── 📁 Otros productos (productos sin colección ni tipo) ``` La carpeta raíz toma el nombre de tu tienda. Las subcarpetas de productos siguen la estrategia configurada (**colección** o **tipo de producto**); si un producto no tiene ninguna de las dos, va a **Otros productos**. Las carpetas se reutilizan entre pedidos: no se duplican. ## Preguntas frecuentes Tienes dos caminos y ambos eliminan la conexión y sus credenciales: * En woku: **Empresa → Integraciones → Shopify → Desconectar**. * En Shopify: desinstala la app desde el admin de tu tienda. Shopify notifica a woku y la conexión se elimina automáticamente. En ambos casos, los wokus y las respuestas ya creados **se conservan** en tu cuenta. Sí. Repite el flujo de conexión desde **Empresa → Integraciones → Shopify** ingresando el dominio de tu tienda. Las carpetas y los wokus existentes se reutilizan: los nuevos pedidos se suman donde estaban. Todos los envíos de ese pedido van por **email**, incluidos los recordatorios. WhatsApp solo se usa cuando el pedido tiene un teléfono utilizable. No. woku deduplica por pedido: aunque Shopify reintente la notificación, cada pedido genera **una sola** evaluación de experiencia y **una sola** encuesta de productos. Activa el **Modo prueba** en la configuración: los pedidos siguen generando sus evaluaciones en woku, pero no se envía ninguna invitación. También puedes revisar la sección **Estado** de la integración, que muestra la última notificación recibida desde Shopify y el último error, si lo hubo. En el idioma configurado en la integración (español o inglés). Las evaluaciones se crean con contenido en ambos idiomas, así el comprador puede cambiar de idioma al responder.