Saltar al contenido principal
Tu asistente busca productos con su precio y su stock, indica a quienes llaman el estado de su pedido y pasa las solicitudes de cancelación y devolución a tu equipo como notas privadas del pedido. Los pedidos telefónicos son opcionales. El asistente nunca cancela un pedido por su cuenta y no mueve dinero.

Conectar tu tienda

  1. Tu tienda necesita una dirección HTTPS. En WordPress, abre Ajustes → Enlaces permanentes y elige cualquier opción salvo Simple (Plain).
  2. En WooCommerce, abre Ajustes → Avanzado → API REST → Añadir clave. Elige un usuario con el rol de gestor de la tienda y el permiso Lectura para las preguntas, o Lectura/Escritura para las notas de solicitud y los pedidos telefónicos.
  3. Copia la consumer key (empieza por ck_) y el consumer secret (empieza por cs_). WooCommerce muestra el secret una sola vez.
  4. Abre Agent Tools → Marketplace → WooCommerce. Introduce la dirección de la tienda, la consumer key y el consumer secret.
  5. Elige Agregar. La conexión se comprueba antes de guardarla: la clave debe poder leer productos y pedidos. Después asigna la conexión a tu asistente.
Para cambiar más adelante la dirección de la tienda o las claves, elimina la herramienta y vuelve a conectarla.

Qué puede hacer el asistente

Activado por defecto:
  • Buscar productos por nombre o categoría, con precio, stock y variantes. Solo aparecen los productos publicados y visibles en el catálogo. El asistente nunca se inventa un precio.
  • Indicar el estado, el contenido y el total de un pedido, y encontrar los últimos pedidos de quien llama.
  • Dejar una solicitud de cancelación para tu equipo.
  • Dejar una solicitud de devolución o de cambio para tu equipo.
Opcional, se elige en Editar:
  • Pedidos telefónicos.

Privacidad de los pedidos

El número de pedido por sí solo nunca basta. El asistente muestra un pedido cuando se cumple una de estas condiciones:
  • El número de quien llama coincide con el teléfono del pedido, y ningún otro cliente (otra dirección de correo electrónico) usa ese número.
  • Quien llama da la dirección de correo electrónico del pedido o el código postal de entrega.
Si los datos no coinciden, el asistente no revela nada, ni siquiera si el pedido existe. Tras tres respuestas erróneas en una conversación, deja de comprobar durante una hora. Con un número oculto, el asistente pide siempre la dirección de correo electrónico o el código postal. El asistente nunca lee en voz alta direcciones, correos electrónicos, números de teléfono, notas del cliente ni reembolsos.

Solicitudes de cancelación, devolución y cambio

Una solicitud es una nota privada del pedido para tu equipo (el cliente nunca la ve). Incluye un título, el motivo, la comprobación superada, un número de devolución de llamada y una referencia breve. Ejemplo:
  • Las solicitudes de cancelación son posibles mientras el pedido espera el pago, está en espera o se está preparando.
  • Las solicitudes de devolución y de cambio son posibles para pedidos completados. La nota indica los productos y el motivo.
El asistente no cambia nada en el pedido, no crea ningún reembolso ni etiqueta de devolución y no promete nada: decide tu equipo. Cada pedido admite una solicitud por tipo; una segunda solicitud para el mismo pedido no se vuelve a escribir. El título de la nota muestra la marca de tu espacio de trabajo.

Pedidos telefónicos

Los pedidos telefónicos están desactivados por defecto. Actívalos en Editar. El asistente recoge hasta cinco productos simples distintos que haya en stock, además del nombre, el correo electrónico y la dirección de entrega. Lo repite todo y crea el pedido solo cuando quien llama dice que sí. Los productos con variantes no son compatibles.
  • El pedido empieza sin pagar (Pendiente de pago). No se reserva nada antes del pago.
  • WooCommerce envía al cliente el enlace de pago por correo electrónico, como nota del cliente, con el diseño de tu tienda. El asistente nunca lee el enlace ni recoge datos de tarjeta o bancarios.
  • El asistente indica los precios de los productos tal como figuran en tu tienda, sin envío. La página de pago muestra el importe final.
  • El mismo pedido para el mismo correo electrónico en el mismo día se crea una sola vez.
