Plataforma de WhatsApp Business > API de la nube > Guías

Compartir productos con los clientes

Puedes compartir productos con tus clientes de diferentes maneras:

Mensajes de catálogo: mensajes de formato libre con un botón que, cuando se lo toca, muestra tu catálogo de productos dentro de WhatsApp.
Mensajes de plantilla de catálogo: mensajes de plantillas con un botón que, cuando se lo toca, muestra tu catálogo de productos dentro de WhatsApp.
Mensajes con enlace al catálogo: mensajes sin formato que contienen imágenes en miniatura del catálogo y un enlace al catálogo completo de productos.
Mensajes de productos: mensajes sin formato que contienen información de un solo producto o de hasta 30 productos de tu catálogo.
Mensajes de plantilla multiproducto: mensajes de plantilla que contienen información de hasta 30 productos de tu catálogo de comercio electrónico, organizados en un máximo de 10 secciones, en un solo mensaje.

Mensajes de catálogo

Los mensajes de catálogo son mensajes de formato libre que te permiten exhibir todo tu catálogo de productos dentro de WhatsApp.

Los mensajes de catálogo muestran una imagen en miniatura de un producto de tu elección, texto personalizado en el cuerpo del mensaje, un encabezado de texto fijo, un subencabezado de texto fijo y un botón Ver catálogo.

Cuando un cliente toca el botón Ver catálogo, tu catálogo de productos aparece dentro de WhatsApp.

Requisitos

En necesario que cuentes con un inventario subido a Meta en un catálogo de comercio electrónico conectado a tu cuenta de WhatsApp Business.

Sintaxis de la solicitud

Usa el punto de conexión Número de teléfono de WhatsApp Business > Mensajes para enviar un mensaje de catálogo.

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Cuerpo de la solicitud POST

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<TO>",
  "type": "interactive",
  "interactive" : {
    "type" : "catalog_message",
    "body" : {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "catalog_message",
      
      /* Parameters object is optional */
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

    /* Footer object is optional */
    "footer": {
      "text": "<FOOTER_TEXT>"
  }
}

Propiedades

Marcador de posición	Descripción	Ejemplo de valor
`<BODY_TEXT>` Cadena	Obligatorio. Texto que aparecerá en el cuerpo del mensaje. No debe superar los 1.024 caracteres.	`Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase.`
`<FOOTER_TEXT>` Cadena	Opcional. Texto que aparecerá al pie del mensaje. No debe superar 60 caracteres.	`Best grocery deals on WhatsApp!`
`<THUMBNAIL_PRODUCT_RETAILER_ID>` Cadena	Opcional. Número de SKU del artículo. Se conoce como identificador de contenido en el administrador de ventas. La imagen en miniatura de este artículo se utilizará como imagen de encabezado del mensaje. Si se omite el objeto `parameters`, se utilizará la imagen del producto del primer artículo del catálogo.	`2lc20305pt`
`<TO>` Cadena	Número de teléfono personalizado.	`+16505551234`

Ejemplo de solicitud

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": {
      "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "2lc20305pt"
      }
    },
    "footer": {
      "text": "Best grocery deals on WhatsApp!"
    }
  }
}'

Ejemplo de respuesta

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

Mensajes de plantilla de catálogo

Los mensajes de plantilla de catálogo son mensajes de plantilla con un botón que, cuando se lo toca, muestra un catálogo de productos dentro de WhatsApp.

Para enviar un mensaje de plantilla de catálogo, necesitas una plantilla de catálogo. Consulta nuestro documento Plantillas de catálogo para obtener información sobre cómo crear estas plantillas y enviarlas en un mensaje de plantilla.

Mensajes con enlace al catálogo

Puedes enviar un enlace a tu catálogo completo de productos. Para ello, es necesario que crees un enlace wa.me y los incluyas en un mensaje de texto estándar. Cuando envías un mensaje de texto, tienes la opción de configurar preview_url en true para hacer que el mensaje muestre una serie de imágenes en miniatura del catálogo de productos de cualquier URL en la cadena body del mensaje.

Ten en cuenta que, si inhabilitas el catálogo, cuando se toquen los enlaces wa.me y el botón Ver catálogo en los mensajes con enlace al catálogo, se mostrará el mensaje Enlace al catálogo no válido.

