AI Merchant Pro para WooCommerce

Google AI Mode

Google AI Mode (impulsado por Gemini) usa UCP para habilitar compras directamente dentro de conversaciones con IA. Con AI Merchant Pro v7.0, tu tienda queda lista para Google AI Mode desde el primer día.

Resumen

Cuando los usuarios preguntan a Google AI sobre productos, puede:

1. Descubrir tu tienda vía el endpoint /.well-known/ucp
2. Explorar tu catálogo de productos a través de la REST API
3. Buscar productos específicos
4. Crear sesiones de checkout
5. Completar compras con Google Pay

Todo esto sucede dentro de la conversación con IA, sin necesidad de visitar tu web.

Guía de Configuración

Configuración de Google Pay

Para checkout en un toque en Google AI Mode, configura Google Pay:

Prerrequisitos

• Stripe, Adyen o Square para WooCommerce instalado
• Google Pay activado en tu pasarela de pago
• Certificado SSL válido en tu sitio

Pasos de Configuración

1. Ve a AI Merchant Pro → Settings → Payment Handlers
2. Activa "Google Pay"
3. Introduce tu Google Pay Merchant ID
4. Selecciona Environment: TEST o PRODUCTION
5. Configura Allowed Card Networks (Visa, Mastercard, American Express, Discover)
6. Selecciona Authentication Methods: PAN_ONLY y/o CRYPTOGRAM_3DS
7. Haz clic en Save Changes

Fallback a WooCommerce Gateway

Si no configuras Google Pay, los agentes IA usarán checkout por redirección:

1. El agente IA crea una sesión de checkout
2. El cliente es redirigido a tu checkout de WooCommerce
3. El cliente completa el pago con tus pasarelas estándar
4. El pedido se crea en WooCommerce

Pruebas de UCP

Pruebas Manuales

1. Discovery: Visita /.well-known/ucp y verifica la respuesta
2. Productos: Visita /wp-json/ucp/v1/products y revisa los datos
3. Búsqueda: Prueba /wp-json/ucp/v1/products/search?q=test
4. Checkout: Usa el probador de checkout del Validador UCP

Uso del Validador UCP

1. Ve a AI Merchant Pro → UCP Validator
2. Haz clic en "Run Full UCP Validation"
3. El validador comprueba: accesibilidad del endpoint discovery, completitud del perfil, respuestas de API, flujo de checkout y configuración de métodos de pago

Checkout de Agentes IA

AI Merchant Pro permite que agentes IA (ChatGPT, Google Gemini, Claude, etc.) creen y completen compras en nombre de clientes directamente dentro de conversaciones.

Cómo Funciona

1. El cliente pide a la IA: "Quiero comprar el widget azul"
2. El agente IA busca en tu catálogo vía API
3. El agente IA crea una sesión de checkout
4. El cliente confirma y proporciona el pago
5. El agente IA completa la compra
6. El pedido se crea en WooCommerce

Todo el flujo ocurre vía API; no se requiere visitar el sitio web.

Sesiones de Checkout

Las sesiones de checkout son carritos temporales que los agentes IA crean y gestionan.

Ciclo de Vida de la Sesión

API de Tarifas de Envío

Los agentes IA solicitan tarifas de envío después de establecer la dirección de entrega:

Ejemplo de Petición

Las tarifas de envío vienen de tu configuración de envíos en WooCommerce y de las Shipping Rules configuradas en AI Merchant Pro.

Campos de Respuesta

• id - Identificador del método de envío
• label - Nombre visible (p. ej., "Standard Shipping")
• cost - Coste de envío con moneda
• delivery_estimate - Tiempo de entrega estimado

Validación de Descuentos

Los agentes IA pueden validar y aplicar códigos de descuento:

Respuesta (Código Válido)

• valid: true
• type - percent o fixed_cart
• amount - Valor del descuento
• new_totals - Totales del carrito actualizados

Ajustes de Descuentos

Controla cómo los agentes IA pueden usar descuentos en AI Merchant Pro → Settings → Discounts:

Payment Handlers

Al completar checkout, los agentes IA especifican un método de pago:

Google Pay (Native)

Para checkout en un toque dentro de interfaces de IA. Requiere Google Pay Merchant ID y pasarela compatible.

WooCommerce Gateway (Redirect)

Devuelve una payment_url para que el cliente complete el pago en tu página de checkout.

Payment Handlers Disponibles

Todas las pasarelas de pago activas en WooCommerce están disponibles automáticamente:

• Stripe
• PayPal
• Square
• Transferencia bancaria (BACS)
• Pago contra reembolso
• Cualquier otra pasarela activa

Configura qué pasarelas se exponen en AI Merchant Pro → Settings → Payment Handlers.

Analíticas UCP

Haz seguimiento de cómo interactúan los agentes IA con tu tienda mediante el panel de Analíticas UCP.

Activar Registro de Solicitudes

Para recopilar datos analíticos, activa el registro de solicitudes:

1. Ve a AI Merchant Pro → Settings → Security
2. Activa "Request Logging"
3. Haz clic en Save Changes

Métricas Disponibles

Consulta analíticas en AI Merchant Pro → Analytics:

Resumen del Panel

