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

> Conecta Pancake POS y tu inbox de Pancake con woku y acompaña a cada cliente con un viaje de 5 etapas: preventa, venta, entrega, posventa y lealtad, sin escribir código

El **conector Pancake de woku** convierte cada conversación y cada pedido de tu operación en
Pancake en un **viaje de cliente** de hasta cinco etapas: la **preventa** (la conversación que
no terminó en venta), la **venta**, la **entrega**, la **posventa** de los productos y la
**lealtad**. Tú decides qué etapas se activan, cuándo se envía cada una, por qué canal y con qué
mensaje. woku invita al cliente por **WhatsApp o email**, gestiona los recordatorios y organiza
todo en carpetas por tienda. No modifica tu operación en Pancake: solo lee las conversaciones
etiquetadas y los pedidos para crear las evaluaciones.

## Qué productos de Pancake usa

| Producto                                                                        | Qué aporta al viaje                                                                                                                                                                                                   |
| ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Inbox de Pancake** (pancake.vn, tus páginas de WhatsApp, Facebook, Instagram) | La señal de **preventa**: una conversación que tu equipo etiqueta como cerrada sin venta                                                                                                                              |
| **Pancake POS** (pos.pages.fm)                                                  | Las señales de **venta**, **entrega** (estado Recibido) y **cancelación** de cada pedido                                                                                                                              |
| **Skydropx** (opcional)                                                         | La señal de **entrega** cuando el paquete llega. Se conecta una sola vez desde **Empresa → Integraciones → Skydropx** (su propia tarjeta) y woku correlaciona cada entrega con el pedido de Pancake por la referencia |

<Note>
  En Latinoamérica el inbox de Pancake se comercializa a veces como "Pancake CRM". Este conector
  trabaja con el inbox (las conversaciones y sus etiquetas) y con Pancake POS (los pedidos). El
  producto crm.pancake.vn no es necesario.
</Note>

## Las 5 etapas del viaje

| Etapa        | Qué mide                                                        | Cuándo se dispara                                                                                                                                                                        |
| ------------ | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Preventa** | Experiencia de la atención por chat (reseña woku)               | Cuando una conversación del inbox recibe la **etiqueta de preventa** que configuraste. Se envía **al día siguiente**, dentro de un horario, y se **cancela** si ese cliente compra antes |
| **Venta**    | Satisfacción con la compra (encuesta CSAT)                      | Cuando el pedido pasa a **Confirmado** en POS (o al estado que elijas)                                                                                                                   |
| **Entrega**  | Experiencia de entrega (reseña woku)                            | Cuando el pedido pasa a **Recibido** en POS o cuando Skydropx informa la entrega                                                                                                         |
| **Posventa** | Evaluación de los **productos** del pedido (reseña woku o Flow) | Unos días **después de la entrega**                                                                                                                                                      |
| **Lealtad**  | Recomendación (encuesta NPS)                                    | Unos días **después de la entrega**, después de la posventa                                                                                                                              |

Cada etapa es independiente: la activas o desactivas, ajustas su timing, su canal y su mensaje
desde la configuración en woku. Las respuestas llegan como cualquier otra reseña o encuesta:
alimentan tus métricas, alertas y reportes.

<Note>
  La etapa de **entrega** necesita una señal de entrega. Puede venir de POS (cuando tu equipo marca
  el pedido como **Recibido**) o de **Skydropx** (cuando el paquete llega). Skydropx se conecta una
  sola vez desde **Empresa → Integraciones → Skydropx** y woku correlaciona la entrega con el pedido
  de Pancake por la referencia. Si ninguna señal llega, la etapa se omite y la **posventa** corre
  igual usando un **plazo tope** desde la venta (por defecto **35 días**, editable).
</Note>

## Cómo funciona

1. Tu equipo conversa con un cliente en el inbox. Si la conversación se cierra sin venta, la
   etiqueta con la **etiqueta de preventa** (por ejemplo "Sin compra"). woku programa la reseña de
   preventa para el **día siguiente**, dentro del horario configurado (por defecto 9 a 18 h).
2. Si el cliente compra antes de ese envío, el pedido en POS llega con la misma conversación y
   woku **cancela** la reseña de preventa: el cliente solo recibe el viaje de compra.
3. **Venta**: cuando el pedido se confirma en POS, woku envía la encuesta de satisfacción.
4. **Entrega**: cuando el pedido se marca como Recibido en POS, o Skydropx informa la entrega,
   woku envía la reseña de entrega. Si no llega ninguna señal dentro del plazo tope, esta etapa
   se omite.
