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

# Tiendanube

> Conecta tu tienda para que el agente consulte tu catálogo, arme pedidos con el checkout de Tiendanube y siga pagos y envíos

> [!WARNING]
>
> La integración con Tiendanube está en revisión por Tiendanube y todavía no aparece en el catálogo de **Integraciones**. Esta guía describe cómo va a funcionar cuando esté disponible.

La integración con **Tiendanube** le permite a tu agente de Max vender con
el catálogo de tu tienda. El agente consulta productos, precios, stock y
descripciones, manda las fotos que cargaste en cada variante, arma
pedidos que el cliente paga en el checkout de Tiendanube y responde por el
estado del pago y del envío.

## Qué permisos pide

Max pide a Tiendanube solo los permisos que usan sus acciones:

| Permiso | Para qué lo usa Max |
| - | - |
| Editar productos | Buscar productos y consultar precios, variantes y stock. Desde el asistente de Max, ajustas stock y precios. |
| Ver y editar pedidos | Consultar el pago y el estado de un pedido. Desde el asistente de Max, cierras, reabres o cancelas pedidos. |
| Ver y editar pedidos manuales | Crear pedidos borrador con el link de pago de Tiendanube. |
| Ver y editar envíos | Consultar el estado del envío y el código de seguimiento. Desde el asistente de Max, marcas envíos y cargas su seguimiento. |
| Leer contenido | Leer tus páginas publicadas, como la política de devolución, para responder sobre tus políticas. |
| Ver cupones | Verificar el cupón que un cliente dice tener. |
| Ver ubicaciones | Informar tus locales, su dirección y el stock en cada uno. |