Para crear un enlace wa.me, agrega tu número de teléfono del negocio, incluido el código de país, al final de la siguiente cadena:

https://wa.me/c/

Por ejemplo:

https://wa.me/c/15555455657

Mensajes de productos

Los mensajes multiproducto y de un solo producto son tipos de mensajes interactive.

Ejemplo de mensaje multiproducto:	Ejemplo de mensaje de un solo producto:

Menú que se activa cuando un usuario hace clic en "Empezar a comprar":	Ejemplo de página de detalles del producto:

Información general

Los clientes que reciben mensajes multiproducto o de un solo producto pueden realizar tres acciones principales:

Ver productos: los clientes pueden ver una lista de productos o solo un producto. Cada vez que un cliente hace clic en un artículo específico, recuperamos la información más reciente del producto y lo mostramos en formato de página de detalles del producto (PDP). Por el momento, este formato solo admite imágenes de productos, es decir, los videos y/o GIF que se agregan al producto no se muestran en la PDP.
Agregar productos a un carrito: cada vez que un usuario agrega un producto al carrito de compras, recuperamos la información más reciente del artículo. Si cambió el estado de alguno de los artículos, mostramos un cuadro de diálogo con el mensaje "Se actualizaron uno o más artículos de tu carrito". Consulta Novedades de productos para obtener más información. El carrito se mantiene en la conversación de chat entre el cliente y tú hasta que te lo envían. Consulta Experiencia con el carrito de compras para obtener más detalles.
Enviarte un carrito de compras: después de agregar todos los artículos necesarios, los clientes pueden enviarte su carrito. Luego, puedes definir los pasos a seguir, como solicitar información de envío u ofrecer opciones de pago.

Si el cliente tiene varios dispositivos vinculados a su cuenta, los mensajes multiproducto y de un solo producto se sincronizarán en todos los dispositivos. Sin embargo, el carrito de compras es específico de cada dispositivo. Consulta Experiencia con el carrito de compras para obtener más detalles.

Por el momento, estos tipos de mensajes se pueden recibir en las siguientes plataformas:

iOS: 2.21.100 (mensajes multiproducto) y 2.21.210 (mensajes de un solo producto).
Android: 2.21.9.15 (mensajes multiproducto) y 2.21.19 (mensajes de un solo producto).
Web: se lanzó el cliente web, que admite estas funciones.

Si la versión de la app del cliente no admite mensajes multiproducto o de un solo producto, la persona recibirá un mensaje que le indicará que no pudo recibir un mensaje debido a que está usando una versión desactualizada de WhatsApp. Además, te enviaremos una notificación de webhook que te indicará que no se pudo entregar el mensaje debido a que el cliente está usando una versión desactualizada de WhatsApp.

Comportamiento previsto de los mensajes

Acciones que se pueden realizar con los mensajes multiproducto o de un solo producto:

Un usuario los puede reenviar a otro.
Un usuario puede volver a abrirlos dentro de la misma conversación.

Acciones que no se pueden realizar con los mensajes multiproducto o de un solo producto:

No se pueden enviar como notificaciones. Solo se pueden enviar como parte de conversaciones preexistentes.

Limitaciones

A diferencia de los mensajes multiproducto que se envían a través de la app de WhatsApp Business, por el momento, los mensajes que se envían a través de la API de la nube no incluyen el icono del carrito de compras en el encabezado de la conversación de chat.

Novedades de productos

Es posible que debas actualizar las propiedades de los artículos de tu catálogo. Según la propiedad que actualices, así manejaremos los mensajes en los que se mencione el producto:

Propiedad actualizada	Proceso de actualización
Precio, título, descripción e imagen del producto.	Envías un mensaje multiproducto o de un solo producto, que contiene el producto A. Actualizas las propiedades del producto A en tu catálogo. Las pantallas en las que se muestra el producto se actualizan no bien el cliente se entera del cambio por medio del servidor.
Cambio de disponibilidad	Envías a un cliente un mensaje multiproducto o de un solo producto, que contiene el producto B. Vendes todas las unidades disponibles del producto B. Luego, actualizas el catálogo e indicas que el producto B ya no está disponible. Si un cliente ya agregó el producto B a su carrito, el artículo se eliminará. En el carrito de compras, se mostrará un cuadro de diálogo con el mensaje "Se actualizaron uno o más artículos del carrito". Si un cliente no agregó el producto B al carrito, el mensaje multiproducto o de un solo producto indicará que el artículo no está disponible.

