Generador de Contenido AI para WooCommerce — Guía de Usuario

Versión 1.1.1 | Requiere WordPress 5.0+ | Requiere WooCommerce 4.0+ | PHP 7.4+

Descripción General

El Generador de Contenido AI para WooCommerce te permite generar imágenes de productos, descripciones, marcas y etiquetas usando IA — y gestionar tu tienda a través de un chatbot integrado o cualquier agente de IA compatible con MCP (Claude Desktop, Cursor, Claude Code y otros).

El plugin soporta varios proveedores de IA:

OpenAI — los modelos OpenAI más recientes disponibles (modelos de texto e imagen según lo ofrezca tu conector)
Google Gemini — los modelos Gemini más recientes disponibles
Anthropic (Claude) — los modelos Claude más recientes disponibles (solo texto; sin generación de imágenes)

Requisitos del Sistema

WordPress 5.0 o superior (Se requiere WordPress 6.9+ para las características de MCP / agentes de IA)
WooCommerce 4.0 o superior
PHP 7.4 o superior
Al menos un proveedor de IA configurado (ver Configuración de la Clave API a continuación)

Instalación

Sube la carpeta del plugin a /wp-content/plugins/, o instálalo directamente desde el directorio de plugins de WordPress.
Actívalo a través de Plugins › Plugins instalados.
Ve a WooCommerce › Generador de Contenido AI para completar la configuración.

Configuración de la Clave API

Tienes dos formas de proporcionar las credenciales de IA. Puedes usar una o ambas.

Opción A — WordPress AI Connectors (recomendado)

WordPress 7.0+ incluye una página de configuración de AI Connectors en Ajustes › IA. Ingresa tu clave de OpenAI, Google o Anthropic allí. El plugin detecta cualquier proveedor configurado automáticamente y muestra solo los modelos disponibles de tus conectores activos. No es necesario ingresar la clave de forma individual en el plugin.

Opción B — Clave API de OpenAI Personalizada

Visita platform.openai.com/api-keys y crea una clave secreta.
En la configuración del plugin, habilita Usar clave API personalizada y pega tu clave.
Solo los modelos de OpenAI estarán disponibles a través de esta ruta.

Nota: OpenAI cobra por token. Consulta openai.com/api/pricing para las tarifas actuales. La generación de imágenes se cobra por imagen.

Selección de Modelo

Una vez que se haya configurado un proveedor, ve a WooCommerce › Generador de Contenido AI › Modelos de IA. Puedes elegir un modelo diferente para cada función: descripción, descripción corta, marcas, etiquetas, generación de imágenes y chatbot. Solo se muestran los modelos de tus proveedores activos.

Características

1. Generación de Contenido de Producto

Abre cualquier producto en el editor de WooCommerce. Encontrarás botones de generación junto a los campos relevantes:

Descripción y Descripción Corta — haz clic en Generar junto al editor de descripción. Elige un tono de escritura: Formal y Profesional, Casual y Amigable, Persuasivo y Orientado a Ventas, Técnico y Detallado, Lujo y Premium, o Creativo y Atractivo. Previsualiza el resultado antes de aplicarlo. Regenera tantas veces como sea necesario.
Marcas y Etiquetas — se generan a partir del nombre del producto y los atributos existentes. Las sugerencias aparecen como chips en los que se puede hacer clic; selecciona lo que deseas y aplícalo en lote.
Imagen Destacada — haz clic en Generar Imagen Destacada en la caja meta de la barra lateral. Se generan múltiples opciones; haz clic en Usar como Destacada en la que desees.
Imágenes de Galería — haz clic en Generar Imágenes de Galería. Selecciona imágenes con las casillas de verificación y agrégalas a la galería con un solo clic.

Consejo: Completa el título del producto, la categoría y al menos algunos atributos antes de generar — la IA usa esta información para producir contenido relevante.

2. Insignia de IA (AI Badge)

Cuando el contenido se genera y se aplica, puedes marcarlo como generado por IA. Se mostrará una pequeña insignia en la página del producto para que los clientes sepan que el contenido fue asistido por IA. Personaliza el texto de la insignia en WooCommerce › Generador de Contenido AI › Insignia de IA.

3. Chatbot de la Tienda

El plugin incluye un chatbot de IA completamente integrado que aparece como una burbuja flotante en tu tienda.

