Catálogo (CSV o Google Sheets)

La herramienta Catálogo permite que tu chatbot busque en una lista tuya: lotes, propiedades, habitaciones, platos, productos o servicios. Un cliente pregunta "¿Tienen lotes de menos de 30.000 dólares en la zona norte?" y el bot responde con los ítems de tu lista que coinciden: como tarjetas con foto, precio y datos en el widget web, y como texto corto con links en WhatsApp y Telegram.

El bot solo muestra ítems que están en tu catálogo. No inventa ítems, precios ni disponibilidad. Los ítems marcados como vendidos o reservados aparecen como no disponibles.

Antes de empezar

• Plan: Catálogo es parte de AI Tools, disponible en el plan Growth o superior.
• Límites: hasta 5 MB y 5.000 filas por catálogo en Growth (8 MB y 20.000 filas en Business). Hasta 10 catálogos por chatbot.
• Tus datos: un archivo CSV, o una hoja de Google compartida como "Cualquier persona con el enlace" o publicada en la web. Nunca te pedimos iniciar sesión con Google.

Paso 1 — Prepara tu lista

Pon un ítem por fila y los nombres de las columnas en la primera fila. Puedes usar las columnas que quieras. Estos nombres los reconocemos solos, en español o inglés:

Qué es	Nombres que detectamos
ID / código	id, sku, código, ref, lote, code
Título	nombre, título, producto, name, title
Descripción	descripción, detalle, description
Precio	precio, valor, costo, tarifa, price
Moneda	moneda, currency
Estado	estado, disponibilidad, stock, status
Imagen	imagen, foto, image, photo
Link	link, enlace, url

Todas las demás columnas (superficie, zona, ambientes, financiación…) se convierten en filtros que el bot puede usar.

Consejos:

• Precios: puedes escribir 45000, 45.000, 45.000,50, USD 45.000 o $ 45.000.
• Estado: entendemos disponible, reservado, señado, vendido, agotado (y sus versiones en inglés). Cualquier otra palabra (por ejemplo "en obra") se guarda tal como la escribiste.
• Imágenes y links tienen que empezar con https:// (o http://). Los demás valores se ignoran.
• También funcionan los archivos separados por punto y coma (lo normal cuando Excel usa la coma para los decimales).

¿Quieres un ejemplo? Descarga el archivo de muestra: lotes-bosque-alto.csv — 12 lotes de un barrio ficticio, con superficie, precio, estado, financiación, zona e imagen.

Paso 2 — Activa la herramienta

1. Abre tu chatbot y ve a la pestaña Herramientas.
2. Busca la tarjeta Catalog y haz clic en Activar.
3. Opciones (no son obligatorias):
   • Items per answer — cuántos ítems recibe el bot por búsqueda (por defecto 5, máximo 10).
   • Card button text — el texto del botón de cada tarjeta. Si lo dejas vacío dice "Ver más" en un catálogo en español (o "View details" en uno en inglés).
   • Extra instructions — una regla para el bot, por ejemplo "Los precios no incluyen impuestos."
4. Haz clic en Activar herramienta. Aparece una pestaña nueva Catálogo en el menú del chatbot.

Paso 3 — Agrega tu catálogo

Abre la pestaña Catálogo y completa Agregar un catálogo:

1. Nombre — por ejemplo "Lotes en venta". El bot usa este nombre.
2. Moneda por defecto (opcional) — se usa cuando la columna de precio no indica la moneda.
3. Elige el origen:
   • Subir CSV — selecciona el archivo.
   • Link de Google Sheets — en Google Sheets haz clic en Compartir, en Acceso general elige "Cualquier persona con el enlace" (Lector) y copia el link. Pégalo aquí. También sirve un link CSV de "Publicar en la web".
4. Haz clic en Agregar catálogo. La importación empieza enseguida y la página se actualiza sola.

Paso 4 — Revisa el mapeo de columnas

En la página del catálogo vas a ver:

• Mapeo de columnas — qué columna es el título, el precio, el estado, la imagen, etc. Corrige lo que no esté bien y haz clic en Guardar mapeo y reimportar. No hace falta subir el archivo de nuevo.
• Vista previa — las primeras filas de tu archivo, con el rol de cada columna.
• Filtros que el bot puede usar — las demás columnas, con su tipo (rango numérico, lista de valores o texto).
• Filas que necesitan revisión — por ejemplo una fila sin título (se omite), un precio que no es un número (queda vacío) o un ID repetido (se omite). Corrígelas en tu archivo y vuelve a importar.
• Ítems — todo lo importado, con buscador.

Paso 5 — Mantenlo al día

• Google Sheets: el catálogo se sincroniza solo cada 6 horas (puedes cambiarlo en Configuración, de 1 a 168 horas). Haz clic en Sincronizar ahora después de un cambio grande.
• CSV: haz clic en Subir nuevo CSV para reemplazar los ítems. Si las columnas no cambiaron, se mantiene tu mapeo.

Si una importación falla (por ejemplo, la hoja dejó de ser pública), el bot sigue usando los ítems de la última importación buena y el error aparece en la página del catálogo.

Qué ven tus clientes

• Widget web: una respuesta corta más tarjetas — foto, título, precio, estado, hasta 4 datos y un botón con el link cuando la fila tiene link.
• WhatsApp y Telegram: solo texto. El bot lista como máximo 3 ítems, uno por línea, con su link.

Ejemplo

Cliente: "¡Hola! ¿Tienen lotes en la zona sur por menos de 25.000?"

El bot busca en el catálogo con price_max: 25000 y zona: Sur, y recibe 4 lotes: B-01, B-02 y B-04 disponibles, y B-03 vendido. Responde:

Tenemos 3 lotes disponibles en la zona sur por menos de USD 25.000: el B-04 (350 m², USD 19.800, hasta 48 cuotas), el B-01 (380 m², USD 22.000, junto al club house) y el B-02 (400 m², USD 23.500, frente a la plaza). El B-03 ya está vendido.

…con una tarjeta por cada lote.

Bueno saber

• El bot lee un resumen corto de tu catálogo (nombres, cantidades, columnas, rango de precios), nunca la lista completa. Para cada pregunta sobre ítems hace una búsqueda, así las respuestas siempre coinciden con tu última importación.
• La búsqueda en el catálogo es aparte del Entrenamiento. No necesitas reentrenar el chatbot después de importar un catálogo.
• Para dejar de usar un catálogo, elimínalo desde la pestaña Catálogo o apaga la herramienta en Herramientas.