Propiedad actualizada

Proceso de actualización

Precio, título, descripción e imagen del producto.

Envías un mensaje multiproducto o de un solo producto, que contiene el producto A.
Actualizas las propiedades del producto A en tu catálogo.
Las pantallas en las que se muestra el producto se actualizan no bien el cliente se entera del cambio por medio del servidor.

Cambio de disponibilidad

Envías a un cliente un mensaje multiproducto o de un solo producto, que contiene el producto B.
Vendes todas las unidades disponibles del producto B. Luego, actualizas el catálogo e indicas que el producto B ya no está disponible.
Si un cliente ya agregó el producto B a su carrito, el artículo se eliminará. En el carrito de compras, se mostrará un cuadro de diálogo con el mensaje "Se actualizaron uno o más artículos del carrito".
Si un cliente no agregó el producto B al carrito, el mensaje multiproducto o de un solo producto indicará que el artículo no está disponible.

Experiencia con el carrito de compras

Después de ver los productos, el cliente puede agregarlos a su carrito de compras y enviártelo. A los fines del comercio en WhatsApp, un carrito de compras tiene las siguientes características:

Es exclusivo de una conversación de chat entre un cliente y una empresa en un dispositivo específico: solo se crea un carrito por conversación de chat entre un cliente y tú. Los carritos no se sincronizan entre diferentes dispositivos. Una vez que se envía un carrito, el cliente puede abrir otro contigo y volver a iniciar el proceso.
No tiene fecha de vencimiento: el carrito persiste en la conversación de chat hasta que se envía a tu negocio. Una vez que se envía, el carrito se vacía.

Los clientes pueden agregar a un carrito de compras hasta 99 unidades de cada artículo del catálogo, pero pueden agregar una cantidad ilimitada de artículos diferentes.

Una vez que se envía un carrito, no se pueden realizar cambios. Los clientes pueden enviar un nuevo carrito si necesitan artículos nuevos o si desean cambiar su pedido. No puedes enviar carritos a los clientes.

Ejemplo de experiencia con carrito de compras y comportamiento esperado del cambio de estado de un artículo.

Por qué debes usar este recurso

Tanto los mensajes multiproducto como los de un solo producto funcionan mejor con experiencias de usuario más simples y personalizadas, en las que es más conveniente guiar al cliente hacia un subconjunto de artículos que le resultará más relevante, en lugar de explorar tu inventario completo.

Es simple y eficaz

Combina las funciones con herramientas de navegación, como NLP, búsqueda de texto o mensajes de listas y botones "Responder" para obtener de manera rápida lo que el cliente busca.

Es personalizable

Se completa de forma dinámica, de modo que se puede personalizar según el cliente o la situación. Por ejemplo, puedes mostrar un mensaje multiproducto de los artículos que un cliente pide con más frecuencia.

Está orientado a resultados comerciales

Es un canal efectivo para aumentar los pedidos: durante las pruebas en empresas, el 7 % de los mensajes multiproducto enviados se recibieron de regreso como carritos (en promedio).

No tiene plantillas

Los mensajes interactivos no necesitan plantillas ni aprobaciones previas. Se generan en tiempo real y siempre reflejan los detalles más recientes de los artículos, los precios y los niveles de existencias del inventario.

¿Cuándo debes utilizarlo?

Los mensajes multiproducto funcionan mejor para guiar a los clientes hacia un subconjunto específico de tu inventario, por ejemplo:

Comprar durante una conversación. Por ejemplo, usar una funcionalidad de búsqueda para permitir a los clientes escribir una lista de compras y enviar como respuesta un mensaje multiproducto.
Navegar hasta una categoría específica. Por ejemplo, indumentaria para hacer ejercicio.
Ofertas o recomendaciones personalizadas.
Volver a pedir artículos que ya se pidieron. Por ejemplo, un usuario puede volver a hacer un pedido habitual para retirar que tenga menos de 30 artículos.

Los mensajes de un solo producto funcionan mejor para guiar a los clientes hacia un artículo específico de tu inventario, ya que ofrecen respuestas rápidas a partir de una serie limitada de opciones, por ejemplo:

Responder a una solicitud específica de un cliente.
Proporcionar una recomendación.
Volver a pedir un artículo que ya se pidió.