Chatbot para clientes — responde preguntas de los clientes sobre productos, pedidos, envíos y políticas de la tienda. Requiere que los clientes hayan iniciado sesión por defecto; puedes habilitar el acceso de invitados en la configuración.
Chatbot de administrador — un chatbot separado disponible para los gerentes de la tienda y administradores en las páginas de administración de WooCommerce. Puede realizar acciones de gestión de la tienda directamente: crear productos, generar contenido, gestionar cupones, actualizar el estado de los pedidos, y más.

Configura el chatbot en WooCommerce › Generador de Contenido AI › Chatbot:

Habilita/deshabilita el chatbot de cliente y el chatbot de administrador de forma independiente.
Establece el nombre del chatbot, la URL de la imagen del avatar y el esquema de colores.
Escribe un mensaje de bienvenida personalizado y un texto de marcador de posición (placeholder) para la entrada.
Elige el modelo de IA utilizado para las respuestas del chat.
Configura la retención del historial de chat (días).

El chatbot de administrador incluye una función de importación CSV que te permite importar datos de productos de forma masiva. Esto requiere el plugin Product Import Export for WooCommerce. Proporciona un archivo CSV con información de productos, y el chatbot creará productos en borrador para tu revisión.

Si el plugin Print Invoices, Packing Slips, Delivery Notes & Shipping Labels está activo, el chatbot de administrador también puede solicitar enlaces de descarga para facturas, albaranes, notas de entrega y etiquetas de envío para los pedidos.

4. Gestión de Cupones BOGO (requiere WebToffee Smart Coupon)

Cuando el plugin WebToffee Smart Coupon está activo, las siguientes capacidades BOGO (Compra Uno, Llévate Otro) están disponibles a través tanto del chatbot de administrador como del servidor MCP:

Crear, duplicar, enviar a la papelera, restaurar y eliminar permanentemente ofertas BOGO.
Alternar el estado activo/inactivo de BOGO.
Listar todas las ofertas BOGO con su estado actual.

Integración MCP / Agente de IA

En WordPress 6.9+, el plugin registra sus capacidades con la API de Habilidades de WordPress (Abilities API) y utiliza el endpoint de servidor predeterminado del adaptador MCP. Esto permite que cualquier agente de IA compatible con MCP — Claude Desktop, Cursor, Claude Code, y otros — llame a las herramientas de tu tienda directamente.

Requisitos previos

WordPress 6.9 o superior.
El plugin MCP Adapter (o el paquete de Composer) instalado y activo. Si ves un aviso en wp-admin, instálalo a través del directorio de plugins de WordPress o ejecuta composer require wordpress/mcp-adapter dentro del directorio del plugin.

Punto de Enlace (Endpoint) del Servidor MCP

Una vez que se cumplan los requisitos previos, tu servidor MCP estará disponible en:

https://tu-sitio.com/wp-json/mcp/mcp-adapter-default-server/

El servidor requiere que el usuario haya iniciado sesión. Usa una contraseña de aplicación (Usuarios › Perfil › Contraseñas de aplicación) para el acceso del agente.

Herramientas Disponibles

Herramienta	Descripción	Tipo
`generate-product-description`	Genera y guarda una descripción completa para un producto existente.	Núcleo
`generate-product-short-description`	Genera y guarda una descripción corta para un producto existente.	Núcleo
`generate-product-image`	Genera una imagen por IA y la establece como imagen destacada del producto.	Núcleo
`generate-product-brands`	Genera y aplica sugerencias de marcas para un producto.	Núcleo
`generate-product-tags`	Genera y aplica etiquetas (tags) SEO para un producto.	Núcleo
`mark-product-ai-generated`	Marca o desmarca el contenido de un producto como generado por IA (muestra la insignia de IA).	Núcleo
`search-product-id`	Encuentra IDs de productos de WooCommerce por nombre. Úsalo antes de otras herramientas que necesiten un ID de producto.	Núcleo
`create-product-draft`	Crea un nuevo producto de WooCommerce como borrador para revisión antes de publicarlo.	Núcleo
`create-product-published`	Crea y publica inmediatamente un nuevo producto de WooCommerce.	Núcleo
`publish-product-draft`	Publica un producto en borrador existente mediante su ID.	Núcleo
`update-product`	Actualiza cualquier campo en un producto existente (título, precio, inventario, descripción, etc.).	Núcleo
`delete-product`	Mueve un producto a la papelera o lo elimina permanentemente.	Núcleo
`create-shop-coupon`	Crea un cupón de WooCommerce (descuento porcentual o fijo, alcance en carrito o por producto).	Núcleo
`update-order-status`	Cambia el estado de un pedido y opcionalmente añade una nota al pedido.	Núcleo
`create-bogo`	Crea una oferta BOGO (requiere el plugin Smart Coupon).	Smart Coupon
`list-bogos`	Enumera todas las ofertas BOGO con su estado actual.	Smart Coupon
`toggle-bogo`	Habilita o deshabilita una oferta BOGO mediante su ID.	Smart Coupon
`trash-bogo`	Mueve una oferta BOGO a la papelera.	Smart Coupon
`restore-bogo`	Restaura una oferta BOGO de la papelera.	Smart Coupon
`delete-bogo`	Elimina permanentemente una oferta BOGO.	Smart Coupon
`duplicate-bogo`	Crea una copia de una oferta BOGO existente.	Smart Coupon

