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

# Jumpseller

> Cómo conectar tu tienda Jumpseller a un agente de ChatNorris para responder precio y stock en vivo, consultar pedidos verificados, armar la compra con links al carrito, confirmar el pago en el chat e importar el catálogo a la base de conocimiento.

# Jumpseller

Con la integración de Jumpseller, tu agente de ChatNorris atiende a los clientes de tu tienda con los datos reales de la tienda. Según lo que actives, el agente:

* busca productos y variantes (por nombre o SKU) y responde el precio y el stock en ese momento;
* cuenta el estado de pago y despacho de un pedido, solo después de verificar que es del visitante;
* arma la compra y entrega un link por producto que lo agrega al carrito de tu tienda;
* confirma el pago en la misma conversación cuando el visitante paga;
* usa el catálogo de tu tienda como fuente de conocimiento (descripciones, variantes y links a las fichas).

Funciona en el widget web, WhatsApp, Instagram, Messenger, Telegram, Email y la API.

## Requisitos

* Una cuenta de ChatNorris con plan **Standard** o **Premium**. Puedes ver los planes en [chatnorris.ai/pricing](https://chatnorris.ai/pricing).
* Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue [Crear un agente](https://docs.chatnorris.ai/guias/crear-agente-wizard.md).
* Una tienda Jumpseller y acceso a su admin para copiar el login y el token de la API.
* Rol **Owner** o **Admin** en tu organización de ChatNorris.

## Conectar la tienda

Cada agente se conecta a una tienda Jumpseller.

**1. Copia el login y el token de la API**

En el admin de tu tienda Jumpseller, abre **Cuenta › Preferencias**. En la tarjeta **API y MCP**, copia el **login** y, con **Mostrar token**, el **token**.

**2. Abre el hub de Integraciones del agente**

En ChatNorris, entra a `Agentes → [tu agente] → Integraciones` y elige **Jumpseller**.

**3. Pega las dos claves y conecta**

Pega el login y el token y haz clic en **Conectar**. ChatNorris prueba las claves con Jumpseller antes de guardarlas: si no sirven, te dice por qué y no guarda nada.

> [!WARNING]
>
> La cuenta dueña del token necesita los permisos de **productos**, **pedidos**, **hooks** y **configuración**. Si usas un usuario dedicado, revisa que los tenga. Sin el permiso de hooks no se puede activar la confirmación de pago.

El login y el token se guardan cifrados y nunca se muestran en el dashboard. Con **Probar conexión** vuelves a verificarlos cuando quieras.

## Configurar la Acción

Conectar la tienda no activa nada todavía. Para elegir qué hace el agente:

**1. Crea la Acción Jumpseller**

Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **Jumpseller**.

**2. Elige las capacidades**

Activa las que quieras (ver la tabla de abajo). Algunas dependen de otras.

**3. Activa la Acción y guarda**

Desde ese momento, el agente usa tu tienda en todas sus conversaciones.

| Capacidad | Qué hace |
| - | - |
| **Consultar productos, precio y stock** | Busca productos y variantes por nombre o SKU y responde el precio y las unidades en stock de ese momento. También puede contar qué hay en la tienda cuando el visitante pregunta en general. |
| **Consultar pedidos** | El visitante da el número de pedido (por ejemplo, 1001) y el agente informa el estado de pago y de despacho, con el número de seguimiento si existe, después de verificar que el pedido es suyo. |
| **Armar compra** | Arma la lista de compra con precio y stock en vivo y entrega un link por producto que lo agrega al carrito con la cantidad pedida. Requiere la consulta de productos. |
| **Confirmación de pago** | Cuando el visitante paga en tu tienda, el agente se lo confirma en la misma conversación. Requiere Armar compra. |

> [!NOTE]
>
> Un agente usa una sola tienda. Además, **Armar compra** no se puede activar si el agente ya vende con la [Acción Pago](https://docs.chatnorris.ai/guias/acciones.md), y al revés: un agente arma compras desde una sola fuente.

### Consulta de pedidos

En **Verificación del comprador** eliges con qué dato el visitante demuestra que el pedido es suyo: el email de la compra (por defecto), el teléfono o el código postal de facturación. Basta con que coincida uno.

> [!TIP]
>
> El checkout de Jumpseller no pide teléfono ni código postal por defecto. Actívalos solo si tu tienda los exige al comprar (Configuración › Checkout): si el pedido no los tiene, la verificación con ese dato falla.

Para proteger los datos de tus clientes:

* un pedido que no existe y un dato que no coincide reciben exactamente la misma respuesta, para que nadie pueda adivinar números de pedido;
* tras 5 intentos fallidos en la misma conversación, la consulta de pedidos se bloquea;
* en el widget web, el agente muestra un formulario para el número de pedido y el dato de verificación.

> [!WARNING]
>
> Para esta capacidad recomendamos **Claude Sonnet o superior** como modelo del agente (`Configuración → IA`). En nuestras pruebas, los modelos más chicos a veces responden como si el pedido ya estuviera verificado.

### Armar compra

Cuando el visitante dice qué quiere, el agente arma la lista con las cantidades, el precio de cada producto y un total de referencia, revisando el stock en ese momento. Si falta un dato (por ejemplo, la talla), lo pregunta antes de agregarlo.

Al confirmar, el agente responde con un link por producto. Cada link agrega ese producto al carrito de tu tienda con la cantidad pedida. El visitante los abre uno tras otro **en el mismo navegador**, así se suman en el mismo carrito, y paga en tu checkout de Jumpseller, donde se calcula el envío.

* Jumpseller no tiene un link con varios productos a la vez: por eso va un link por producto.
* Si en ese momento la tienda tiene menos unidades que las pedidas, ese link no agrega el producto. El agente se lo avisa al visitante.
* ChatNorris no cobra ni crea pedidos: la venta ocurre en tu tienda, con tus medios de pago.
* En **Conversaciones**, una nota interna muestra la lista que armó el agente.

### Confirmación de pago

Al activarla, ChatNorris registra en tu tienda un aviso de pagos (webhook `order_paid`). Cuando se paga un pedido, ChatNorris lo une a la conversación si se cumplen las tres condiciones:

1. el email del comprador es el email que el visitante dejó en el chat (por ejemplo, en el Lead Form);
2. el agente le mandó links de compra en los últimos 7 días;
3. el pedido tiene al menos uno de los productos de esa lista.

Si se cumplen, el agente escribe en la conversación «¡Recibimos tu pago! Tu pedido quedó confirmado», queda una nota interna con lo que se cobró y, si la conversación la atendía el agente, pasa a **Resuelta**.

> [!NOTE]
>
> Si el visitante no dejó su email en el chat, o pagó con otro email, la venta se registra igual en tu tienda, pero el agente no la confirma en la conversación.

Al apagar la capacidad, eliminar la Acción o desconectar la tienda, ChatNorris borra el aviso de pagos que creó. Es lo único que ChatNorris crea en tu tienda: no crea ni modifica productos ni pedidos.

## Importar el catálogo a la base de conocimiento

Con la tienda conectada, puedes sumar tu catálogo como fuente de conocimiento para que el agente responda sobre descripciones, materiales o características de cada producto, con el link a su ficha.

**1. Agrega la fuente**

Entra a `Agentes → [tu agente] → Conocimiento → Agregar fuente` y elige **Jumpseller**.

**2. Importa el catálogo**

Haz clic en **Importar catálogo**. Se importan los productos disponibles de tu tienda.

* Cada producto queda como un documento con su nombre, marca, categorías, descripción, variantes con SKU y el link a su ficha.
* **No se guardan precios ni stock**: el agente los consulta en vivo con la Acción Jumpseller, así nunca responde un precio viejo.
* La fuente se vuelve a sincronizar sola con la frecuencia de tu plan (semanal en Standard, diaria en Premium). Con **Volver a importar** la actualizas cuando quieras.

Con la Acción activa, la lista de fuentes muestra además la fila **Catálogo de Jumpseller en vivo**. No es una fuente: indica que el agente consulta precio y stock directo en la tienda.

## Créditos

Conectar la tienda no consume créditos. Cada respuesta del agente que consulta tu tienda en vivo (productos, precio y stock, o pedidos) suma **0,5 crédito de IA** al costo normal de la respuesta. El catálogo importado ocupa caracteres de tu base de conocimiento como cualquier otra fuente.

## Desconectar

En `Agentes → [tu agente] → Integraciones → Jumpseller`, haz clic en **Desconectar**. La Acción Jumpseller se apaga y conserva su configuración, y ChatNorris borra el aviso de pagos si lo había creado. Si ya no vas a usar el token, reinícialo en **Cuenta › Preferencias** de tu tienda.

## Preguntas frecuentes

> [accordion] El agente dice que no encuentra un producto que sí existe
>
> El agente solo ve los productos **disponibles** de tu tienda. Revisa en Jumpseller que el producto no esté deshabilitado. Si buscas por SKU, revisa que el SKU esté cargado en el producto o en la variante.

> [accordion] El visitante abrió los links pero el carrito quedó vacío o incompleto
>
> Cada link agrega un producto solo si hay stock suficiente en ese momento. También tiene que abrirlos en el mismo navegador: si abre uno en el teléfono y otro en el computador, quedan en carritos distintos.

> [accordion] El visitante pagó y el agente no se lo confirmó
>
> Revisa que el email con que pagó sea el mismo que dejó en el chat, que los links se hayan enviado hace menos de 7 días y que el pedido incluya al menos un producto de la lista. También que la capacidad **Confirmación de pago** siga activa.

> [accordion] No puedo activar la confirmación de pago
>
> El mensaje «No se pudo registrar el aviso de pagos en Jumpseller» significa que la cuenta dueña del token no tiene el permiso de **hooks**. Agrégalo en Jumpseller, haz clic en **Probar conexión** y vuelve a activarla.

> [accordion] La integración aparece como vencida
>
> Jumpseller rechazó las claves guardadas, por ejemplo porque se reinició el token. Copia el token nuevo y pégalo en la integración con **Reemplazar credenciales**.

> [accordion] ¿Puedo usar Jumpseller y WooCommerce en el mismo agente?
>
> No. Un agente usa una sola tienda para no responder dos precios distintos del mismo producto. Si tienes dos tiendas, crea un agente para cada una.


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