> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maxagente.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

> Conecta tu tienda WooCommerce para que el agente venda con tu catálogo, envíe el link del checkout con el carrito listo y responda dónde está cada pedido

La integración con **WooCommerce** le permite a tu agente de Max vender con
el catálogo de tu tienda. El agente consulta productos, variaciones, precios
y stock, verifica cupones, envía un link que abre el checkout de tu tienda
(la página donde el cliente completa la compra y paga) con el carrito listo
y le dice al cliente en qué estado está su pedido.

En esta guía, el **agente** es el que atiende a tus clientes por WhatsApp o
Instagram. El **asistente** es el chat que ves al abrir un agente en Max,
donde tú lo configuras. Desde el asistente también puedes cambiar stock,
precios y pedidos de tu tienda (ver [Desde el asistente de
Max](#desde-el-asistente-de-max)).

Así se ve una venta por WhatsApp:

> **Cliente:** Hola, ¿tienen el sérum de vitamina C en 30 ml?\
>
> **Agente:** Sí, el Sérum Vitamina C 30 ml está a \$489 MXN y hay stock. ¿Lo quieres?\
>
> **Cliente:** Sí, uno. Tengo el cupón BIENVENIDA10.\
>
> **Agente:** Con BIENVENIDA10 te queda en \$440.10 MXN. Completa tu compra aquí: mitienda.com/checkout-link/… Ahí eliges el envío y pagas.

Cuando el pago se acredita, el agente se lo confirma al cliente en la misma
conversación. El aviso de envío suele llegar días después, cuando WhatsApp e
Instagram ya no dejan que el agente le escriba, así que muchas veces lo da tu
equipo (ver [Avisos de pago y envío](#avisos-de-pago-y-envío)).

Una venta completa sigue este recorrido:

```mermaid theme={null}
flowchart TD
  A["El cliente pregunta por un producto"] --> B["El agente busca el producto en tu tienda"]
  B --> C["El agente envía el link de compra"]
  C --> D["El cliente paga en el checkout de tu tienda"]
  D --> E["WooCommerce le avisa a Max que el pedido está pagado"]
  E --> F["El agente le confirma el pago al cliente"]
```

## Conectar tu tienda

Necesitas:

* La dirección de tu tienda.
* Entrar a WordPress con un usuario administrador.
* WooCommerce 3.5 o posterior para conectar, y 10.0 o posterior para que el
  link de compra arme carritos con varios productos. Con una versión
  anterior a la 10.0, el link agrega un producto por vez. Tu versión figura
  en **Plugins**, debajo de WooCommerce.

Si algo falla, Max te muestra un mensaje: búscalo en [Problemas
frecuentes](#problemas-frecuentes).

> [tab] Aprobando a Max
>
> **1. Abre la integración**
>
> En la página **Integraciones** de tu agente, abre **WooCommerce** y
> toca **Conectar**.
>
> ![Ficha de WooCommerce en Integraciones, con su descripción y el botón Conectar](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/catalogo.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=dbcd51b41d9a647181f61a994638a76f)
>
> Abre WooCommerce en Integraciones y toca Conectar.
>
> **2. Escribe la dirección de tu tienda**
>
> En **Dirección de tu tienda**, escribe la dirección pública, por
> ejemplo `https://mitienda.com`. **Nombre de la cuenta** es opcional:
> sirve para distinguir tiendas si conectas más de una. Toca
> **Conectar**.
>
> ![Formulario Conectar WooCommerce con Dirección de tu tienda, Nombre de la cuenta y el link Pegar claves](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/direccion.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=62271417a8e780ed1da2a16b8632419f)
>
> Escribe la dirección de tu tienda y toca Conectar.
>
> **3. Aprueba a Max en WooCommerce**
>
> Max te lleva al panel de tu tienda. Ingresa a WordPress si te lo pide
> y aprueba el acceso de Max dentro de los 15 minutos. WooCommerce lo
> muestra como permiso de lectura y escritura.
>
> ![Pantalla de WooCommerce donde Max pide acceso de Lectura/Escritura a la tienda, con los botones Denegar y Aprobar](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/aprobar.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=66fbe52cf0a519d5815986106fb50dbf)
>
> Aprueba el acceso de Max en el panel de tu tienda.
>
> > [!NOTE]
> >
> > La lista de permisos es la que WooCommerce muestra a cualquier app
> > con Lectura/Escritura. Max usa la escritura para registrar los
> > avisos de pedidos (los webhooks, más abajo) y para los cambios que tú
> > le pides al asistente, siempre con tu confirmación. El agente que
> > atiende a tus clientes consulta la tienda y lee pedidos.
>
> **4. Listo**
>
> Vuelves a Max con la tienda en **Conectada** y se abre **Nueva
> integración**. Sigue en [Dársela a un agente](#dársela-a-un-agente),
> desde el paso 2.

> [tab] Pegando claves
>
> Usa este camino si aprobar a Max termina en "No pudimos completar la
> conexión con tu tienda".
>
> **1. Crea la clave en WooCommerce**
>
> En el panel de WordPress, ve a **WooCommerce → Ajustes → Avanzado →
> Claves de la API REST → Añadir clave**. En **Descripción** escribe `Max`, en
> **Usuario** elige un administrador de la tienda, en **Permisos**
> elige **Lectura/Escritura** y toca **Generar clave de API**.
>
> ![Pantalla Detalles de la clave de WooCommerce con Descripción Max, el usuario administrador, Permisos Lectura/Escritura y el botón Generar clave de API](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/anadir-clave.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=15fecc94e2a6845d160ac1d6bc8c099e)
>
> En WooCommerce, crea una clave con permiso Lectura/Escritura.
>
> **2. Copia las dos claves**
>
> WooCommerce muestra la **Clave de cliente** (en Max se llama Consumer
> key y empieza con `ck_`) y la **Clave secreta de cliente** (Consumer
> secret, empieza con `cs_`) una sola vez. Cópialas antes de cerrar la
> página. Si la cerraste, genera una clave nueva.
>
> **3. Pégalas en Max**
>
> En **Integraciones** del agente, abre **WooCommerce**, toca
> **Conectar** y después **Pegar claves**. Completa **Dirección de tu
> tienda**, **Consumer key** y **Consumer secret**, y toca **Guardar**.
> Max verifica las claves, deja la tienda en **Conectada** y abre
> **Nueva integración**. Sigue en [Dársela a un
> agente](#dársela-a-un-agente), desde el paso 2.
>
> ![Formulario Conectar WooCommerce con Nombre de la cuenta, Dirección de tu tienda, Consumer key y Consumer secret](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/pegar-claves.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=fc3f73b85d27008e943a32ecbf494581)
>
> Pega las dos claves de WooCommerce y toca Guardar.

La tienda conectada queda en tu **organización**, el espacio de tu negocio
en Max: puedes dársela a cualquiera de tus agentes.

Al conectar, Max registra en tu tienda tres **webhooks** cuyo nombre empieza
con `Max`. Un webhook es un aviso automático que WooCommerce le manda a Max
cuando se crea o cambia un pedido, o cuando dejas una nota para el cliente.
Con ellos, el agente le avisa al cliente cuando su pedido se paga o sale.
No cambian nada de tu tienda y se ven en **WooCommerce → Ajustes → Avanzado
→ Webhooks**.

## Dársela a un agente

**1. Elige la tienda**

En la página **Integraciones** del agente, abre WooCommerce y toca **Usar
en este agente** en la fila de la tienda. Se abre **Nueva integración**.

**2. Completa y toca Agregar**

* **Cuándo se activa**: describe cuándo el agente usa la tienda. Te
  sirve este texto: "El cliente pregunta por productos, precios, stock,
  cupones, envíos, cambios y devoluciones o un pedido, o quiere
  comprar". Si lo dejas vacío, el agente decide solo por lo que pide el
  cliente.
* **Qué hace**: las ocho acciones vienen marcadas. Déjalas así para
  vender y responder por pedidos.
* **Cupones que el agente puede ofrecer** (opcional): ver
  [Cupones](#cupones).

Toca **Agregar**.

![Integración de WooCommerce con Cuándo se activa, las ocho acciones marcadas y el campo Cupones que el agente puede ofrecer](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/acciones.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=6f2ad9f4d582cccb8b49c07662c7a6d7)

Escribe cuándo se activa. Las ocho acciones vienen marcadas.

**3. Pruébalo**

En **Probar**, haz de cliente:

* Pide un producto, su precio y su stock.
* Pide dos productos y abre el link: tu checkout abre con los dos. Si el
  agente te envía un link por producto, revisa [Problemas
  frecuentes](#con-la-tienda-conectada).
* Para consultar un pedido, dale el número y el email de compra de un
  pedido de tu tienda. En **Probar** no hay teléfono, así que el agente
  siempre te pide el email.

Una consulta por un pedido se ve así:

> **Cliente:** Hola, ¿dónde está mi pedido?\\
>
> **Agente:** Te ayudo. ¿Me pasas el número de pedido y el email con el que compraste?\\
>
> **Cliente:** Es el 1234, [lucia@ejemplo.com](mailto:lucia@ejemplo.com)\\
>
> **Agente:** Tu pedido 1234 está completado: ya salió. La tienda dejó esta nota: "Salió por Estafeta con la guía AB123".

![Conversación en Probar: la clienta pide un sérum con un cupón y el agente responde con el precio, el descuento y el link de compra](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/probar-compra.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=5db6b3b60470e2ee4a2370f102f42ae4)

El agente consulta tu tienda, verifica el cupón y envía el link de compra.

**Probar** usa el borrador del agente (la versión sin publicar), y sus
conversaciones no aparecen en el Inbox.

> [!WARNING]
>
> Revisa el carrito sin pagar. Si terminas la compra, WooCommerce crea un
> pedido real y lo cobra con tus medios de pago.

**4. Publica**

Toca **Publicar**, en el menú del agente. El agente usa la tienda con tus
clientes desde que publicas.

## Qué puede hacer el agente

Cada **acción** es algo que el agente puede hacer en tu tienda. En el Inbox,
la conversación muestra cada acción que usó, por ejemplo "Buscó productos en
WooCommerce".

| Acción | Qué hace |
| - | - |
| **Buscar productos en WooCommerce** | Busca productos publicados por nombre o SKU (el código del producto), con precio, oferta y stock. |
| **Consultar un producto y su stock** | Consulta un producto con su descripción, sus fotos y el precio y stock de cada variación, como tonos, tallas o colores. |
| **Verificar un cupón** | Verifica si un cupón existe, si está vigente y qué descuento da. |
| **Armar el link de compra** | Revisa precio y stock y envía un link que abre el checkout de tu tienda con el carrito listo. |
| **Buscar el pedido del cliente** | Consulta el estado de un pedido por su número, si el pedido es del cliente. |
| **Consultar las compras de la conversación** | Lista los pedidos del cliente con su estado actualizado. |
| **Consultar las páginas de la tienda** | Lista tus páginas publicadas, como cambios y devoluciones, envíos o cómo comprar. |
| **Leer una página de la tienda** | Lee una página para responder con tus políticas. |

### Catálogo y precios

* El agente solo ve los productos publicados y visibles en el catálogo.
* Los precios y el stock se leen en WooCommerce en cada consulta: un cambio
  que haces en la tienda rige desde la respuesta siguiente.
* El agente cotiza el precio tal como lo cargaste en el producto, en la
  moneda de tu tienda. Si lo cargaste con IVA incluido, es el precio final.
  Si un producto está en oferta, usa el precio de oferta.
* El checkout suma el envío y, si tu tienda los agrega aparte, los
  impuestos.
* El agente envía las fotos que cargaste en el producto y en cada variación
  cuando el cliente las pide. Para que las envíe siempre al mostrar un
  producto, agrega una [regla](https://docs.maxagente.com/guias/comportamiento.md#crear-una-regla).
* Si un producto tiene variaciones, el agente pregunta cuál quiere el cliente
  y consulta el precio y el stock de esa variación.
* Si un producto se vende sin stock (en WooCommerce, **¿Permitir
  reservas?**) o no lleva la cuenta de unidades, el agente no limita la
  cantidad.
* Los productos de tipo **Producto externo/afiliado** (se compran en otro
  sitio) o **Producto agrupado** (reúnen varios productos en una página) no
  van al carrito: el agente envía el link de la página del producto.

### Cupones

* El agente verifica en WooCommerce el cupón que escribe el cliente: si
  existe, si está vigente y qué descuento da.
* Los códigos que escribes en **Cupones que el agente puede ofrecer**,
  separados por coma (por ejemplo `BIENVENIDA10, ENVIOGRATIS`), el agente los
  ofrece por su cuenta cuando vienen al caso, después de verificar que
  siguen vigentes.
* El resto de tus cupones no los muestra ni los sugiere.

### Link de compra

Antes de armar el link, el agente confirma con el cliente los productos, las
variaciones, las cantidades y los precios. Al armarlo:

* Max vuelve a verificar en WooCommerce que cada producto esté publicado, su
  precio y su stock. Si el precio cambió, el agente le informa el precio
  nuevo al cliente y le pide que lo confirme.
* Si quedan menos unidades de las que pide el cliente, el agente le ofrece
  las que quedan y arma el link si las acepta. Si el producto se agotó, le
  dice que no está disponible.
* El link es de tu tienda, con tu dominio. Abre tu checkout con el carrito
  listo y, si el cliente tiene un cupón vigente, con el cupón aplicado.
* En el checkout, el cliente elige el envío y paga con los medios de pago de
  tu tienda.
* El link no es un pedido. Nada se cobra ni se reserva hasta que el cliente
  termina el checkout, y recién ahí WooCommerce crea el pedido.
* En el detalle del pedido, **Atribución del pedido** muestra que vino de
  Max: fuente `max` y el canal de la conversación (`whatsapp` o
  `instagram`).

![Checkout de la tienda con el sérum en el Resumen del pedido y el cupón bienvenida10 aplicado](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/checkout.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=68f63ad86832bf1dfa5d775493b2c6b3)

El link abre tu checkout con el carrito listo y el cupón aplicado.

## Dónde está mi pedido

Cuando un cliente pregunta por su pedido, el agente le informa el estado,
las fechas, el total, el medio de pago, el envío elegido, los productos y
las notas para el cliente que dejó la tienda.

| Estado en WooCommerce | Qué le dice el agente al cliente |
| - | - |
| Pendiente de pago | Todavía no pagó. |
| Procesando | Está pagado y la tienda lo está preparando. |
| Procesando, con pago contra entrega (en WooCommerce, **Contra reembolso**) | La tienda lo está preparando y lo paga al recibirlo. |
| En espera | La tienda tiene que confirmar el pago, por ejemplo una transferencia. |
| Completado | Ya salió o está listo para retirar. |
| Cancelado, Reembolsado o Fallido | El estado tal cual. |

Con un estado personalizado, como el de un plugin de envíos, el agente
informa el nombre del estado.

### Seguimiento y detalles del envío

Pasa un pedido a **Completado** cuando sale o queda listo para retirar,
también si se paga contra entrega. Para que el agente dé el detalle, deja una
**nota para el cliente** en el pedido, por ejemplo "Salió por Estafeta con la guía AB123" o
"Listo para retirar en el local". El agente lee esas notas y da el código o
el link de seguimiento que traen.

Para dejar una nota:

* En WooCommerce, abre el pedido, escribe la nota en **Añadir nota**, elige
  **Nota para el cliente** y toca **Añadir**.
* O pídeselo al asistente de Max: "Avísale al pedido 1234 que salió con la
  guía AB123".

WooCommerce le envía la nota al cliente por email, y el agente se la avisa
en la conversación.

Si usas un plugin de envíos, revisa si el agente ve su código de
seguimiento: en **Probar**, pregúntale por un pedido despachado, con su
número y el email de compra. Si el agente da el código, el plugin lo guarda
como nota para el cliente y no tienes que hacer nada. Si no lo da, deja la
nota tú o pídesela al asistente, como en los ejemplos de arriba.

### Qué pedidos puede consultar cada cliente

Para proteger los datos de tus clientes, el agente solo responde por un
pedido si se cumple una de estas condiciones:

* El pedido salió de un link de compra enviado en esa conversación.
* El teléfono de facturación del pedido es el de la conversación. En
  WhatsApp, el teléfono de la conversación es el número desde el que
  escribe el cliente, y nadie lo puede cambiar. Max los compara aunque
  estén escritos distinto, con o sin código de país, espacios o guiones
  (por ejemplo, `+52 1 55 1234 5678` y `55 1234 5678`).
* El cliente da el número del pedido y el email con el que hizo la compra,
  la misma verificación de la página de seguimiento de pedidos de
  WooCommerce.

Si no se cumple ninguna, el agente le pide el email de la compra. Si tampoco
coincide, le pide que consulte con una persona de la tienda. El agente
responde igual cuando el pedido no existe y cuando es de otra persona, para
que nadie pueda averiguar qué números de pedido existen. Nunca muestra la
dirección, el email ni el teléfono del pedido: el cliente ve la dirección
de envío en el email de confirmación de su pedido.

Si el cliente pregunta por su compra sin dar el número, el agente le muestra
hasta 10 pedidos: los que salieron de un link de esa conversación, los que
ya consultó en ella y hasta 5 de los últimos 6 meses con el teléfono de la
conversación, también los que hizo en tu web sin Max. Si su pedido no
aparece, por ejemplo porque escribe por Instagram (sin teléfono) o compró
con otro número, el agente le pide el número del pedido.

> [!TIP]
>
> Para que el agente reconozca por el teléfono a quien compró en tu web, el
> checkout tiene que pedir el teléfono, que en WooCommerce viene opcional.
> Con el checkout de bloques, abre en WordPress **Páginas → Finalizar
> compra**, selecciona el bloque de la dirección y, en **Campos de
> dirección**, pon **Teléfono** en **Obligatorio**. Con el checkout clásico,
> ve a **Apariencia → Personalizar → WooCommerce → Finalizar compra** y pon
> **Campo Teléfono** en **Obligatorio**.

## Avisos de pago y envío

El agente le escribe al cliente, en la conversación, cuando cambia uno de
los **pedidos de la conversación**: los que salieron de un link enviado en
ella y los que el cliente ya consultó en ella.

El agente puede avisar hasta 23 horas después del último mensaje del
cliente. WhatsApp e Instagram dejan que un agente automático le escriba a un
cliente solo durante las 24 horas que siguen a su último mensaje, y Max deja
una hora de margen. Pasado ese plazo, el aviso queda para tu equipo (ver
[Cuando el agente no puede avisar](#cuando-el-agente-no-puede-avisar)).

* **El aviso de pago** llega casi siempre, porque el cliente acaba de
  comprar con el link y la conversación está activa.
* **El aviso de envío** suele llegar uno o más días después de la compra,
  así que muchas veces queda para tu equipo.

En el Inbox, cada aviso aparece en la conversación como **Le avisó al
cliente**, y el mensaje del agente lleva la etiqueta **Aviso del pedido**.

![Conversación donde, después del link de compra, aparece Le avisó al cliente y el agente escribe que recibió el pago, con la etiqueta Aviso del pedido](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/aviso-pago.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=75a8cfa5fa83351e41e0527fe8211919)

Cuando el pedido se paga, el agente le avisa al cliente en la misma conversación.

| Qué pasa en WooCommerce | Qué le escribe el agente |
| - | - |
| El pedido queda pagado | Que recibieron su pago y el siguiente paso según la entrega que eligió. |
| Agregas una nota para el cliente | Lo que dice la nota, con el código o el link de seguimiento si lo trae. |
| El pedido pasa a **Completado** | Que su pedido ya salió o está listo, con el seguimiento si dejaste una nota con eso. |

Cuándo llega el aviso de pago depende del medio de pago:

* **Online** (tarjeta, Mercado Pago, PayPal u otro medio de tu checkout):
  WooCommerce pasa el pedido a **Procesando** cuando el medio de pago
  confirma el cobro, y el agente avisa el pago.
* **Transferencia**: el pedido queda **En espera** hasta que confirmas el
  pago y lo pasas a Procesando, en WooCommerce o pidiéndoselo al asistente.
  Ahí el agente avisa el pago.
* **Contra entrega**: el pedido pasa a Procesando sin estar pagado, así que
  no hay aviso de pago. El cliente paga al recibir, y el agente le avisa
  cuando pasas el pedido a **Completado**.

Reglas de los avisos:

* El agente avisa una sola vez por motivo, pedido y conversación. Cada nota
  para el cliente con un texto distinto es un aviso aparte.
* El agente también necesita la IA activa en la conversación. La IA se
  apaga cuando alguien del equipo toma la conversación en el Inbox, y se
  vuelve a activar cuando se la devuelves al agente (ver [Devolvérsela al
  agente](https://docs.maxagente.com/guias/inbox.md#detalles-y-devolvérsela-al-agente)).
* Para reconocer que un pedido salió de su link, Max usa la **atribución de
  pedidos** de WooCommerce, que viene activada. Si alguien la desactivó, las
  compras funcionan igual, pero no llega el aviso de pago: el pedido pasa a
  ser de la conversación recién cuando el cliente pregunta por él, y desde
  ahí sí llegan los avisos de envío.

### Cuando el agente no puede avisar

Si el agente no puede escribirle al cliente, la conversación vuelve a no
leída y muestra **No pudo avisarle al cliente**. Al tocarlo se ve lo que
avisó la tienda y el motivo, por ejemplo:

> **No pudo avisarle al cliente**\
>
> WooCommerce avisó que la tienda completó el pedido #51: ya salió o está listo para entregar.\
>
> Pasaron más de 24 h desde el último mensaje del cliente y WhatsApp no deja escribirle sin una plantilla aprobada. Para avisarle, toma la conversación y envíale una plantilla.

Avísale tú según el motivo:

| Motivo en la tarjeta | Cómo avisarle |
| - | - |
| Faltaba menos de una hora para que se cumplieran 24 h | Respóndele desde la conversación antes de que se cumplan las 24 horas. |
| Pasaron más de 24 h, en WhatsApp | Toma la conversación y toca **Enviar plantilla**, un mensaje aprobado por Meta (ver [La ventana de 24 horas](https://docs.maxagente.com/guias/inbox.md#la-ventana-de-24-horas)). |
| Pasaron más de 24 h, en Instagram | Respóndele desde la conversación. Instagram deja que una persona del equipo responda hasta 7 días después del último mensaje del cliente. |
| El agente está apagado en esta conversación | Respóndele desde la conversación. |

El cliente igual recibe los emails de WooCommerce.

## Desde el asistente de Max

Estas acciones las pides tú en el asistente. El asistente busca el producto
o el pedido, te muestra el valor actual y te pide confirmación. A diferencia de la configuración del agente, estos cambios
rigen en tu tienda en el momento, sin publicar.

| Acción | Qué hace | Ejemplo |
| - | - | - |
| **Ajustar stock y precios** | Cambia el stock, el precio o el precio de oferta de un producto o de una variación. En un producto con variaciones, los precios se cambian en cada variación. | "Ahora tengo 22 unidades del sérum de vitamina C" |
| **Cambiar el estado de un pedido** | Pasa un pedido a procesando, completado, en espera o cancelado, o lo marca como pagado. WooCommerce puede avisarle al cliente por email. | "Me llegó la transferencia del pedido 1234, márcalo pagado" |
| **Dejar una nota en un pedido** | Agrega una nota al pedido, para el cliente o solo para la tienda. | "Avísale al pedido 1234 que salió con la guía AB123" |

* Un pedido con pago contra entrega no se marca pagado: pásalo a completado
  cuando sale o queda listo para retirar.
* Después de cada cambio, el asistente muestra el valor anterior y el nuevo.
  Para deshacerlo, pídele que vuelva al valor anterior. Los emails y avisos
  que el cliente ya recibió no se deshacen.
* Nombres, descripciones, fotos y visibilidad de los productos se editan en
  WooCommerce.

## Desconectar

**1. Desconecta la tienda en Max**

En **Integraciones** de un agente, abre WooCommerce y toca **Desconectar
cuenta** en la fila de la tienda. Max borra las claves guardadas, los
webhooks `Max` de tu tienda y las notas de pedidos que recibió de ella.

![Fila de la tienda en Cuentas conectadas, en uso por un agente, con el botón Desconectar cuenta](https://mintcdn.com/max-agente/EjoyfqPPW6YbQeJ4/images/woocommerce/cuenta-conectada.png?fit=max\&auto=format\&n=EjoyfqPPW6YbQeJ4\&q=85\&s=2940a42644dbb24608a1345311b4f62c)

Desconectar cuenta está en la fila de la tienda.

**2. Revoca la clave en WooCommerce**

WooCommerce no deja que una app borre su propia clave, así que la clave
de Max sigue en tu tienda. En WordPress, ve a **WooCommerce → Ajustes →
Avanzado → Claves de la API REST**, pasa el cursor sobre la clave cuya descripción
empieza con `Max` y toca **Revocar**.

> [!WARNING]
>
> Desconectar tiene efecto inmediato. Los agentes que usaban la tienda dejan
> de poder ejecutar sus acciones, **también en sus versiones ya publicadas**.

## Problemas frecuentes

### Al conectar

| Qué ves | Qué pasa | Qué hacer |
| - | - | - |
| "El hosting o un plugin de seguridad de tu tienda (como Cloudflare o Wordfence) bloquea las consultas de Max" | Un firewall (un filtro de seguridad de tu hosting) o un plugin de seguridad no deja pasar a Max. | Copia este pedido tal cual y envíaselo a quien administra tu sitio o al soporte de tu hosting: "Permitir las solicitudes a `/wp-json/` con el agente de usuario `Max Agente (+https://maxagente.com)`". Después vuelve a conectar. |
| "No encontramos WooCommerce en esa dirección" | La dirección no es la de la tienda, o los enlaces permanentes de WordPress están en **Simple** (las direcciones de tus páginas terminan en `?p=123`). | Revisa la dirección. En WordPress, ve a **Ajustes → Enlaces permanentes**, elige **Nombre de la entrada** y guarda. Cambia la forma de las direcciones de tus páginas, no su contenido, y los links viejos con `?p=123` siguen funcionando: WordPress los lleva a la dirección nueva. |
| "La tienda redirige a una dirección sin https\://" o "Tu tienda tiene que usar https\://" | La dirección de la tienda empieza con `http://`, sin conexión segura. | Activa HTTPS en tu WordPress (lo ofrece tu hosting) y vuelve a conectar. |
| "Esa dirección es un WordPress sin WooCommerce activo, o con una versión anterior a la 3.5" | WooCommerce no está activo o es muy antiguo. | Activa o actualiza WooCommerce en **Plugins**. |
| "No pudimos completar la conexión con tu tienda" | Tu tienda no pudo enviarle la clave a Max después de aprobar. | Vuelve a intentarlo o conecta pegando claves. |
| "WooCommerce rechazó esas claves. Revisa que estén bien copiadas." al pegar claves | Las claves están mal copiadas o son de otra tienda. | Copia otra vez las dos claves de la tienda que escribiste en la dirección. Si ya no las ves, genera una clave nueva. |
| "La clave es de solo lectura" al pegar claves | Pegaste una clave con permiso **Lectura**. La tienda queda en **Error**. | En **WooCommerce → Ajustes → Avanzado → Claves de la API REST**, edita la clave y elige **Lectura/Escritura** (o crea una nueva), y vuelve a conectar. |
| "Esas claves son de otra cuenta" o "Autorizaste otra cuenta" | Al reconectar una tienda, usaste la dirección o las claves de otra. | Reconecta con la tienda de esa fila. Para sumar otra tienda, usa **Agregar cuenta**. |

### Con la tienda conectada

| Qué ves | Qué pasa | Qué hacer |
| - | - | - |
| La tienda está en **Error** con "WooCommerce rechazó las claves de Max. Vuelve a conectar la cuenta." | Alguien revocó la clave de Max en WooCommerce o borró al usuario que la creó. Mientras tanto, los agentes derivan las consultas de la tienda a una persona. | Toca **Conectar** en la fila de la tienda, escribe la misma dirección y aprueba a Max otra vez, o pega una clave nueva. |
| La tienda está en **Error** con "WooCommerce ya no le da permiso a Max. Vuelve a conectar la cuenta." | El usuario de WordPress que creó la clave ya no es administrador ni gestor de la tienda (el perfil de WooCommerce para quien administra pedidos y productos). | Devuélvele el perfil en **Usuarios**, columna **Perfil**, o toca **Conectar** y aprueba a Max con un usuario administrador. |
| "Tu WooCommerce no arma carritos con varios productos desde un link", en la fila de la tienda | Tu WooCommerce es anterior a la 10.0. El link agrega un solo producto al carrito. Si el cliente quiere varios, el agente le envía el link de cada uno y pasa la compra a una persona de la tienda. Si tiene un cupón, le pide que lo escriba en el checkout. | Actualiza WooCommerce en **Plugins**. No hace falta volver a conectar: Max revisa la versión otra vez cuando el agente arma un link (como mucho una vez cada 6 horas), y el aviso desaparece solo. |
| El asistente responde "La clave de WooCommerce es de solo lectura" | Alguien cambió a **Lectura** el permiso de la clave de Max. El asistente no puede cambiar stock, precios ni pedidos. | Crea una clave con permiso **Lectura/Escritura**, toca **Conectar** en la fila de la tienda y pégala, o aprueba a Max con un clic. |
| El agente dice que el hosting está bloqueando sus consultas | El firewall empezó a bloquear a Max después de conectar. | Envía el pedido de la primera fila de [Al conectar](#al-conectar). |

## Preguntas frecuentes

> [accordion] ¿Max cambia mis precios, mi stock o mis pedidos?
>
> Solo cuando tú se lo pides al asistente de Max, que te muestra el cambio
> y te pide confirmación. El agente que atiende a tus clientes consulta tu
> tienda, envía links de compra y lee pedidos.

> [accordion] ¿Max cobra por mi cuenta? ¿Necesito Mercado Pago?
>
> No. El cliente paga en el checkout de tu tienda WooCommerce, con tus
> medios de pago. No hace falta conectar otra integración de cobros.

> [accordion] ¿El agente crea pedidos en mi tienda?
>
> No. El agente envía un link al checkout con el carrito listo. El pedido
> lo crea WooCommerce cuando el cliente termina el checkout. El link no
> reserva stock: si otro cliente compra antes, el stock puede agotarse.

> [accordion] Vendo por transferencia fuera del checkout. ¿El agente puede anotar esos pedidos?
>
> Sí, en una planilla: dale al mismo agente la integración de [Google
> Sheets](https://docs.maxagente.com/guias/google-sheets.md) y el agente anota ahí los pedidos que
> cobras por fuera. Esos pedidos quedan en la planilla, no en WooCommerce.

> [accordion] ¿El agente puede decir cuánto cuesta el envío?
>
> El costo exacto lo ve el cliente en el checkout de tu tienda, cuando
> escribe su dirección y elige el método de envío. Para que el agente
> responda antes, publica en tu tienda una página de envíos con tus zonas y
> costos: el agente la lee y responde con lo que dice.

> [accordion] ¿Puedo conectar varias tiendas?
>
> Sí. Cada tienda es una conexión aparte. En **Integraciones** de un
> agente, abre WooCommerce y toca **Agregar cuenta**. Después eliges qué
> tienda usa cada agente con **Usar en este agente**.

> [accordion] ¿Qué guarda Max de mi tienda y de mis clientes?
>
> Max no copia tu catálogo ni tus pedidos: los lee en WooCommerce cuando
> el agente los necesita. Guarda las claves de la tienda, cifradas, qué
> pedidos corresponden a cada conversación y, de los avisos de tu tienda,
> el número, el estado y las notas para el cliente de cada pedido. Al
> desconectar la tienda, borra las claves y esas notas.

## Sigue con

> [card] [Canales](https://docs.maxagente.com/guias/canales.md)
>
> Conecta WhatsApp o Instagram para que tus clientes le escriban al agente.

> [card] [Publicar versiones](https://docs.maxagente.com/guias/publicar-versiones.md)
>
> Revisa los cambios del borrador y publícalos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.