Catálogo y Comercio
Por Conversa Labs
Por Conversa Labs
Catálogo nativo, sincronización y WhatsApp Business Catalog, envío de productos/pedidos en la conversación y ciclo de vida de e-commerce.
Visión general de Catálogo y Comercio
Visión general El módulo Catálogo y Comercio reúne todo lo relacionado con productos y ventas dentro de tus conversaciones. Con él mantienes un catálogo nativo (productos, categorías, imágenes y precios), sincronizas ese catálogo con el WhatsApp Business Catalog de Meta, envías productos y listas de productos directamente en la atención, recibes pedidos del cliente como una tarjeta lista para cobrar y sigues el ciclo de vida de e-commerce de plataformas externas (Kiwify, Hotmart, Nuvemshop, Shopify) sin salir de la plataforma. La idea es convertir la conversación en un mostrador de ventas: el cliente ve el producto, arma el pedido y tú cobras — todo en el mismo lugar, integrado con el CRM, los Pagos y los Follow-ups. Requisitos previos - Una cuenta ConversaLabs activa con el módulo de Catálogo y Comercio habilitado para tu plan y rol de acceso. Si no ves el módulo, habla con un administrador. - Para el WhatsApp Business Catalog: una Bandeja de Entrada de WhatsApp (Cloud API) conectada y vinculable al catálogo de Meta. - Para el ciclo de vida de e-commerce: acceso a la plataforma externa (Kiwify, Hotmart, Nuvemshop o Shopify) para configurar el webhook. - Para cobrar pedidos: el módulo de Pagos configurado (pasarelas como Asaas o Mercado Pago). Paso a paso 1. Crea o importa tu catálogo nativo de productos (con categorías, imágenes y precios). 2. Si atiendes por WhatsApp, vincula y sincroniza el catálogo con el WhatsApp Business Catalog. 3. Durante la atención, envía productos (un producto o una lista) al cliente en la conversación. 4. Cuando el cliente arma un carrito, recibe el pedido como tarjeta y genera el cobro o la suscripción. 5. Conecta plataformas de e-commerce para seguir el ciclo de vida (carrito abandonado, PIX pendiente, compra aprobada, reembolso) y recuperar ventas con Follow-ups. Configuración y opciones - Catálogo nativo: registro de productos, categorías, imágenes, precio y disponibilidad. - Fuentes de sincronización: vinculación al WhatsApp Business Catalog (Meta) y a conectores externos, con intervalo de sincronización configurable. - Envío en la conversación: enviar producto único, lista de productos o abrir el catálogo de WhatsApp. - Pedidos: tarjeta de pedido con ítems, total y atajos para Crear cobro / Crear suscripción. - Comercio (lifecycle): webhooks de plataformas externas con URL y secreto de verificación por fuente. Casos de uso - Tienda que atiende por WhatsApp y quiere mostrar productos nativos sin enviar al cliente a un sitio. - Operación que recibe pedidos por el carrito de WhatsApp y factura al instante con PIX o boleto. - Infoproductor que vende por Kiwify/Hotmart y quiere recuperar carrito abandonado y PIX pendiente. - E-commerce en Nuvemshop/Shopify que centraliza la recuperación de ventas en la atención. Consejos, límites y buenas prácticas - Importes en unidades mayores: el precio 4,97 significa R$4,97 — nunca dividas por 100. El total de un pedido es la suma de precio × cantidad de cada ítem. - Productos y pedidos nativos en WhatsApp (catálogo, lista, tarjeta de pedido) funcionan en la API Cloud; en WhatsApp Web la venta usa la tarjeta de producto enriquecida como alternativa. - Mantén las imágenes de los productos accesibles públicamente para que la sincronización pueda descargarlas. - Empieza por un catálogo nativo bien organizado antes de activar sincronización y conectores externos. Solución de problemas - No veo el módulo: puede no estar habilitado para tu cuenta o rol — habla con un administrador. - Productos sin imagen tras sincronizar: verifica que las imágenes originales estén accesibles y vuelve a sincronizar (cada ejecución reintenta la descarga de imágenes). - El cliente no recibe el producto/pedido nativo: confirma que la bandeja es WhatsApp Cloud API. Ver también - Catálogo nativo: productos, categorías, imágenes y precios - Sincronización y WhatsApp Business Catalog - Enviar producto y recibir pedidos en la conversación - Ciclo de vida de e-commerce
Catálogo nativo: productos, categorías, imágenes y precios
Visión general El catálogo nativo es tu base de productos dentro de ConversaLabs. 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 1. Abre el área de Catálogo de la plataforma. 2. Crea tus categorías para agrupar productos (por ejemplo, "Bebidas", "Servicios", "Cursos"). 3. Registra un producto: indica nombre, descripción, precio y categoría. 4. Agrega una o más imágenes al producto. 5. Define la disponibilidad (disponible o no disponible) y, si aplica, datos como SKU o enlace externo. 6. Guarda y repite para los demás productos. Puedes editar o eliminar ítems en cualquier momento. 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. - Precio: siempre en unidades mayores de la moneda (consulta la sección de consejos). 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,97 para 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 × cantidad de 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. 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. - El producto no desaparece de las listas: márcalo como no disponible en lugar de mantenerlo visible cuando no está a la venta. Ver también - Visión general de Catálogo y Comercio - Sincronización y WhatsApp Business Catalog - Enviar producto y recibir pedidos en la conversación
Sincronización y WhatsApp Business Catalog
Visión general La sincronización conecta tu catálogo nativo con el WhatsApp Business Catalog de Meta. Una vez vinculado, los productos existen en ambos lugares y pueden mantenerse en dos vías: lo que registras en la plataforma se envía a Meta, y lo que existe en el catálogo de Meta puede importarse a la plataforma. Esto es lo que hace posible enviar productos nativos en WhatsApp, abrir el catálogo dentro de la conversación y recibir pedidos del carrito del cliente — todo a partir de un catálogo único y actualizado. Requisitos previos - Una Bandeja de Entrada de WhatsApp (Cloud API) conectada y funcionando. - Un catálogo configurado en tu cuenta comercial de Meta (Business / Commerce Manager). - El módulo de Catálogo y Comercio habilitado y permiso para gestionar fuentes de sincronización. - Un catálogo nativo con productos registrados (recomendado antes de la primera sincronización). Paso a paso 1. En el área de Catálogo, abre la configuración de fuentes de sincronización. 2. Crea una fuente de tipo WhatsApp Business Catalog (Meta) y selecciona el catálogo de Meta a vincular. 3. Vincula la fuente a la bandeja de WhatsApp Cloud correspondiente — la credencial de acceso se reutiliza automáticamente de esa bandeja, sin necesidad de indicar un token aparte. 4. Define el intervalo de sincronización (cada cuánto la plataforma revisa el catálogo de Meta). 5. Ejecuta la primera sincronización y revisa los productos importados/actualizados. 6. A partir de ahí, los cambios fluyen en ambas vías según el intervalo configurado, y puedes forzar una sincronización manual cuando quieras. Configuración y opciones - Catálogo de Meta vinculado: qué catálogo de la cuenta comercial está conectado a la fuente. - Bandeja de entrada: la bandeja de WhatsApp Cloud usada para la credencial y para enviar productos. - Intervalo de sincronización: frecuencia de las sincronizaciones automáticas. - Sincronización manual: botón para ejecutar la sincronización al instante. - Dos vías: los productos registrados en la plataforma se publican en Meta; los productos de Meta se importan a la plataforma, haciendo coincidir los identificadores de cada lado. Casos de uso - Tienda que ya tiene catálogo en Meta y quiere traerlo a la plataforma para atender y cobrar. - Operación que prefiere registrar productos en la plataforma y publicarlos automáticamente en WhatsApp. - Equipo que mantiene un catálogo único y quiere evitar actualizar precios en dos lugares. Consejos, límites y buenas prácticas - Credencial automática: al vincular la fuente a la bandeja de WhatsApp Cloud, la plataforma usa la credencial de esa bandeja — no necesitas registrar un token solo para el catálogo. - Las imágenes deben estar accesibles: la sincronización descarga las imágenes de los productos. Si la imagen original está alojada en una dirección que queda fuera de línea, no se importará. Mantén las imágenes en un lugar público y estable. - Importes en unidades mayores: los precios siguen en unidades mayores (4,97 = R$4,97) en ambos lados. - Realiza la primera sincronización fuera del horario pico para revisar el resultado con calma. Solución de problemas - Productos importados sin imágenes: la imagen original puede estar inaccesible; asegura una dirección pública y vuelve a sincronizar (cada ejecución reintenta la descarga de imágenes). - No se sincroniza nada: confirma que la fuente esté vinculada a una bandeja de WhatsApp Cloud válida y que el catálogo de Meta seleccionado sea el correcto. - Un cambio no apareció en el otro lado: espera el intervalo de sincronización o ejecuta una sincronización manual. Ver también - Catálogo nativo: productos, categorías, imágenes y precios - Enviar producto y recibir pedidos en la conversación - Visión general de Catálogo y Comercio
Enviar producto/lista y recibir pedidos en la conversación
Visión general Con el catálogo listo y sincronizado, puedes enviar productos al cliente dentro de la conversación y recibir su pedido de vuelta como una tarjeta estructurada. En lugar de describir precios en texto, envías el ítem correcto; cuando el cliente arma un carrito en WhatsApp, el pedido llega organizado, con ítems, cantidades y total — además de atajos para generar el cobro. Hay tres formas de mostrar productos: producto único, lista de productos y abrir el catálogo. Y una forma de recibir: el pedido (order) que se convierte en tarjeta en la conversación. Requisitos previos - Un catálogo nativo con productos y, para las funciones nativas de WhatsApp, la sincronización con el WhatsApp Business Catalog activa. - Una Bandeja de Entrada de WhatsApp (Cloud API) — los formatos nativos de producto, lista y pedido funcionan en la API Cloud. - Para cobrar el pedido: el módulo de Pagos configurado. Paso a paso 1. Abre la conversación con el cliente. 2. En el campo de envío, elige enviar producto y selecciona un ítem (producto único) o arma una lista de productos. También puedes abrir el catálogo para que el cliente navegue. 3. El cliente visualiza los productos en WhatsApp y, si quiere, agrega ítems al carrito. 4. Cuando el cliente finaliza el carrito, el pedido llega a la conversación como una tarjeta de pedido con los ítems, las cantidades y el total. 5. En la tarjeta del pedido, usa Crear cobro o Crear suscripción para facturar exactamente lo que se pidió — el importe ya viene precargado con el total del pedido. 6. Sigue el pago desde el módulo de Pagos; una vez confirmado, el cliente recibe la confirmación. Configuración y opciones - Producto único: envía un ítem específico del catálogo. - Lista de productos: envía varios ítems agrupados en un mensaje. - Abrir catálogo: invita al cliente a navegar por el catálogo en WhatsApp. - Tarjeta de pedido: muestra ítems, cantidades, total y observaciones del cliente. - Atajos del pedido: Crear cobro (pago único) y Crear suscripción (recurrente), ya precargados con el importe del pedido. - Producto referenciado: cuando el cliente responde citando un producto, aparece un indicador del ítem citado junto al mensaje. Casos de uso - El cliente pregunta por un ítem específico — envías el producto único con foto y precio. - Atención consultiva — envías una lista con las mejores opciones para que el cliente elija. - El cliente arma el carrito solo — el pedido llega listo y facturas en segundos. - Venta recurrente (suscripción/plan) — el pedido se convierte en una suscripción con el importe acordado. Consejos, límites y buenas prácticas - Cobra lo que se pidió: la tarjeta usa el total del pedido acordado con el cliente; el importe no se recalcula a partir de los precios actuales del catálogo. Facturar el pedido respeta exactamente lo que el cliente armó. - Importes en unidades mayores: el total es la suma de precio × cantidad (4,97 = R$4,97), sin dividir por 100. - Canal: producto, lista, catálogo y tarjeta de pedido nativos pertenecen a la API Cloud. En WhatsApp Web, usa la tarjeta de producto enriquecida como alternativa. - Revisa el pedido antes de cobrar: ítems, cantidades y total. Solución de problemas - El cliente no recibió el producto/lista nativos: confirma que la bandeja es WhatsApp Cloud API y que el catálogo está sincronizado. - El pedido no se convirtió en tarjeta: verifica que el pedido provino del carrito de WhatsApp; los pedidos de fuera de WhatsApp siguen el ciclo de vida de e-commerce. - Importe incorrecto al cobrar: la tarjeta precarga el total del pedido; si lo editas manualmente, recuerda las unidades mayores (no dividas por 100). Ver también - Catálogo nativo: productos, categorías, imágenes y precios - Sincronización y WhatsApp Business Catalog - Ciclo de vida de e-commerce
Ciclo de vida de e-commerce: webhooks Kiwify/Hotmart/Nuvemshop/Shopify
Visión general El ciclo de vida de e-commerce conecta plataformas externas — Kiwify, Hotmart, Nuvemshop y Shopify — para que los eventos de venta lleguen dentro de la atención. Cuando algo ocurre en la plataforma externa (carrito abandonado, PIX/boleto generado, compra aprobada, rechazada o reembolsada), ConversaLabs recibe el webhook, normaliza el evento y muestra una tarjeta en la conversación del cliente, con los datos de pago cuando están disponibles. Con esto, recuperas ventas sin cambiar de herramienta: el equipo ve la etapa de la compra en la propia conversación y puede activar Follow-ups automáticos para reconquistar a quien no finalizó. Requisitos previos - El módulo de Catálogo y Comercio habilitado y permiso para configurar fuentes de comercio. - Acceso a la plataforma externa (Kiwify, Hotmart, Nuvemshop o Shopify) para configurar el webhook. - Para la recuperación automática: el módulo de Follow-ups configurado con secuencias por evento. Paso a paso 1. En el área de Catálogo y Comercio, crea una fuente de comercio para la plataforma deseada. 2. Copia la URL de webhook generada para esa fuente y define el secreto de verificación cuando la plataforma lo exija. 3. Pega la URL en el panel de la plataforma externa (o usa el registro automático cuando esté disponible, por ejemplo en Kiwify y Nuvemshop). 4. Realiza una venta de prueba (o un carrito de prueba) para confirmar que el evento llega. 5. Observa la tarjeta del evento aparecer en la conversación del cliente, con ítems, importes y el enlace/datos de pago según la etapa. 6. Configura Follow-ups activados por evento (por ejemplo, "carrito abandonado") para recuperar la venta automáticamente. Configuración y opciones - Fuente de comercio: una por plataforma, con su propia URL de webhook y secreto de verificación. - Registro automático del webhook: disponible en algunas plataformas (ej.: Kiwify y Nuvemshop); en las demás, la configuración es manual en el panel de la propia plataforma. - Tarjeta del evento: muestra la etapa de la compra y, cuando la plataforma lo expone, datos de PIX/boleto y el enlace de checkout. - Variables de comercio: los datos del último evento quedan disponibles para usar en mensajes de Follow-up (enlace de pago, importe, código PIX/boleto, etc.). Casos de uso - Carrito abandonado: dispara una secuencia de Follow-up recordando al cliente que concluya. - PIX/boleto pendiente: reenvía el código de pago y hace seguimiento hasta confirmar. - Compra aprobada: confirma con el cliente y libera el siguiente paso de la atención. - Reembolso/rechazo: alerta al equipo para tratar el caso en la propia conversación. Consejos, límites y buenas prácticas - Lo que expone cada plataforma varía: algunas envían el código PIX y la línea del boleto en el evento (recuperación completa dentro de la conversación); otras solo proporcionan el enlace de checkout — en esos casos, la tarjeta muestra el enlace para que el cliente concluya. - Los importes y formatos difieren por plataforma: ConversaLabs normaliza cada evento; no necesitas preocuparte por la conversión — la tarjeta ya muestra el importe correcto. - Secreto de verificación: manténlo configurado para que solo se acepten eventos legítimos de la plataforma. - Combínalo con Follow-ups para automatizar la recuperación en lugar de depender de la acción manual. Solución de problemas - El evento no aparece: verifica que la URL de webhook se pegó correctamente en la plataforma y que el secreto de verificación coincide. - No veo PIX/boleto en la tarjeta: no todas las plataformas exponen esos datos; cuando no los hay, la tarjeta trae el enlace de checkout. - Eventos duplicados: la plataforma maneja repeticiones del mismo evento; si algo se ve extraño, verifica si hay más de un webhook configurado para la misma fuente. Ver también - Visión general de Catálogo y Comercio - Enviar producto y recibir pedidos en la conversación - Catálogo nativo: productos, categorías, imágenes y precios