5. **Posventa**: unos días después de la entrega (o del plazo tope), woku invita a evaluar los
   **productos** de ese pedido.
6. **Lealtad**: unos días después, woku envía una encuesta **NPS**. Puedes desactivar esta etapa
   si prefieres gestionar la fidelización desde Pancake.
7. En cada etapa woku invita por **WhatsApp** y, si no hay respuesta, escala a **email**; cuando
   el cliente responde, los recordatorios de esa etapa se detienen. Si el pedido se **cancela** o
   se **devuelve**, las etapas pendientes se cancelan.

## Cómo conectar

<Steps>
  <Step title="Crea una API key en Pancake POS">
    En Pancake POS ve a **Ajustes > Avanzado > Conexión de terceros > Webhook/API** y crea una
    **API key**. Esta clave da acceso completo a tu tienda: guárdala como un secreto.
  </Step>

  <Step title="Valida la clave en woku">
    En **Empresa → Integraciones → Pancake**, pega la API key y presiona **Validar clave**. woku
    lista las tiendas a las que accede la clave: elige la tuya, el país (por defecto Colombia) y
    el idioma de las invitaciones, y presiona **Conectar Pancake**.
  </Step>

  <Step title="Configura el webhook de pedidos en POS">
    Al conectar, woku te muestra **una sola vez** la URL del webhook de POS, el nombre de una
    cabecera y su valor secreto. En Pancake POS (**Ajustes > Avanzado > Conexión de terceros >
    Webhook**) pega la URL, activa el tipo **pedidos** y agrega la cabecera con ese valor. Si lo
    prefieres, marca **Configurar el webhook automáticamente** al conectar y woku lo hace por ti.
  </Step>

  <Step title="Conecta tus páginas del inbox (preventa)">
    Por cada página (WhatsApp, Facebook, Instagram) agrega su **ID** y su **page access token**
    (Ajustes > Herramientas de la página en el inbox). Luego presiona **Elegir etiquetas de
    preventa** y marca las etiquetas que tu equipo usa para una conversación cerrada sin venta.
  </Step>

  <Step title="Habilita el webhook del inbox">
    Pide a soporte de Pancake que habilite los webhooks para tu página y pega la **URL del
    webhook del inbox** que woku te mostró al conectar (o al rotarla) en **Ajustes >
    Herramientas > Webhook** del inbox.
  </Step>
</Steps>

<Warning>
  Los secretos del webhook se muestran **una sola vez**. Si los pierdes, presiona **Rotar** en la
  sección Webhooks de la integración: woku genera un secreto nuevo y el anterior deja de funcionar.
</Warning>

## Qué configuras en woku

### Datos de conexión

| Configuración                                    | Descripción                                                                                                                                         |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Idioma de las invitaciones                       | `Español` o `English`. Las evaluaciones se crean en ambos idiomas.                                                                                  |
| País                                             | Código ISO de dos letras (por defecto `CO`). woku lo usa para normalizar los teléfonos locales de los pedidos al formato internacional de WhatsApp. |
| La venta se cuenta desde el estado               | Qué estado del pedido en POS dispara la etapa de venta: **Confirmado** (por defecto), Esperando recogida, Enviado o Recibido.                       |
| Días máximo sin entrega                          | Si no llega la señal de entrega, cuántos días después de la venta se dispara igual la posventa (por defecto **35**).                                |
| Días de espera de la preventa y horario          | Cuánto espera woku después de la etiqueta (por defecto **1 día**) y entre qué horas envía (por defecto **9 a 18**, hora local de la tienda).        |
| Las ventas en mostrador omiten la entrega        | Un pedido marcado como retirado en tienda no tiene etapa de entrega.                                                                                |
| Crear la orden en Skydropx al confirmar la venta | Si tienes Skydropx conectado, woku crea la orden con la referencia del pedido para que el envío se correlacione solo.                               |
| Anotar cada respuesta en el cliente del inbox    | Lleva la calificación y el comentario de cada etapa como una nota al cliente en el inbox de Pancake.                                                |
| Modo prueba                                      | Crea las evaluaciones pero **no envía invitaciones**.                                                                                               |

### El viaje

En **Viaje** ves una tarjeta por cada etapa (preventa, venta, entrega, posventa y lealtad). En
cada una puedes activarla o desactivarla, ajustar los **días de espera** (y el **horario** en la
preventa), elegir el **canal**, editar el **mensaje** en español e inglés y subir una **imagen**
en las etapas que la muestran.

