> ## 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. # WooCommerce > Cómo conectar tu tienda WooCommerce a un agente de ChatNorris para consultar pedidos verificados y responder precio y stock en vivo, e importar el catálogo y las variaciones de producto a la base de conocimiento. # WooCommerce Con la integración de WooCommerce, tu agente de ChatNorris responde sobre los pedidos y el inventario de tu tienda sin salir del chat. Según lo que actives, el agente: * informa el estado, el total y los ítems de un pedido, solo después de verificar que es del visitante; * busca productos (por SKU o por nombre) y responde la disponibilidad y el precio en ese momento; * usa tu catálogo de productos y sus variaciones (talla, color, medida) como fuente de conocimiento para responder preguntas generales. 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 WooCommerce con la REST API habilitada y acceso al panel de WordPress para generar las claves de la API (Consumer key y Consumer secret). * Rol **Owner** o **Admin** en tu organización de ChatNorris. ## Conectar WooCommerce Cada agente se conecta a una tienda WooCommerce. La conexión se hace una sola vez en **Integraciones** y la usan tanto la Acción WooCommerce como la fuente de conocimiento WooCommerce. **1. Genera las claves de la API en WooCommerce** En el panel de WordPress, abre **WooCommerce → Configuración → Avanzado → API REST** y genera una clave. Copia el **Consumer key** y el **Consumer secret**. **2. Abre el hub de Integraciones del agente** En ChatNorris, entra a `Agentes → [tu agente] → Integraciones` y elige **WooCommerce**. **3. Completa los datos y conecta** Ingresa la **URL de la tienda**, el **Consumer key** y el **Consumer secret**, y haz clic en **Conectar**. **4. Prueba la conexión** Usa **Probar conexión** para confirmar que las credenciales funcionan antes de usarlas en la Acción o en la fuente de conocimiento. Las claves se guardan cifradas: en el hub solo se ven sus últimos 4 caracteres. Si rotas las claves en WooCommerce, usa **Reemplazar clave** en el menú **···** de la fila; la conexión sigue siendo la misma, así que la Acción y la fuente que la usan no se tocan. > [!TIP] > > ChatNorris solo lee pedidos y productos de tu tienda: no crea ni modifica nada en WooCommerce. ## Configurar la Acción Conectar la tienda no activa nada todavía. Para elegir qué puede consultar el agente: **1. Crea la Acción WooCommerce** Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **WooCommerce**. Si todavía no conectaste la tienda, la pantalla te lleva directo a **Integraciones**. **2. Elige qué datos puede consultar el agente** En **Acceso a datos** (ver la tabla de abajo). **3. Configura la verificación de pedidos** Con **Verificación de orden** activa, el agente exige el número de orden más al menos uno de estos datos antes de mostrar información: **Email de facturación**, **Teléfono de facturación** o **Código postal de facturación**. **4. Habilita la Acción y guarda** Activa **Habilitado** en la sección **General** y guarda. Desde ese momento, el agente usa tu tienda en todas sus conversaciones. | Capacidad | Qué hace | | - | - | | **Órdenes** | Consulta el estado, el total y los ítems de una orden, solo después de verificar la identidad del comprador. | | **Inventario** | Busca productos por SKU o por nombre y responde la disponibilidad y el precio de ese momento. | | **Datos de cliente** | Reservado para uso futuro. Mantenlo apagado: por ahora no hace nada aunque lo actives. | > [!WARNING] > > **Se recomienda Claude Sonnet o superior** como modelo principal del agente (**Configuración → IA**). La acción revela datos de una orden solo después de verificarla, y en pruebas Haiku a veces responde como si los datos ya estuvieran confirmados aunque no lo estén. El formulario de la acción muestra este aviso con un enlace a la configuración de IA. > [!NOTE] > > **Una sola tienda por agente.** Un agente puede tener una sola tienda activa para consultar pedidos y stock (por ejemplo WooCommerce u Odoo). Si intentas habilitar una segunda, ChatNorris te pide apagar primero la consulta de pedidos y de stock de la otra. [Odoo](https://docs.chatnorris.ai/guias/odoo.md) puede seguir activo para leads y tickets junto a una tienda WooCommerce. ### Cómo consulta una orden el visitante En el **widget web**, cuando el agente detecta que el visitante quiere el estado de una orden, no le pide los datos por texto: le muestra un **formulario embebido** dentro del chat con dos campos — **Número de orden** y **Email o teléfono de la compra**. El formulario y la respuesta se muestran en el idioma del widget (español, inglés o portugués), y es el mismo para WooCommerce y Odoo. Mientras el formulario está pendiente, el visitante no puede escribir otro mensaje hasta completarlo o cancelarlo. * Si los datos coinciden con una orden real, el agente responde con el estado, total e items. * Si no coinciden, el agente indica que no pudo verificar la orden y pide revisar el número y el dato de contacto — nunca muestra información sin verificar. * Una orden que no existe y un dato que no coincide reciben la misma respuesta, para que nadie pueda adivinar números de orden. Tras 5 intentos fallidos en la misma conversación, la consulta de órdenes se bloquea. En **WhatsApp** e **Instagram** (donde no hay formularios embebidos), el agente pide estos mismos datos de forma conversacional, dentro del chat de texto. ### Consulta de precio y stock Con **Inventario** activo, el agente consulta la tienda cada vez que va a hablar del precio o el stock de un producto, aunque ya lo haya consultado antes en la conversación: el precio y la disponibilidad salen de tu tienda en ese momento, no de la base de conocimiento. Si el visitante pide una recomendación sin nombrar un producto ("¿qué me recomiendas para 5 personas?"), el agente consulta el catálogo en vivo y le propone una o dos opciones concretas con su precio, evitando las que están agotadas. Con la Acción activa, la lista de fuentes de **Conocimiento** muestra además la fila informativa **Catálogo de WooCommerce en vivo**, con la etiqueta **En vivo** y el link **Ver acción**. No es una fuente: indica que el agente consulta precio y stock directo en la tienda en cada conversación, así que no ocupa caracteres ni necesita sincronizarse. ## Importar el catálogo a la base de conocimiento Puedes traer el catálogo de productos de tu tienda WooCommerce a la base de conocimiento como una fuente más, para que el agente responda preguntas generales sobre productos (no solo disponibilidad puntual). Solo necesitas la tienda conectada en **Integraciones**: no hace falta tener activa la Acción WooCommerce, que se configura por separado (consulta de pedidos y stock). **1. Abre la fuente WooCommerce** Ve a `Agentes → [tu agente] → Conocimiento → Agregar fuente` y elige **WooCommerce**. Si la tienda todavía no está conectada, haz clic en **Conectar en Integraciones**: ahí cargas la URL de la tienda y las claves de la API de WooCommerce, una sola vez por agente. **2. Haz clic en Sincronizar catálogo** Con la tienda conectada, vuelve a la fuente WooCommerce y haz clic en **Sincronizar catálogo** (o **Resincronizar** si ya habías traído el catálogo antes). También puedes hacerlo desde la sección **Base de conocimiento** de la pantalla de configuración de la Acción WooCommerce. **3. Espera el procesamiento** Se traen hasta 2.000 productos publicados. Por cada uno se indexa: nombre, SKU, precio, disponibilidad (en stock / agotado) y descripción. Pasa por el mismo pipeline de procesamiento que cualquier otra fuente (Pendiente → Procesando → Listo). > [!TIP] > > Si además tienes la Acción WooCommerce activa para consultar pedidos o stock, sincroniza también el catálogo para que el agente responda preguntas generales de productos. > [!NOTE] > > Esta fuente aparece con su propio filtro **WooCommerce** en la tabla de la base de conocimiento, y no tiene botón **Editar** — el contenido se genera automáticamente desde tu tienda, no se edita a mano. > [!WARNING] > > La sincronización del catálogo es manual: no hay auto-sync para esta fuente. Si cambian precios, stock o productos en tu tienda, vuelve a hacer clic en **Sincronizar catálogo** para actualizar la base de conocimiento. > [!TIP] > > Esto es distinto de la consulta de inventario en tiempo real de la Acción WooCommerce: el catálogo sincronizado sirve para preguntas generales sobre productos ("¿qué poleras tienen?"), mientras que la Acción consulta el stock y el precio puntual al momento de la conversación. ### Variaciones de producto (talla, color, etc.) Si tu tienda tiene **productos variables** (por ejemplo, una polera con distintas tallas y colores), en el mismo panel encontrarás **Variaciones de productos**. Con **Generar variaciones** se crea un mapa de atributos (medida, color, etc.) a SKU para todos los productos con variaciones, así el agente puede responder preguntas por características sin depender solo de la consulta en vivo. Con **Ver contenido generado** revisas el resultado y con **Descargar .txt** lo descargas. Este contenido se regenera en cada sincronización y no se edita: si necesitas correcciones, agrégalas en una fuente de texto aparte. A diferencia del catálogo, las variaciones se vuelven a sincronizar solas con la frecuencia de tu plan: semanal en Standard y diaria en Premium. > [!NOTE] > > Un agente usa una tienda por API o por sitio público, no las dos. Si ya tiene la Acción WooCommerce con consulta de pedidos o stock activa, el panel de la fuente [Tienda online (sitio público)](https://docs.chatnorris.ai/guias/knowledge-base.md#tienda-online-sitio-público) te avisa y te lleva a **Acciones**. ## Créditos Conectar y probar la tienda no consume créditos. Cada respuesta del agente que consulta tu tienda en vivo (pedidos, o precio y stock) suma **0,5 crédito de IA** al costo normal de la respuesta, una sola vez por respuesta. Las pruebas en el Playground no suman este cargo. El catálogo y las variaciones importadas ocupan caracteres de tu base de conocimiento como cualquier otra fuente. Ver [Modelos de IA y créditos](https://docs.chatnorris.ai/guias/modelos-ia-creditos.md). ## Pausar o desconectar * **Pausar:** apaga el interruptor **Activa** de la fila de WooCommerce en **Integraciones**. Las credenciales se conservan, pero la Acción no puede consultar la tienda y la fuente de conocimiento no se sincroniza; el contenido ya indexado se sigue usando. Vuelve a encender el interruptor para reanudarla. * **Desconectar:** desde el menú **···** o el detalle de WooCommerce, haz clic en **Desconectar**. Antes de confirmar, ChatNorris te muestra qué depende de la conexión. La Acción WooCommerce se apaga, pero su configuración se conserva; la fuente de conocimiento se desactiva, pero el contenido ya indexado se conserva. Las claves se borran de ChatNorris. Para volver a usar la Acción y la fuente, conecta la tienda de nuevo y reactívalas. Si ya no vas a usar las claves, revócalas en **WooCommerce → Configuración → Avanzado → API REST**. ## Preguntas frecuentes > [accordion] ¿WooCommerce funciona con cualquier tienda? > > Necesitas una tienda WooCommerce con la REST API habilitada y credenciales (Consumer key y Consumer secret) generadas desde el panel de WordPress. Usa **Probar conexión** en Integraciones para confirmar que todo está bien configurado. > [accordion] ¿El formulario de consulta de orden aparece en WhatsApp e Instagram también? > > No, el formulario embebido es exclusivo del widget web. En WhatsApp e Instagram el agente pide el número de orden y el dato de verificación conversacionalmente, dentro del chat de texto. > [accordion] ¿El catálogo de productos se actualiza solo? > > No. La sincronización del catálogo a la base de conocimiento es manual — haz clic en **Sincronizar catálogo** cada vez que quieras traer los cambios de precio, stock o productos nuevos. Las variaciones sí se re-sincronizan solas con la frecuencia de tu plan, y el precio y el stock que responde la Acción siempre salen de la tienda en vivo. > [accordion] Ya tenía WooCommerce conectado desde la propia Acción, ¿tengo que reconectar? > > No. Las conexiones existentes se migraron automáticamente al hub de Integraciones — las vas a encontrar ya conectadas ahí. Solo necesitas reconectar si la conexión aparece como **Requiere atención**. > [accordion] ¿Puedo conectar dos tiendas WooCommerce en el mismo agente? > > No. Cada proveedor admite una sola conexión por agente. Si necesitas conectar tiendas distintas, usa agentes separados. > [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. Ver [Jumpseller](https://docs.chatnorris.ai/guias/jumpseller.md). > [accordion] ¿Puedo usar Laudus y WooCommerce en el mismo agente? > > Sí, con una condición: precios y stock salen de una sola de las dos. Lo habitual es dejar en Laudus el stock y precio, y en WooCommerce la consulta de pedidos. Si importas los dos catálogos a la base de conocimiento, el agente ve los productos dos veces: deja activo solo uno. Ver [Laudus](https://docs.chatnorris.ai/guias/laudus.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.