El panel de Analíticas muestra:

Tarjetas Resumen

• Total de llamadas API (últimos 30 días)
• Agentes IA únicos
• Tasa de conversión (checkouts → completados)
• Ingresos de compras por IA

Gráfico de 30 Días

Gráfico visual con solicitudes API diarias, sesiones de checkout y pedidos completados.

Consultas Principales

Consultas de búsqueda más comunes de agentes IA para entender qué buscan los clientes.

Distribución por Agente

Qué plataformas de IA están accediendo a tu tienda:

• Google AI Mode / Gemini
• ChatGPT
• Otros agentes

Exportar Datos Analíticos

1. Ve a AI Merchant Pro → Analytics
2. Haz clic en "Export Data"
3. Elige formato: CSV o JSON
4. Selecciona rango de fechas
5. Descarga el archivo

Seguridad

Configura ajustes de seguridad para tu API UCP para protegerte contra abusos permitiendo a la vez acceso legítimo de agentes IA.

Rate Limiting

Evita abuso de API limitando solicitudes por dirección IP.

Configuración

1. Ve a AI Merchant Pro → Settings → Security
2. Define "Rate Limit" (solicitudes por minuto por IP)
3. Por defecto: 60 solicitudes/minuto
4. Haz clic en Save Changes

Cabeceras de Rate Limit

Las respuestas API incluyen cabeceras de límite:

• X-RateLimit-Limit: 60
• X-RateLimit-Remaining: 45
• X-RateLimit-Reset: 1705410000

Autenticación por API Key

Opcionalmente exige API keys para endpoints sensibles.

Activar API Keys

1. Ve a AI Merchant Pro → Settings → Security
2. Activa "API Key Required"
3. Haz clic en Generate API Key para crear claves
4. Distribuye las claves a integraciones autorizadas

Uso de API Keys

Incluye la clave en las cabeceras de petición:

Qué Endpoints Requieren Clave

Cuando API Key Required está activado:

Los endpoints públicos siguen accesibles para discovery de agentes IA.

Gestión de API Keys

En AI Merchant Pro → Settings → API Keys:

• Generar nuevas claves
• Revocar claves existentes
• Ver estadísticas de uso de claves
• Definir fechas de expiración

Registro de Solicitudes

Registra todas las solicitudes API para depuración y analíticas.

Qué se Registra

Buenas Prácticas de Seguridad

Recomendaciones Adicionales

• Usa HTTPS - Requerido para UCP (forzado)
• Mantén WordPress actualizado - Parches de seguridad
• Monitorea logs - Vigila patrones inusuales
• Revisa API keys - Revoca claves sin uso regularmente

Funciones Avanzadas

Productos Variables

AI Merchant Pro soporta completamente productos variables de WooCommerce, exportando cada variación como un ítem separado con sus propios atributos como color, talla y material. Cada variación aparece en el feed con su propio precio, estado de stock e imágenes.

Video y Modelos 3D

Mejora tus listados de producto con contenido multimedia enriquecido para aumentar engagement y conversiones. AI Merchant Pro añade un panel dedicado "AI Merchant Pro Media" al editor de producto de WooCommerce donde puedes añadir videos y modelos 3D fácilmente.

Añadir Videos de Producto

En el panel AI Merchant Pro Media puedes añadir URLs de video desde:

• YouTube - Pega cualquier URL de video de YouTube
• Vimeo - Pega cualquier URL de video de Vimeo
• MP4 autoalojado - Usa las URLs de tus propios archivos de video

Los videos se incluirán en tu feed JSON ACP y se mostrarán a usuarios de ChatGPT cuando naveguen tus productos.

Añadir Modelos 3D

Para productos que se benefician de visualización 3D (muebles, joyería, electrónica, etc.), puedes añadir archivos de modelo 3D en el mismo panel:

• Archivos GLB/GLTF - Formato web 3D estándar
• Archivos USDZ - Para Apple AR Quick Look

Solo sube tus archivos 3D a la biblioteca de medios o introduce la URL en el panel AI Merchant Pro Media. La URL del modelo 3D se incluirá en tu feed para plataformas IA con soporte AR/3D.

Mapeo de Campos Personalizados

Si usas otros plugins que almacenan datos del producto en campos personalizados (como plugins de GTIN, plugins de marca, etc.), AI Merchant Pro puede extraer esos datos automáticamente hacia tus feeds.

Ve a AI Merchant Pro → Field Mapping para configurar qué campos usar para:

• Brand - Nombre del fabricante o marca
• GTIN/EAN/UPC - Códigos de barras para identificación
• MPN - Número de parte del fabricante
• Condition - Nuevo, reacondicionado o usado
• Energy Rating - Para electrodomésticos (A+++, A++, etc.)

El plugin detecta automáticamente plugins populares de GTIN y marca y usa sus datos. Para configuraciones personalizadas, puedes especificar manualmente qué campos usar en los ajustes de Field Mapping.

Optimización de Rendimiento

Para tiendas con catálogos grandes, activa estas funciones de rendimiento:

Ajustes de Servidor Recomendados para Catálogos Grandes

Solución de Problemas

Preguntas Frecuentes

Historial de Cambios

Ver historial completo →