Integración con un feed de productos (XML, Google Merchant)

Conecta cualquier tienda online a tu chatbot de ChatLab a través de un feed de productos. Si tu plataforma no cuenta con una integración nativa de ChatLab, el feed es la forma de proporcionarle tu catálogo al chatbot: lee los productos del feed, los indexa con AI Search y responde con tarjetas de producto que enlazan a tu tienda.

Importante: Buenas prácticas de e-commerce

Tras completar la integración siguiente, lee la guía completa sobre cómo optimizar tu chatbot para e-commerce: Cómo configurar ChatLab para tu tienda de e-commerce

Qué ofrece la integración

Búsqueda de productos con IA - Los clientes describen lo que necesitan con sus propias palabras y el chatbot encuentra productos coincidentes en tu catálogo. La respuesta contiene:

• Nombre y descripción del producto
• Precio (y precio rebajado cuando el feed dispone de él)
• Imagen del producto
• Enlace directo a la página del producto en tu tienda
• Marca, disponibilidad, GTIN / SKU y otros atributos del feed

Categorías - Cuando el feed incluye el tipo de producto (por ejemplo, "Hogar > Cocina > Hervidores"), el chatbot puede acotar la búsqueda a una categoría.

Actualización programada - El catálogo se actualiza según la programación que definas, por lo que los nuevos productos, precios y disponibilidad llegan al chatbot sin que tengas que intervenir.

Qué no ofrece la integración

El feed es un archivo, no una conexión con tu tienda, por lo que el chatbot no puede:

• consultar el estado de un pedido
• añadir productos al carrito o realizar un pedido
• leer niveles de stock en tiempo real entre actualizaciones

Las tarjetas de producto siempre enlazan a tu tienda, donde el cliente finaliza la compra. Si necesitas seguimiento de pedidos o añadir al carrito, utiliza una integración nativa.

Requisitos

• La integración Feed XML incluida en tu plan
• El paquete de productos de AI Search asignado al chatbot: determina cuántos productos se pueden indexar
• Un feed de productos en formato XML de Google Merchant (Google Shopping), disponible en una dirección https pública. Se admiten feeds comprimidos (.gz) y feeds protegidos con usuario y contraseña.

Paso 1: Obtener el feed de productos de tu tienda

La mayoría de las plataformas exportan un feed de Google Merchant de forma nativa o mediante una extensión gratuita:

• Magento / Adobe Commerce - una extensión de feed de Google Shopping (por ejemplo, de Magento Marketplace) genera el XML en una dirección como https://yourstore.com/feeds/google.xml
• IdoSell - Marketing e integraciones, Comparadores de precios y marketplaces, Google Merchant: activa el feed y copia su dirección
• OpenCart - Extensiones, Feeds, Google Base: actívalo y copia la URL del feed de datos
• BigCommerce - Channel Manager, Google Shopping, o una app de feeds de BigCommerce App Marketplace
• Shopware - Marketing, Comparativas de productos, Google Shopping: crea la exportación y copia su URL
• osCommerce y tiendas personalizadas - cualquier módulo que genere un feed RSS 2.0 o Atom con los atributos de producto g:

El feed debe contener al menos un identificador de producto (g:id), un nombre y un enlace. El precio, la imagen, la descripción, la disponibilidad y el tipo de producto mejoran notablemente las respuestas.

Paso 2: Conectar el feed en ChatLab

1. Inicia sesión en ChatLab y selecciona tu bot
2. Ve a la pestaña Connect (Conectar)
3. Haz clic en Connect (Conectar) en la tarjeta Feed XML
4. Pega la Feed URL (URL del feed)
5. Si el feed requiere inicio de sesión, activa The feed requires a username and password (El feed requiere usuario y contraseña) e introduce las credenciales
6. De forma opcional, define el Product language (Idioma de los productos; código de dos letras del idioma utilizado en el feed)
7. Haz clic en Test feed (Probar feed) - ChatLab descarga el inicio del feed y muestra el formato, el número de productos encontrados, los primeros productos tal como se indexarán y cualquier aviso (precios, enlaces, imágenes o categorías ausentes)
8. Haz clic en Connect (Conectar)

