> ## 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** es una app publicada en el Shopify App
Store que 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. Es una integración **sin código**: instalas la
app, conectas la tienda a tu empresa en woku y ajustas la configuración
desde el panel.

<Note>
  El conector es para tiendas Shopify que quieren medir la voz del cliente
  después de la compra. No modifica tu storefront ni tu checkout: solo lee
  los pedidos pagados y el catálogo para crear las evaluaciones.
</Note>

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

## Instalación desde el App Store

<Steps>
  <Step title="Instala la app en tu tienda">
    Busca **woku** en el Shopify App Store e instálala en tu tienda.
    Shopify te mostrará la pantalla de autorización con los permisos que
    usa el conector: lectura de pedidos, de productos y de clientes.
  </Step>

  <Step title="Autoriza y vuelve a woku">
    Al autorizar, Shopify te redirige a la aplicación administrativa de
    woku ([https://admin.woku.app](https://admin.woku.app)). Inicia
    sesión con tu cuenta si aún no lo has hecho.
  </Step>

  <Step title="Conecta la tienda a tu empresa">
    woku detecta la instalación pendiente y te muestra el aviso
    **Tienda de Shopify detectada** con el dominio de tu tienda. Pulsa
    **Conectar** para vincularla a tu empresa. En ese momento woku
    registra la suscripción a los pedidos pagados y la integración queda
    activa.
  </Step>
</Steps>

<Tip>
  También puedes iniciar la conexión desde woku: en **Empresa →
  Integraciones → Shopify**, ingresa el dominio de tu tienda (por ejemplo
  `mitienda.myshopify.com`) y pulsa **Continuar a Shopify** para
  autorizar la app. El resultado es el mismo.
</Tip>

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

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

<Note>
  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.
</Note>

### Evaluación de productos

Si está activada, woku programa además una encuesta sobre los
**productos** del pedido:

* 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; los recordatorios siguen por email.
* 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. Los recordatorios
  siguen la misma cadencia que la experiencia de compra: hasta 3 envíos
  y cierre a las 24 horas del primero.

## 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, solo para enviar las invitaciones. 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.

<Warning>
  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.
</Warning>

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

<AccordionGroup>
  <Accordion title="¿Cómo desconecto mi tienda?">
    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.
  </Accordion>

  <Accordion title="¿Puedo reinstalar la app después de desinstalarla?">
    Sí. Reinstala la app desde el Shopify App Store (o reconecta desde
    **Empresa → Integraciones → Shopify** ingresando el dominio) y
    vuelve a vincular la tienda a tu empresa. Las carpetas y los wokus
    existentes se reutilizan: los nuevos pedidos se suman donde
    estaban.
  </Accordion>

  <Accordion title="¿Qué pasa con los pedidos sin teléfono?">
    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.
  </Accordion>

  <Accordion title="¿Se puede duplicar una invitación por el mismo pedido?">
    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.
  </Accordion>

  <Accordion title="¿Cómo pruebo la integración sin contactar clientes?">
    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.
  </Accordion>

  <Accordion title="¿En qué idioma le llega la invitación al comprador?">
    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.
  </Accordion>
</AccordionGroup>