<Note>
  La definición del viaje es **tuya**: una vez que guardas tus cambios, woku deja de sobrescribirla
  con los valores por defecto. Puedes volver a ajustarla cuando quieras.
</Note>

## La experiencia del cliente

En cada etapa activa woku invita al cliente con esta secuencia:

* **Hasta 3 envíos**: el primero al dispararse la etapa, y recordatorios a las **8 horas** y a las
  **16 horas** si no hay respuesta.
* Con el canal **WhatsApp y luego email**, los dos primeros envíos van por **WhatsApp** (si hay
  teléfono) y el tercero escala a **email**. Con el canal **solo email**, todos van por email.
* En cuanto el cliente **responde**, los recordatorios de esa etapa se detienen.
* Si a las **24 horas** no hay respuesta, la invitación de esa etapa expira.

### La etapa de posventa (productos)

La posventa evalúa los **productos de ese pedido**: un producto crea una reseña; varios se
agrupan en un **Flow**. Cada instrumento se etiqueta con el pedido, la tienda, la conversación y
el producto, para que puedas filtrar y agrupar por cualquiera de esos ejes.

## Qué datos usa woku

* **Del pedido en POS**: identificador, estado, teléfono y email de facturación o de envío,
  productos (nombre e imagen), conversación de origen y vendedor asignado. Quedan como trackers
  consultables en woku: `pancake_order_id`, `pancake_shop_id`, `pancake_conversation_id`,
  `pancake_page_id`, `pancake_product_id` y `pancake_seller_id`.
* **De la conversación del inbox**: las etiquetas, la versión de la conversación y, al disparar
  la preventa, el teléfono y el email del cliente leídos por API con el token de la página.

<Warning>
  El conector requiere que el pedido o la conversación tengan **al menos un dato de contacto**. Sin
  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

```
📁 Mi Tienda        (carpeta de la tienda)
├── 📁 Preventa     (reseñas de la atención por chat)
├── 📁 Entrega      (reseñas de entrega)
└── 📁 Posventa     (reseñas de producto por pedido)
```

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Cuándo se cuenta un pedido como venta?">
    Por defecto, cuando pasa a **Confirmado** en POS. Puedes exigir un estado posterior (por
    ejemplo **Enviado**) desde la configuración. Los pedidos en **Nuevo** o **Pendiente de
    confirmación** no disparan nada.
  </Accordion>

  <Accordion title="¿Qué pasa si mi equipo no marca los pedidos como Recibidos?">
    Conecta **Skydropx** para que la entrega llegue por el webhook de la paquetería, o confía en
    el plazo tope: pasado ese plazo desde la venta, la posventa se envía igual.
  </Accordion>

  <Accordion title="¿Cómo se correlaciona la entrega de Skydropx con el pedido?">
    Skydropx se conecta una sola vez desde **Empresa → Integraciones → Skydropx**, con su propia
    tarjeta: no eliges un viaje ni un proveedor, woku correlaciona cada entrega con el pedido de
    Pancake por la **referencia** de la orden. Si activas **Crear la orden en Skydropx al
    confirmar la venta**, woku crea la orden con la referencia del pedido y la correlación es
    exacta. Si prefieres crear las órdenes tú, usa como referencia el número del pedido de POS y
    woku lo resuelve.
  </Accordion>

  <Accordion title="¿Se puede duplicar una invitación por el mismo pedido?">
    No. woku controla que cada etapa del viaje se dispare **una sola vez** por pedido o
    conversación, aunque Pancake reintente su notificación. Además, como respaldo, woku revisa
    los pedidos actualizados cada cinco minutos por si un webhook no llegó.
  </Accordion>

  <Accordion title="¿Cómo pruebo la integración sin contactar clientes?">
    Activa el **Modo prueba**: los pedidos y conversaciones siguen generando sus evaluaciones en
    woku, pero no se envía ninguna invitación. La sección **Estado** muestra el último webhook de
    POS, la última revisión y el último error, si lo hubo.
  </Accordion>

  <Accordion title="¿Cómo desconecto Pancake?">
    En **Empresa → Integraciones → Pancake → Desconectar**. Se eliminan la conexión y sus
    credenciales; los wokus y las respuestas ya creados **se conservan**. Recuerda quitar la URL
    del webhook en Pancake.
  </Accordion>
</AccordionGroup>