Tras una conexión correcta, ChatLab comienza a indexar el catálogo en segundo plano. Según el tamaño del feed, este proceso tarda desde un minuto hasta unas decenas de minutos. Puedes seguir el progreso en Training (Entrenamiento) > E-commerce catalog (Catálogo de e-commerce).

Paso 3: Feeds no estándar (asignación de campos)

Si tu feed no está en el formato de Google Merchant, ChatLab puede leerlo igualmente:

1. Ejecuta primero Test feed (Probar feed) - los nombres de los elementos encontrados en tu archivo aparecerán en los desplegables de asignación
2. Abre Field mapping for non-standard feeds (Asignación de campos para feeds no estándar)
3. Si un producto no corresponde a un elemento item o entry, introduce el nombre del Product element (Elemento de producto)
4. Elige el elemento para cada campo: Product identifier (Identificador de producto, obligatorio), Product name (Nombre del producto), Description (Descripción), Product page URL (URL de la página del producto), Image URL (URL de la imagen), Price (Precio), Category path (Ruta de categoría) y el resto
5. Vuelve a ejecutar Test feed (Probar feed) y revisa los productos de muestra
6. Haz clic en Connect (Conectar)

Los campos que se dejen en "Default (Google Merchant)" conservan los nombres estándar, por lo que un feed que siga el estándar no necesita ninguna asignación.

Paso 4: Programación de actualizaciones

1. Ve a Training (Entrenamiento) > E-commerce catalog (Catálogo de e-commerce)
2. En la tarjeta de Feed XML, haz clic en Retrain (Volver a entrenar)
3. Retrain now! (¡Volver a entrenar ahora!) actualiza el catálogo de inmediato
4. Para actualizarlo automáticamente, elige la frecuencia (todos los días, una vez a la semana o una vez al mes), el día y la hora, y haz clic en Schedule retrain (Programar reentrenamiento)

Solo se vuelven a indexar los productos que hayan cambiado desde la última actualización, y los productos eliminados del feed se retiran del catálogo del chatbot. La actualización programada depende de tu plan: las programaciones semanales y mensuales requieren la función de reentrenamiento programado, y las diarias necesitan la función de reentrenamiento diario.

Paso 5: Configurar la acción de IA

Tras la conexión, la acción Feed XML - AI product search se activa automáticamente en los chatbots que disponen del producto AI Search. Para ajustarla, ve a Settings (Ajustes) > Actions (Acciones) y filtra por la plataforma Feed XML. Puedes cambiar la etiqueta de la acción, las instrucciones que guían a la IA y activar Include product card (Incluir tarjeta de producto) para facilitarle al chatbot la tarjeta completa del producto en lugar de la descripción breve.

Probar tu integración

Abre el widget de tu chatbot y prueba con:

• "Muéstrame hervidores por menos de 50 dólares" (prueba la búsqueda con filtro de precio)
• "¿Tienes camisetas de algodón azules?" (prueba la coincidencia de atributos)

Las respuestas deberían mostrar productos de tu feed con enlaces a tu tienda.

Consejos

• Incluye el tipo de producto en el feed (g:product_type) como una ruta completa, por ejemplo "Ropa > Hombre > Camisetas" - se convierte en la categoría por la que el chatbot puede filtrar
• Mantén las descripciones completas en el feed; el chatbot las utiliza para buscar coincidencias con las preguntas de los clientes
• Las variantes de un mismo producto deben compartir un item_group_id - ChatLab las muestra como un único producto con todos los colores y tallas
• Si tu feed es grande, un feed comprimido (.gz) se descarga con mayor rapidez

Instalar el chatbot en tu tienda

Para añadir el widget de chat a tu tienda:

1. En ChatLab, ve a la pestaña Deploy (Desplegar) de tu bot
2. Copia el fragmento de código
3. Pégalo en la plantilla de tu tienda, antes de la etiqueta de cierre </body>, o utiliza la configuración de "HTML personalizado" o "scripts" de tu plataforma