Activa el correo Nota del cliente en WooCommerce → Ajustes → Correos electrónicos; si no, ningún enlace llega al cliente. Si no se puede enviar la nota, el asistente dice que la tienda enviará los datos de pago.

Ajustes

Tres ajustes pertenecen a la conexión:
  • Productos por respuesta: 3, 5 o 10 productos (3 por defecto).
  • Mencionar los productos agotados: indica si los productos agotados aparecen en las respuestas (sí por defecto).
  • Derivar los pedidos telefónicos por encima de: el valor del pedido, en la moneda de tu tienda, a partir del cual el asistente se ofrece a pasar la llamada a tu equipo. 0 significa sin límite.
Para cambiarlos, edita la conexión en Automatizaciones → Conexiones o conecta de nuevo. La selección de herramientas (solicitudes, pedidos telefónicos) se cambia directamente en la herramienta.

Reconocer a quien llama

Cuando el canal facilita el número de quien llama, el asistente recibe antes de la conversación un resumen breve: el nombre, el último número de pedido con su estado y su fecha, y cuántos pedidos están abiertos. Esto ocurre solo cuando exactamente un cliente usa ese número. El asistente no recibe correo electrónico, número de teléfono, dirección ni total. Tu tienda dispone de unos 2,5 segundos para esta consulta. Una tienda lenta la omite, y el asistente pide entonces el número de pedido.

Probar con seguridad

Las solicitudes escriben notas reales en pedidos reales, y los pedidos telefónicos crean pedidos reales sin pagar y envían un correo electrónico real. Prueba con un producto de prueba, tu propio número y tu propio correo electrónico, y elimina después el pedido de prueba.

Canales

Teléfono, chat web, WhatsApp, Messenger y correo electrónico usan las mismas herramientas. Un número coincidente solo confirma un pedido donde el canal facilita el número. En cualquier otro caso, y con un número oculto, el asistente pide el correo electrónico o el código postal.

Automatizaciones

Conecta WooCommerce en Automatizaciones → Conexiones, o importa su conexión de Agent Tools. Cada herramienta está disponible como acción. Una automatización iniciada por una llamada o una conversación de texto (SMS, WhatsApp) conoce el número de la otra persona por esa propia llamada. Las demás ejecuciones (webhook, programación) no tienen a nadie que llame: Estado del pedido necesita allí un correo electrónico o un código postal, y Últimos pedidos de quien llama indica que no hay número disponible. Las acciones de solicitud y de pedido telefónico necesitan un valor Confirmado por quien llama, que solo es verdadero después de que quien llama diga que sí.

API, MCP, CLI & SDK

POST /api/v1/tools/integrations/woocommerce · MCP connect_integration · CLI famulor connect-integration woocommerce · SDK client.api.connectIntegration.
Campos opcionales: products_per_answer, mention_out_of_stock y phone_order_limit.

Solución de problemas

  • «Esta dirección no lleva a la API REST de WooCommerce»: comprueba la dirección de la tienda. Unos enlaces permanentes de WordPress en Simple también lo provocan; elige otra opción en Ajustes → Enlaces permanentes.
  • «La tienda respondió con una página web en lugar de datos»: un plugin de seguridad o un cortafuegos bloquea las solicitudes de la API. Permite las solicitudes a /wp-json/wc/v3/ desde fuera.
  • «WooCommerce rechazó la consumer key o el secret»: la clave se revocó, se eliminó su usuario o la clave no puede leer pedidos. Crea una clave nueva para un gestor de la tienda.
  • Las solicitudes fallan y el registro indica que la clave solo puede leer: una nota de solicitud necesita el permiso Lectura/Escritura.
  • La comprobación de la conexión falla aunque las claves son correctas: algunos hostings eliminan la cabecera Authorization. Pide a tu hosting que la deje pasar. La conexión también intenta una alternativa por sí misma.
  • El número de quien llama no encuentra ningún pedido: la búsqueda de la tienda compara las últimas 8 cifras del número. Si tu tienda guarda los números con espacios, pide en su lugar el número de pedido.
Documentación de la API REST de WooCommerce