El agente que atiende a tus clientes consulta tu catálogo y tus pedidos, y
crea pedidos borrador. Los cambios en productos, pedidos y envíos los pides tú
al asistente (ver [Ajustar stock y precios](#ajustar-stock-y-precios) y
[Actualizar pedidos y envíos](#actualizar-pedidos-y-envíos)).

## Instalar Max en tu tienda

Max se instala desde la **Tienda de Aplicaciones** de Tiendanube o desde
Max. Los dos caminos terminan en la misma conexión.

> [tab] Desde Tiendanube
>
> **1. Acepta los permisos**
>
> En la Tienda de Aplicaciones de Tiendanube, instala Max y acepta los
> permisos.
>
> **2. Continúa en Max**
>
> Tiendanube te lleva a la página "Instalaste Max en" seguida del
> nombre de tu tienda. Toca **Continuar**. Si ya tienes la sesión de
> Max abierta en ese navegador, pasas directo a elegir la organización.
>
> **3. Crea tu cuenta o ingresa**
>
> Ingresa con Google o con un código que te llega por email. El email
> de tu tienda aparece precargado y lo puedes cambiar. Si todavía no
> tienes cuenta en Max, se crea en este paso.
>
> **4. Elige la organización**
>
> Max te muestra el paso a paso. Elige la organización que va a
> atender la tienda o crea una: el nombre de la tienda viene cargado.
>
> Si la tienda ya estaba conectada a una de tus organizaciones, Max
> actualiza la autorización y el botón **Ir a** te lleva a esa
> organización.
>
> **5. Elige el agente**
>
> Elige el agente que va a vender con la tienda y toca **Conectar
> aquí**, o escribe un nombre y toca **Crear agente y conectar**.
>
> **6. Elige las acciones**
>
> Max abre **Integraciones** del agente con la tienda conectada. Indica
> cuándo tiene que usarla, deja marcadas las acciones que necesita y
> toca **Agregar**.
>
> > [!NOTE]
> >
> > Tienes 24 horas desde que aceptas los permisos para terminar la
> > conexión. Si pasa ese plazo, vuelve a instalar Max desde la Tienda
> > de Aplicaciones.

> [tab] Desde Max
>
> **1. Abre la integración**
>
> En la página **Integraciones** de un agente, abre **Tiendanube** y
> toca **Conectar**.
>
> **2. Autoriza en Tiendanube**
>
> Ingresa a tu tienda si Tiendanube lo pide y acepta los permisos.
>
> **3. Listo**
>
> Vuelves a Max con la tienda en **Conectada** y se abre **Nueva
> integración** para dársela al agente. Sigue en [Dársela a un
> agente](#dársela-a-un-agente), desde el paso 2.

Una tienda conectada es una **conexión** de tu organización: la usan todos
los agentes a los que se la des. Cada tienda es una conexión aparte. Para
sumar otra tienda, toca **Agregar cuenta** en la integración de Tiendanube.

## Dársela a un agente

Si instalaste Max desde la Tienda de Aplicaciones, el agente que elegiste ya
tiene la tienda: sigue en el paso 3. Para dársela a otro agente, empieza en
el paso 1. La tienda rige con los clientes desde que publicas.

**1. Elige la tienda**

En la página **Integraciones** del agente, abre Tiendanube y toca **Usar
en este agente**.

**2. Elige las acciones**

Habilita solo las acciones que el agente necesita. Por ejemplo, un
agente que solo responde consultas de productos no necesita crear
pedidos.

**3. Pruébalo**

En **Probar**, pídele al agente un producto, su precio y su stock. Las
conversaciones de prueba usan el borrador del agente y no aparecen en el
Inbox.

**4. Publica**

Toca **Publicar**. Las integraciones del agente rigen desde que
publicas.

> [!WARNING]
>
> Los pedidos que el agente crea en **Probar** son pedidos borrador reales en
> tu tienda de Tiendanube. Si pruebas una compra, el pedido queda en tu
> administrador de Tiendanube con la nota `Max:`.

## Qué puede hacer el agente

Cada **acción** es algo que el agente puede hacer en tu tienda. En **Qué
hace**, cada una aparece con su nombre y una descripción. Su nombre
técnico, como `search_products`, aparece al pasar el cursor. En el Inbox,
cada vez que el agente usa una, la conversación muestra lo que hizo.

| Acción | Qué hace | Cómo aparece en el Inbox |
| - | - | - |
| **Buscar productos en Tiendanube** | Busca en el catálogo publicado por nombre, etiqueta o SKU. Devuelve precio, imágenes, variantes y stock. | Buscó productos en Tiendanube |
| **Consultar un producto y su stock** | Consulta la descripción, la marca, las fotos, el peso, las medidas y el precio y stock por variante de un producto. | Consultó un producto y su stock |
| **Consultar tallas, colores y stock** | Recorre las variantes de un producto que tiene muchas tallas o colores. | Consultó tallas, colores y stock |
| **Armar un pedido con link de pago** | Crea un pedido borrador y le envía al cliente el link de pago de Tiendanube. | Armó un pedido con link de pago |
| **Consultar el checkout del pedido** | Recupera el link de pago de un pedido creado en la conversación y consulta si ya se pagó. | Consultó el checkout del pedido |
| **Consultar el pago y el envío** | Consulta el pago y los envíos de un pedido, con el código y el link de seguimiento. | Consultó el pago y el envío |
| **Buscar el pedido del cliente** | Busca un pedido por el número que ve el cliente. | Buscó el pedido del cliente |
| **Consultar las compras de la conversación** | Lista hasta 10 compras recientes de la conversación, con su estado actualizado. | Consultó las compras de la conversación |
| **Consultar las páginas de la tienda** | Lista tus páginas publicadas, como la política de devolución o cómo comprar. | Consultó las páginas de la tienda |
| **Leer una página de la tienda** | Lee una página para responder con tus políticas. | Leyó una página de la tienda |
| **Verificar un cupón** | Verifica el cupón que dice tener el cliente: si existe, si está vigente y qué descuento da. | Verificó un cupón |
| **Consultar los locales de la tienda** | Lista tus locales con su dirección y, si hace falta, el stock de un producto en cada uno. | Consultó los locales de la tienda |

### Catálogo y stock

* El agente solo ve los productos publicados en tu tienda.
* Los precios y el stock se leen en el momento de la consulta. Si un
  producto tiene precio promocional, el agente usa ese precio.
* Si un producto no tiene el stock gestionado en Tiendanube, Max no le pasa
  una cantidad al agente y el producto se puede pedir sin límite de stock.
* Consultar el stock no lo reserva.

### Crear un pedido

Antes de crear un pedido, el agente confirma con el cliente los productos,
las cantidades y los precios, y le pide nombre, apellido y email. Al
crearlo:

* Max vuelve a verificar en Tiendanube 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 no hay stock suficiente, no
  crea el pedido.
* Los precios son siempre los de tu catálogo. El agente no puede cambiarlos
  ni aplicar descuentos.
* El pedido se crea como **pedido borrador** en Tiendanube, sin pagar. El
  agente le envía al cliente el link del checkout de tu tienda.
* El cliente paga en el checkout de Tiendanube, con los medios de pago que
  tienes configurados ahí.
* Si la conversación tiene el teléfono del cliente, el pedido lo incluye.
* La nota del pedido en Tiendanube empieza con `Max:` seguido de una
  referencia de la compra.

Un pedido borrador no es una venta. El agente da un pedido por pagado solo
cuando Tiendanube informa el pago. Un comprobante que manda el cliente no
alcanza. Max nunca marca un pedido como pagado.

> [!NOTE]
>
> **El envío se elige en el checkout.** El pedido que crea el agente no trae
> envío: en el checkout el cliente pone su código postal y elige entre tus
> medios de envío y puntos de retiro, con el costo y el plazo que calcula
> Tiendanube. El agente no cotiza envíos ni promete envío gratis. Si no
> configuraste ningún medio de envío en **Configuración → Medios de envío**,
> el checkout muestra "Nos comunicaremos para coordinar la entrega".

### Consultar pedidos

El agente consulta el estado del pago y de cada envío: si está en
preparación, despachado, listo para retirar o entregado, con el transportista
y el código de seguimiento cuando la tienda los cargó. Justo después de la
compra, un pedido puede no tener envíos todavía.

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

* El pedido se creó en esa misma conversación.
* El teléfono del pedido es el mismo que el del contacto de la conversación.

Conocer el número de pedido o el email del comprador no alcanza. Si el
pedido no cumple ninguna condición, el agente le pide al cliente que
consulte con una persona de la tienda.

### Aviso de pago

Cuando Tiendanube confirma el pago de un pedido de esa conversación (lo
armó el agente o el cliente lo consultó ahí), porque el cliente pagó en el
checkout o tú marcaste el pago como recibido, el agente
le escribe al cliente en esa conversación para avisarle que recibieron su
pago y el siguiente paso según el envío que eligió. Avisa una sola vez por
pedido y solo si el cliente escribió en las últimas 23 horas.
Si el agente no puede escribirle, porque pasó ese plazo o la IA está
apagada en la conversación, el aviso queda para tu equipo en el Inbox: la
conversación muestra la tarjeta **No pudo avisarle al cliente** y vuelve a
no leída.

### Políticas, cupones y locales

* **Políticas:** si un cliente pregunta por cambios, devoluciones o cómo
  comprar, el agente lee tus páginas publicadas en Tiendanube y responde con
  lo que dicen, sin agregar condiciones. Mantenlas al día en **Tienda online
  → Páginas**.
* **Cupones:** si un cliente dice que tiene un cupón, el agente verifica ese
  código exacto: si existe, si está vigente y qué descuento da. El descuento
  se aplica en el checkout. El agente nunca muestra ni sugiere otros cupones.
* **Locales:** el agente informa los locales cargados en **Configuración →
  Centros de distribución**, con su dirección y el stock de un producto en
  cada uno. No promete retiro en el local: Tiendanube no indica qué locales
  ofrecen retiro, así que le dice al cliente que en el checkout ve los puntos
  de retiro de tu tienda y su costo.

Si instalaste Max antes de que pidiera estos permisos, estas consultas
responden que falta el permiso. Reinstala Max desde la Tienda de
Aplicaciones para habilitarlas.

## Ajustar stock y precios

Puedes pedirle al asistente de Max que actualice el stock, el precio o el
precio promocional de una variante. Por ejemplo: "Actualiza el stock de la
Mochila Urbana negra: ahora tengo 22 unidades". El asistente busca el
producto, te dice el valor actual y te pide confirmación antes de cambiarlo
en Tiendanube.

El asistente cambia stock y precios. Nombres, descripciones y visibilidad se
editan en Tiendanube.

## Actualizar pedidos y envíos

También puedes pedirle al asistente de Max que actualice un pedido por su
número:

* **Envío:** marcarlo como empaquetado, enviado, listo para retirar o
  entregado, y cargar el código y el link de seguimiento. Por ejemplo: "Marca
  el pedido 1234 como enviado, el código de Andreani es AB123". Tiendanube le
  avisa al cliente por email.
* **Estado:** cerrar, reabrir o cancelar el pedido. Para cancelar, el
  asistente te pregunta el motivo, si avisarle al cliente y si devolver los
  productos al stock.

El asistente te muestra el pedido y te pide confirmación antes de cambiarlo.
El pago recibido se marca desde el administrador de Tiendanube.

Si instalaste Max antes de que pidiera estos permisos, el asistente responde
que la tienda no aceptó el permiso para ese cambio. Reinstala Max desde la
Tienda de Aplicaciones para habilitarlos.

## Cobros

Todos los cobros se hacen en el checkout de Tiendanube. En una organización
conectada a Tiendanube, Mercado Pago no se puede agregar, y el agente no
genera links de pago por fuera de tu tienda. Si ya lo tenías conectado, la
cuenta sigue en la lista para que la desconectes, pero tus agentes dejan de
usar sus acciones.

Tu plan de Max lo cobra Max, no Tiendanube. El plan se elige y se cambia en
**Settings → Planes y facturación**.

## Solicitudes de datos de tus clientes

Las leyes de protección de datos personales permiten que un cliente de tu
tienda pida una copia de sus datos o que se borren. El cliente hace el pedido
a Tiendanube, y Tiendanube se lo pasa a Max.

* **Pedido de copia:** Max arma un informe con los datos que guarda de ese
  cliente (contactos, conversaciones y pedidos vinculados). Lo descargas desde
  **Integraciones** de tu agente, en **Solicitudes de datos de Tiendanube**, y
  se lo entregas al cliente.
* **Pedido de borrado:** Max busca al cliente por email y por teléfono en tus
  contactos. Borra el contenido de sus conversaciones, de cualquier canal, y
  sus datos personales, y cancela sus seguimientos programados. No hace falta
  que hagas nada.

## Desinstalar

Max se desinstala desde el administrador de Tiendanube, en
**Aplicaciones**, con **Desinstalar**.

Al desinstalar, Max borra:

* Las credenciales y los datos de tu tienda.
* Las conversaciones en las que el agente usó una acción de Tiendanube.
* Las referencias a pedidos.

Max no borra tu organización, tus agentes, tus contactos ni las
conversaciones que no usaron Tiendanube.

La tienda sigue en **Integraciones** del agente con el estado **Error**, el
aviso "Max se desinstaló de esta tienda en Tiendanube" y el botón
**Conectar**. Los agentes que la usaban dejan de poder ejecutar sus
acciones, también en sus versiones publicadas.

Para volver, toca **Conectar** o instala Max otra vez desde la Tienda de
Aplicaciones. La tienda vuelve a la misma conexión y los agentes que la
tenían siguen funcionando sin volver a configurarlos.

## Problemas frecuentes

| Qué ves | Qué pasa | Qué hacer |
| - | - | - |
| La tienda está en **Error** con "Max se desinstaló de esta tienda en Tiendanube" | Max se desinstaló desde Tiendanube. | Toca **Conectar** en Integraciones del agente o instala Max otra vez. |
| La tienda está en **Error** con "Tiendanube suspendió el acceso por un pago pendiente de la tienda o de la aplicación" | Tiendanube suspendió la tienda o la aplicación por un pago pendiente. | Regulariza el pago en Tiendanube. |
| "La instalación venció antes de conectar la tienda" o "No pudimos terminar de preparar la tienda" | Pasaron más de 24 horas o la instalación falló. | Vuelve a instalar Max desde la Tienda de Aplicaciones. |
| "Autorizaste otra cuenta" al reconectar | Autorizaste una tienda distinta de la conectada. | Para sumar esa tienda, usa **Agregar cuenta**. |
| El agente dice que la tienda tiene que verificar un pedido | Tiendanube no confirmó si el pedido se creó. El agente no lo repite para no duplicarlo. | Busca en las notas de tus pedidos de Tiendanube la referencia que empieza con `Max:`. |

## Preguntas frecuentes

> [accordion] ¿Max modifica mi catálogo, mis precios o mi stock?
>
> El agente que atiende a tus clientes no: lee productos, precios y stock,
> y lo único que crea en tu tienda son pedidos borrador, con los precios de
> tu catálogo. Solo cambian stock o precios cuando tú se lo pides al
> asistente de Max, y te pide confirmación antes.

> [accordion] ¿Max cobra por mi cuenta?
>
> No. El cliente paga en el checkout de tu tienda de Tiendanube, con tus
> medios de pago. Max no genera cobros por fuera de Tiendanube ni marca
> pedidos como pagados.

> [accordion] ¿Qué pasa con el envío?
>
> El cliente lo elige en el checkout de tu tienda, con tus medios de envío
> y puntos de retiro: pone su código postal y ve el costo y el plazo. El
> agente no cotiza envíos. Si no tienes medios de envío configurados, el
> checkout muestra "Nos comunicaremos para coordinar la entrega".

> [accordion] ¿El agente reserva el stock?
>
> No. El agente verifica el stock al consultar y otra vez al crear el
> pedido, pero no lo reserva. Si otro cliente compra antes, el stock puede
> agotarse antes del pago.

> [accordion] ¿Puedo conectar varias tiendas?
>
> Sí. Cada tienda es una conexión aparte de tu organización. En
> **Integraciones** de un agente, abre Tiendanube y toca **Agregar
> cuenta**, o instala Max
> desde la Tienda de Aplicaciones de la otra tienda. Después eliges qué
> tienda usa cada agente.

> [accordion] ¿Qué pasa si desinstalo Max?
>
> Max borra las credenciales y los datos de la tienda, y las
> conversaciones en las que se usó una acción de Tiendanube. Tu
> organización, tus agentes y el resto de las conversaciones se conservan.
> Si reinstalas o tocas **Conectar**, los agentes vuelven a usar la
> tienda sin configurarlos de nuevo.

> [accordion] ¿Tiendanube me cobra el plan de Max?
>
> No. El plan de Max lo cobra Max. Lo eliges y lo cambias en **Settings →
> Planes y facturación**.

## Soporte

Si tienes un problema con la integración, escribe a
[maxagenteok@gmail.com](mailto:maxagenteok@gmail.com).

## 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)
>
> Las integraciones del agente rigen desde que publicas.


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