Visión general
El catálogo nativo es tu base de productos dentro de Conversa Labs. Es donde registras cada ítem con nombre, descripción, imágenes, precio y disponibilidad, organizas todo en categorías y mantienes los datos que se usarán para sincronizar con WhatsApp y para enviar productos durante la atención.
Tenerlo bien organizado es el primer paso: a partir de él sincronizas con Meta, envías productos en la conversación y cobras pedidos. Aunque también uses plataformas externas, el catálogo nativo es la fuente de la verdad dentro de la plataforma.
Requisitos previos
- El módulo de Catálogo y Comercio habilitado para tu cuenta y rol de acceso.
- Permiso para gestionar el catálogo (crear/editar productos y categorías).
- Imágenes de los productos en un formato común (por ejemplo, JPG o PNG) y accesibles.
Paso a paso
- Abre el área de Catálogo de la plataforma.
- Crea tus categorías para agrupar productos (por ejemplo, "Bebidas", "Servicios", "Cursos").
- Registra un producto: indica nombre, descripción, categoría y su primera variante.
- En cada variante, define nombre, SKU, precio y opciones como
Color: AzulyTalla: M. - Usa las flechas para ordenar las variantes y elige exactamente una como predeterminada.
- Agrega una o más imágenes al producto. Después puedes asignar una imagen del producto a cada variante; las variantes sin imagen usan la imagen principal.
- Define disponibilidad e inventario cuando corresponda, guarda y repite para los demás productos.
Configuración y opciones
- Producto: nombre, descripción, precio, categoría, disponibilidad, imágenes e identificadores (como SKU y enlace externo).
- Categorías: agrupación de productos que facilita la búsqueda y el armado de listas.
- Imágenes: una o más por producto; la primera suele usarse como destacada.
- Variantes: cada combinación vendible tiene nombre, opciones, posición, precio, existencias e imagen opcional. La variante predeterminada es la selección inicial en listas y envíos.
- Archivar una variante: el formulario de edición solo descarta variantes que aún no se han guardado. Archiva una variante guardada desde el detalle del producto después de confirmarlo y elige antes otra variante predeterminada. Se conservan el registro archivado y su historial de pedidos y pagos.
- Imagen de variante: solo se puede elegir en la galería del mismo producto. Si se elimina, la variante vuelve de forma segura a la imagen principal del producto.
- Precio: siempre en unidades mayores de la moneda (consulta la sección de consejos).
- Baja automática de existencias: cuando una venta activa queda pagada, se descuenta una sola vez la cantidad de cada variante con control de existencias. El cobro y el pedido de la misma venta comparten una identidad, por lo que los webhooks repetidos o ambos eventos no descuentan dos veces. El saldo se detiene en cero; las variantes sin control de existencias no cambian. Las importaciones y adopciones históricas tampoco modifican el saldo actual. Las existencias controladas usan unidades enteras: una línea fraccionaria falla de forma segura, sin redondear ni descontar parcialmente la venta, y queda visible en el Historial. Las cantidades fraccionarias de variantes sin control no afectan las existencias.
- Informes: la vista de informes separa el presupuesto cotizado de los ítems del negocio del valor realizado de los ítems de pedidos pagados. Las dos métricas no se suman y pueden diferir por descuentos, envío o pedidos aún no liquidados.
Casos de uso
- Menú de un restaurante o cafetería con categorías y fotos.
- Catálogo de servicios (consultas, planes, paquetes) con precio por ítem.
- Lista de productos físicos de una tienda que vende por WhatsApp.
- Catálogo de infoproductos o cursos para enviar directamente al cliente.
Consejos, límites y buenas prácticas
- Precio en unidades mayores: escribe
4,97para indicar R$4,97. La plataforma no divide por 100 — el valor que registras es el valor mostrado y cobrado. - El total de un pedido es la suma de
precio × cantidadde cada ítem — también sin dividir por 100. - Usa imágenes nítidas y accesibles públicamente: la sincronización con WhatsApp necesita poder descargarlas. Las imágenes alojadas en direcciones que quedan fuera de línea no se importarán.
- Mantén nombres y descripciones claros — aparecen para el cliente cuando envías el producto.
- En el informe, interpreta Presupuesto como la propuesta registrada en el negocio y Realizado como los ítems de pedidos pagados. Un ítem sin pedido pagado no se incluye en el realizado.
Solución de problemas
- Precio mostrado incorrecto (ej.: R$0,05 en vez de R$4,97): confirma que escribiste el valor en unidades mayores; no multipliques ni dividas por 100.
- La imagen no aparece: verifica que el archivo sea válido y que la dirección de la imagen esté accesible.
- No se puede archivar o eliminar una variante: elige primero otra variante activa como predeterminada.
- Se muestra una imagen incorrecta para la variante: edita el producto y elige una imagen de su galería para esa variante, o selecciona el uso de la imagen principal.
- El producto no desaparece de las listas: márcalo como no disponible en lugar de mantenerlo visible cuando no está a la venta.
- Una venta pagada no redujo las existencias: confirma que la línea de venta apunta a una variante con control de existencias activo. Los registros solo importados o adoptados como historial se conservan para consulta y, de forma intencional, no reescriben el saldo actual.
- La reducción aparece como fallida después de los reintentos automáticos: un administrador debe abrir Catálogo → Importar y sincronizar → Historial, localizar la ejecución Reducción automática de existencias, abrir el detalle y hacer clic en Reintentar reducción de existencias. La ejecución identifica el cobro o pedido y muestra solo una referencia técnica saneada, sin credenciales ni payload del gateway. El reintento es seguro: el recibo único de la venta impide una segunda reducción si el intento anterior terminó de forma ambigua. Si la ejecución está Pendiente o Procesando, espera al worker en vez de volver a hacer clic. Si el motivo indica una cantidad fraccionaria, corrige la línea de origen a unidades enteras — o desactiva el control solo cuando la variante sea legítimamente fraccionaria — antes de reintentar; la plataforma nunca redondea esa cantidad.