Enviar producto/lista y recibir pedidos en la conversación

Abrir en

Ver como Markdown

Abrir en ChatGPT Abrir en Claude

Conversa Labs

Última actualización el 27 de sep de 2026

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.
El escaparate activo en el número, en la pestaña Catálogo y Escaparate de la bandeja de entrada. Meta crea cada número con el escaparate desactivado: sin activarlo, el envío de un producto falla con el error #131008. Consulta Catálogo y Escaparate en la bandeja de entrada de WhatsApp.
Para el envío interactivo de un producto por WhatsApp Web, basta una bandeja Web activa; el envío de carritos y listas nativos sigue siendo exclusivo de la API Cloud. El pedido que el cliente envía desde el carrito también llega por WhatsApp Web y se convierte en tarjeta de pedido cuando la plataforma consigue leer sus ítems a través del número conectado.
Para cobrar el pedido: el módulo de Pagos configurado.

Paso a paso

Abre la conversación con el cliente.
En el campo de envío, elige enviar producto y selecciona un ítem (producto único) o arma una lista de productos. Cuando exista más de una variante, elige la correcta; cuando esa variante tenga precios en más de una moneda, elige también la moneda. Puedes además abrir el catálogo para que el cliente navegue.
En la API Cloud, el cliente puede agregar ítems al carrito. En WhatsApp Web, usa Me interesa o Ver producto en la tarjeta interactiva.
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.
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.
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.
Variante y moneda: la tarjeta usa la variante elegida y el precio registrado para la moneda elegida; la selección no vuelve silenciosamente a la primera variante.
Lista de productos: envía varios ítems agrupados en un mensaje y conserva la variante y la moneda elegidas para cada producto.
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.
API Cloud: el formato nativo se usa solo cuando la variante elegida está publicada con su propio retailer_id y usa la moneda publicada. De lo contrario, la plataforma envía la tarjeta enriquecida con la variante y el precio exactos, sin sustituir el ítem.
WhatsApp Web: un producto único se envía como tarjeta interactiva con el botón Me interesa y, cuando el registro tiene un enlace público, Ver producto. El envío no requiere una licencia adicional.
Revisa el pedido antes de cobrar: ítems, cantidades y total.
Nombre y foto de los productos: la plataforma busca el producto en este orden: el catálogo nativo de la plataforma; lo que ya aprendió sobre el producto en pedidos anteriores; el propio WhatsApp, a través del número conectado; y el catálogo de Meta, cuando el token de la bandeja tiene permiso de lectura. El nombre y la foto pueden aparecer unos segundos después de la tarjeta, sin recargar la página. El precio y la cantidad siempre vienen del pedido del cliente.
Bandeja híbrida (Coexistencia + WhatsApp Web en el mismo número): la tarjeta sigue siendo una sola. La copia que llega por WhatsApp Web solo completa el nombre y la foto del producto en la tarjeta de Coexistencia; nunca crea un segundo mensaje.

Solución de problemas

El envío falló con el error #131008: el escaparate no está utilizable en el número — el catálogo no está vinculado a la Cuenta de WhatsApp Business o el escaparate está desactivado. Abre la pestaña Catálogo y Escaparate de la bandeja de entrada, selecciona el catálogo y haz clic en Activar escaparate en este número. Detalles en Catálogo y Escaparate en la bandeja de entrada de WhatsApp.
El cliente no recibió el producto/lista nativos: confirma que la bandeja es WhatsApp Cloud API y que el catálogo está sincronizado. Comprueba también si la variante elegida tiene su propio retailer_id; sin él, recibir la tarjeta enriquecida es el fallback esperado.
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).
La tarjeta muestra un código en lugar del nombre del producto: el código es el identificador del producto en el catálogo de WhatsApp. Aparece cuando el producto no está en el catálogo nativo de la plataforma y ninguna otra fuente informó el nombre; por ejemplo, cuando el catálogo del número es el de la aplicación WhatsApp Business y el token de la API Cloud no tiene permiso para leerlo. En una bandeja híbrida, la copia de WhatsApp Web completa el nombre y la foto automáticamente. Para resolverlo de forma permanente, sincroniza ese catálogo con el catálogo nativo. La plataforma nunca inventa un nombre.
Un pedido de WhatsApp Web muestra solo el total, sin los ítems: la plataforma no consiguió leer los ítems del pedido a través del número conectado, por ejemplo porque WhatsApp Web estaba desconectado en ese momento, o los ítems leídos no coinciden con la cantidad y el total del pedido. En ese caso la plataforma no arma una tarjeta parcial, que cobraría menos de lo que pidió el cliente. La tarjeta muestra lo que trajo el mensaje; confirma los ítems con el cliente antes de cobrar.

Ver también

Comprobaciones de disponibilidad y entrega

Antes de crear el mensaje saliente, el catálogo comprueba la disponibilidad y los precios representados en la tarjeta. Una variante predeterminada agotada se sustituye por una disponible; una variante no disponible seleccionada explícitamente se rechaza. No se envía un producto sin variantes disponibles. Una variante disponible genera una tarjeta, aunque el producto tenga varias fotos. Las variantes sin control de inventario siguen disponibles.

Las descripciones se envían sin etiquetas HTML. Las imágenes de WhatsApp se preparan en un formato compatible; si falla la preparación, sustituya la imagen y reintente. Corrija cualquier precio inválido en el catálogo. Una solicitud exitosa indica que el mensaje entró en la cola; compruebe su estado de entrega en la conversación. Los envíos automáticos mantienen como autor al bot autenticado de la bandeja.

Historial de pedidos y citas

Las tarjetas recibidas por WhatsApp Web muestran el producto, el total y las actualizaciones que realmente contiene el mensaje. Una actualización de pedido completado no confirma el pago: compruébalo en el módulo o proveedor correspondiente. La cita de un producto conserva su nombre y precio cuando están disponibles y permite volver al mensaje original.

Esta presentación también se aplica a mensajes antiguos al recargar la conversación, siempre que se hayan conservado los datos de la tarjeta. Recargar no reenvía el pedido ni realiza un cobro. Si los datos de origen nunca llegaron, la plataforma no inventa artículos, importes ni confirmaciones de pago.