Herramientas de Smart Coupon: Las 7 herramientas BOGO se registran en el servidor MCP incondicionalmente pero solo funcionan cuando el plugin WebToffee Smart Coupon está activo. Llamarlas sin Smart Coupon instalado devolverá un error.

Conectando Claude Desktop

Abre Claude Desktop y ve a Settings › Developer › Edit Config.
Agrega la siguiente entrada a claude_desktop_config.json (reemplaza la URL, el nombre de usuario y la contraseña con tus propios valores):

{
  "mcpServers": {
    "webtoffee-ai": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://yoursite.example/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "{admin_user}",
        "WP_API_PASSWORD": "{application-password}"
      }
    }
  }
}

Contraseña de Aplicación: Ve a Usuarios › Tu Perfil › Contraseñas de aplicación, ingresa un nombre como "Claude Desktop", y haz clic en Añadir nueva contraseña de aplicación.

Conectando Cursor o Claude Code

Agrega el servidor a tu .cursor/mcp.json o a la configuración MCP de Claude Code usando la misma url y encabezado de Authorization indicados arriba.

Usando el Servidor Adaptador MCP Predeterminado

El Adaptador MCP también crea un servidor predeterminado en wp-json/mcp/mcp-adapter-default-server/ que descubre automáticamente todas las habilidades registradas de cada plugin. Conéctate a ese endpoint para obtener las herramientas de WebToffee junto con cualquier otra habilidad registrada en tu sitio.

Solución de Problemas

El Endpoint MCP Devuelve 404

Confirma que WordPress 6.9+ está instalado.
Confirma que el plugin MCP Adapter está activo (verifica en Plugins › Plugins instalados).
Vacía los enlaces permanentes: ve a Ajustes › Enlaces permanentes y haz clic en Guardar cambios.
Visita /wp-json/mcp/mcp-adapter-default-server/ directamente en un navegador mientras tienes la sesión iniciada para verificar la respuesta sin procesar.

Aviso del Adaptador MCP en wp-admin

Si ves un aviso diciendo que falta el Adaptador MCP, significa que la API de Habilidades (WP 6.9+) está disponible pero el adaptador no está instalado. Instala el plugin MCP Adapter desde el directorio de plugins de WordPress, o ejecuta composer require wordpress/mcp-adapter dentro del directorio del plugin. Descarta el aviso una vez que el adaptador esté activo.

Errores de API / Generación

Problemas comunes:

Clave API inválida: Verifica la clave en Ajustes › IA (AI Connectors) o en la configuración del plugin. Comprueba si hay espacios adicionales.
Créditos insuficientes (OpenAI): Agrega información de facturación en platform.openai.com.
Falla la generación de imágenes: Confirma que tu clave de OpenAI tenga acceso a la generación de imágenes, o cambia a un proveedor Gemini con la generación de imágenes habilitada. Anthropic no soporta generación de imágenes.
Tiempo de espera (Timeout): Intenta regenerar. Las descripciones largas o las respuestas lentas de la API pueden agotarse en el primer intento.
No se muestran modelos en la configuración: Al menos un proveedor debe estar configurado en Ajustes › IA (AI Connectors) o a través del interruptor de clave API personalizada.

Modo de Depuración

Habilita el modo de depuración en WooCommerce › Generador de Contenido AI › Avanzado para registrar todas las solicitudes y respuestas de la API. Los registros están disponibles en WooCommerce › Estado › Registros — busca la fuente webtoffee-ai.

Soporte

Consulta las preguntas frecuentes (FAQ) en la página de configuración del plugin.
Visita el foro de soporte en WordPress.org.
Contacta al soporte de WebToffee con tu registro de depuración adjunto si el problema persiste.