Ambas funciones también se pueden usar como parte de un proceso de agente humano. Sin embargo, debes compilar las herramientas que permitan al agente humano generar un mensaje multiproducto o de un solo producto en una conversación.

Primeros pasos

Antes de enviar mensajes de productos, sigue los primeros pasos apropiados según tus necesidades:

Todas las llamadas a la API que se mencionan en esta guía se deben autenticar con un token de acceso. Los desarrolladores pueden autenticar sus llamadas a la API con el token de acceso que se genera en Panel de apps > WhatsApp > Configuración de la API. Los socios de soluciones deben autenticarse con un token de acceso mediante el permiso whatsapp_business_messaging.

Paso 1: Crear el objeto interactivo

Mensajes de un solo producto

Para enviar un mensaje de un solo producto, crea un objeto interactive del tipo product con estos componentes:

Componentes obligatorios	Componentes opcionales
Objeto Action: debe incluir catalog_id y product_retailer_id.	Objeto Body Objeto Footer

Consulta Mensajes, Objeto interactivo para obtener más información. Tras finalizar el proceso, el objeto interactivo deberá tener el siguiente aspecto:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "product_retailer_id": "ID_TEST_ITEM_1"
    }
  }
}

Mensajes multiproducto

Para enviar un mensaje multiproducto, crea un objeto interactive del tipo product_list con estos componentes:

Componentes obligatorios	Componentes opcionales
Objeto Header: el tipo de encabezado se debe configurar como texto. Recuerda agregar un objeto de texto con el contenido deseado. Objeto Body Objeto Action: debe incluir catalog_id y sections. El campo sections debe ser una matriz de objetos que describa cada sección con un título y product_items. En cada sección, el valor de product_items debe ser una matriz que describa cada producto de la sección con un product_retailer_id y el número de SKU del producto.	Objeto Footer

Componentes obligatorios

Componentes opcionales

Objeto Header: el tipo de encabezado se debe configurar como texto. Recuerda agregar un objeto de texto con el contenido deseado.
Objeto Body
Objeto Action: debe incluir catalog_id y sections.
- El campo sections debe ser una matriz de objetos que describa cada sección con un título y product_items.
  - En cada sección, el valor de product_items debe ser una matriz que describa cada producto de la sección con un product_retailer_id y el número de SKU del producto.

Objeto Footer

Consulta Mensajes, Objeto interactivo para obtener más información. Tras finalizar el proceso, el objeto interactivo deberá tener el siguiente aspecto:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header":{
      "type": "text",
      "text": "HEADER_CONTENT"
    },
    "body": {
      "text": "BODY_CONTENT"
    },
    "footer": {
      "text": "FOOTER_CONTENT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "sections": [
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]

        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}

Artículos que faltan

Si ninguno de los artículos proporcionados en las llamadas a la API que se muestran arriba coincide con un producto de tu catálogo, se devuelve un mensaje de error y no se envía al usuario el mensaje multiproducto o de un solo producto.

En el caso de los mensajes multiproducto, al menos un artículo de la lista de productos debe coincidir con un artículo de tu catálogo. En este caso:

Los mensajes se envían correctamente.
Se omiten los artículos que no tienen coincidencias.
Recibes un mensaje de error en el que se te pide que actualices el catálogo.

Paso 2: Agregar parámetros comunes de mensajes

Una vez que el objeto interactivo está completo, adjunta los otros parámetros que forman un mensaje: recipient_type, to, messaging_product y type. Recuerda configurar type en interactive.

curl -X  POST https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

Para conocer todos los parámetros disponibles, consulta Referencia, Mensajes.

Paso 3: Enviar una solicitud al punto de conexión de mensajes

Envía una solicitud POST al punto de conexión /PHONE_NUMBER_ID/messages con el objeto JSON que creaste en los pasos 1 y 2. Si tu mensaje se envía correctamente, recibes la siguiente respuesta:

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

Mensajes de plantillas multiproducto

Para enviar un mensaje de plantilla multiproducto, necesitas una plantilla de mensajes multiproducto. Consulta nuestro documento Plantillas de mensajes multiproducto para aprender a crear estas plantillas y enviarlas en un mensaje de plantilla.

Plataforma de WhatsApp Business | API de la nube | API de administración de WhatsApp Business