Saltar al contenido principal

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.
  • Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue Crear un agente.
  • 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.
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.
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.
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 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).
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.
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.
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.
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.
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) 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.

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

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.
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.
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.
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.
No. Cada proveedor admite una sola conexión por agente. Si necesitas conectar tiendas distintas, usa agentes separados.
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.
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.