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

Compartir productos con los clientes

Hay varias formas de compartir tus productos con los clientes:

Mensajes de catálogo: mensajes de formato libre que contienen un botón que, cuando se toca, muestra el catálogo de productos en WhatsApp.
Mensajes de plantilla de catálogo: mensajes de plantilla que contienen un botón que, cuando se toca, muestra el catálogo de productos en WhatsApp.
Mensajes con un enlace al catálogo: mensajes de formato libre que contienen miniaturas del catálogo y un enlace al catálogo completo de productos.
Mensajes de producto: mensajes de formato libre que contienen información sobre un solo producto o un máximo de 30 productos del catálogo de productos.
Mensajes de plantilla sobre varios productos: mensajes de plantilla que incluyen información sobre un máximo de 30 productos de tu catálogo de comercio electrónico, organizados en un máximo de diez secciones, en un único mensaje.

Mensajes de catálogo

Los mensajes de catálogo son mensajes de formato libre que te permiten mostrar el catálogo completo de productos en WhatsApp.

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

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

Requisitos

Debes tener el 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 extremo Número de teléfono de WhatsApp Business > Mensajes para enviar mensajes 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	Valor de ejemplo
`<BODY_TEXT>` Cadena	Obligatorio. Texto que aparecerá en el cuerpo del mensaje. Máximo 1024 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á en el pie de página del mensaje. Máximo 60 caracteres.	`Best grocery deals on WhatsApp!`
`<THUMBNAIL_PRODUCT_RETAILER_ID>` Cadena	Opcional. Número SKU del artículo. Etiquetado como identificador del contenido en Commerce Manager. La miniatura de este artículo se usará como imagen del encabezado del mensaje. Si el objeto `parameters` se omite, se usará la imagen del producto del primer artículo del catálogo.	`2lc20305pt`
`<TO>` Cadena	Número de teléfono del cliente.	`+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 toca, muestra el catálogo de productos en 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 cómo enviarlas en un mensaje de plantilla.

Mensajes con un enlace al catálogo

Puedes crear un enlace wa.me e incluirlo en un mensaje de texto estándar para enviar un enlace a tu catálogo completo de productos. Al enviar un mensaje de texto, puedes usar el parámetro opcional preview_url establecido en true para que el mensaje muestre un conjunto de miniaturas del catálogo de productos de cualquier URL de la cadena body del mensaje.

Ten en cuenta que, si desactivas el catálogo, los enlaces wa.me y el botón Ver catálogo de los mensajes con un enlace al catálogo mostrarán el mensaje Enlace al catálogo no válido al tocarlos.

Para crear un enlace wa.me, añade el número de teléfono de tu empresa, 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

Tanto los mensajes sobre varios productos como los mensajes sobre un solo producto son ejemplos de mensajes de tipo interactive.

Ejemplo de mensaje sobre varios productos:	Ejemplo de mensaje sobre un solo producto:

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

Información general

Los clientes que reciben mensajes sobre un solo producto y sobre varios pueden realizar tres acciones principales:

Ver productos: los clientes pueden ver una lista de productos o solo un producto. Cuando un cliente hace clic en un artículo específico, recuperamos la información más reciente del producto y mostramos el producto en un formato de página de detalles del producto (PDP). Actualmente, las PDP solo admiten imágenes de productos; los vídeos o los GIF añadidos al producto no se mostrarán en la PDP.
Añadir productos a un carrito: cada vez que un usuario añade un producto al carrito de la compra, recuperamos la información más reciente del artículo. Si se ha producido un cambio de estado en alguno de los artículos, mostramos un cuadro de diálogo con el mensaje “Uno o más artículos del carrito se han actualizado”. Consulta Actualizaciones de productos para obtener más información al respecto. Un carrito se mantiene en una conversación entre el cliente y tú hasta que se te envía el carrito. Consulta Experiencia del carrito de la compra para obtener más información al respecto.
Enviarte un carrito: después de añadir todos los artículos necesarios, los clientes pueden enviarte el carrito. A continuación, puedes definir los siguientes pasos, como solicitar la información de entrega o proporcionar las opciones de pago.

Si el cliente tiene varios dispositivos vinculados a su cuenta, los mensajes sobre un solo producto y sobre varios se sincronizarán entre los dispositivos. Sin embargo, el carrito de la compra es específico de cada dispositivo. Consulta Experiencia del carrito de la compra para obtener más información.

Actualmente, estos tipos de mensajes se pueden recibir en las siguientes plataformas:

iOS: 2.21.100 (mensajes sobre varios productos) y 2.21.210 (mensajes sobre un solo producto).
Android: 2.21.9.15 (mensajes sobre varios productos) y 2.21.19 (mensajes sobre un solo producto).
Web: se ha lanzado el cliente web que admite estas funciones.

Si la versión de la aplicación del cliente no admite los mensajes sobre un solo producto o sobre varios, recibirá un mensaje en el que se explicará que no ha podido recibir un mensaje porque utiliza una versión obsoleta de WhatsApp. También te enviaremos una notificación del webhook en la que se indicará que no se ha podido entregar el mensaje porque el cliente usa una versión obsoleta de WhatsApp.

Comportamiento esperado de los mensajes

Las siguientes acciones se pueden llevar a cabo con los mensajes sobre un solo producto y sobre varios:

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

Las siguientes acciones no se pueden llevar a cabo con los mensajes sobre un solo producto y sobre varios:

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

Limitaciones

A diferencia de los mensajes de productos enviados a través de la aplicación de WhatsApp Business, actualmente los mensajes enviados mediante la API de nube no muestran ningún icono de carrito de la compra en el encabezado del hilo del chat.

Actualizaciones de productos

Es posible que tengas que actualizar las propiedades de los artículos del catálogo. En función de la propiedad actualizada, tratamos de la siguiente manera los mensajes que mencionan dicho producto:

Propiedad actualizada	Proceso de actualización
Precio, título, descripción e imagen del producto.	Envías un mensaje sobre un solo producto o sobre varios que contiene el producto A. Actualizas las propiedades del producto A en el catálogo. Las pantallas que muestran dicho producto se actualizan en cuanto el cliente del cliente recibe la información sobre el cambio desde el servidor.
Cambio de disponibilidad	Envías a un cliente un mensaje sobre un solo producto o sobre varios que contiene el producto B. Vendes todas las unidades disponibles del producto B. Después, actualizas el catálogo para indicar que el producto B ya no está disponible. Si un cliente ya ha añadido el producto B a un carrito, el artículo se eliminará del carrito. El carrito de la compra mostrará un cuadro de diálogo con el mensaje “Uno o más artículos del carrito se han actualizado”. Si un cliente no ha añadido el producto B al carrito, ahora el mensaje sobre un solo producto o sobre varios indica 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 sobre un solo producto o sobre varios que contiene el producto A.
Actualizas las propiedades del producto A en el catálogo.
Las pantallas que muestran dicho producto se actualizan en cuanto el cliente del cliente recibe la información sobre el cambio desde el servidor.

Cambio de disponibilidad

Envías a un cliente un mensaje sobre un solo producto o sobre varios que contiene el producto B.
Vendes todas las unidades disponibles del producto B. Después, actualizas el catálogo para indicar que el producto B ya no está disponible.
Si un cliente ya ha añadido el producto B a un carrito, el artículo se eliminará del carrito. El carrito de la compra mostrará un cuadro de diálogo con el mensaje “Uno o más artículos del carrito se han actualizado”.
Si un cliente no ha añadido el producto B al carrito, ahora el mensaje sobre un solo producto o sobre varios indica que el artículo no está disponible.

Experiencia del carrito de la compra

Después de ver los productos, el cliente puede añadirlos a su carrito de la compra y enviártelo. A efectos comerciales en WhatsApp, un carrito de la compra tiene las siguientes particularidades:

Es específico de cada conversación entre una empresa y un cliente en un dispositivo concreto: solo se crea un carrito por conversación entre el cliente y tú, y los carritos no se mantienen entre varios dispositivos. Una vez enviado el carrito, el cliente puede abrir otro carrito con tu empresa y volver a empezar el proceso.
No tiene fecha de caducidad: el carrito se mantiene en la conversación hasta que se te envía. Una vez enviado, los artículos se borran del carrito.

Los clientes pueden añadir un máximo de 99 unidades de cada artículo del catálogo a un carrito de la compra, pero no existe ningún límite en cuanto a la variedad de artículos que se pueden añadir a un carrito.

Una vez enviado, un carrito no se puede editar. Los clientes pueden enviar un nuevo carrito si necesitan nuevos artículos o quieren cambiar el pedido. No puedes enviar carritos a los clientes.

Ejemplo de experiencia del carrito de la compra y comportamiento esperado para un cambio de estado de un artículo.

Por qué deberías utilizarlo

Tanto los mensajes sobre varios productos como los mensajes sobre un solo producto llevan a experiencias de usuario sencillas y personalizadas, con una mejor experiencia para guiar al cliente a un subconjunto de los artículos más pertinentes para dicho cliente, en lugar de explorar todo tu inventario.

Sencillez y eficacia

Se combinan las funciones con herramientas de navegación, tales como el procesamiento de lenguaje natural, la búsqueda de texto o los mensajes de lista y los botones de respuesta, para llegar a lo que busca el cliente más rápido.

Personalización

Esta función se rellena dinámicamente, por lo que puede personalizarse según el cliente o la situación. Por ejemplo, puedes mostrar un mensaje sobre varios productos de los artículos que el cliente pide con mayor frecuencia.

Resultados empresariales

Un canal eficaz para impulsar los pedidos: durante las pruebas, las empresas tuvieron una conversión promedio del 7 % en los mensajes sobre varios productos enviados a los carritos recibidos.

Sin plantillas

Los mensajes interactivos no necesitan plantillas ni aprobaciones previas. Se generan en tiempo real y siempre reflejarán la información, los precios y las existencias en el inventario más recientes del artículo.

Cuándo deberías utilizar esta función

Los mensajes sobre varios productos son ideales para guiar a los clientes a un subconjunto específico de tu inventario:

Compras mediante conversaciones. Por ejemplo, el uso de una funcionalidad de búsqueda para permitir que los clientes escriban una lista de la compra y responder con un mensaje sobre varios productos.
Navegación a una categoría específica. Por ejemplo, ropa deportiva.
Ofertas o recomendaciones personalizadas.
Nuevos pedidos de artículos adquiridos previamente. Por ejemplo, un usuario puede volver a hacer su pedido para llevar habitual de menos de 30 artículos.

Los mensajes sobre un solo producto son ideales para guiar a los clientes a un artículo específico de tu inventario y ofrecen respuestas rápidas a partir de un conjunto limitado de opciones:

Respuesta a una solicitud específica de un cliente.
Recomendación.
Nuevos pedidos de artículos anteriores.

Estas dos funciones también se pueden usar como parte de un proceso con agentes humanos, pero tienes que crear las herramientas adecuadas para que el agente humano pueda generar un mensaje sobre un solo producto o sobre varios en la conversación.

Introducción

Antes de enviar mensajes de productos, sigue los primeros pasos que mejor se adapten a tus necesidades:

Todas las llamadas a la API mencionadas en esta guía se deben autenticar con un identificador de acceso. Los desarrolladores pueden autenticar sus llamadas a la API con el identificador de acceso generado en la ventana del panel de aplicaciones > WhatsApp > Configuración de la API. Los socios de soluciones deben autenticarse mediante un identificador de acceso con el permiso whatsapp_business_messaging.

Paso 1: Crear el objeto interactivo

Mensajes sobre un solo producto

Para enviar un mensaje sobre un solo producto, crea un objeto interactive de tipo product con los siguientes componentes:

Componentes obligatorios	Componentes opcionales
Objeto de acción: debe incluir catalog_id y product_retailer_id.	Objeto de cuerpo Objeto de pie de página

Consulta Mensajes, Objeto interactivo para obtener más información. Al final del proceso, el objeto interactivo debería tener un aspecto similar al siguiente:

{
  "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 sobre varios productos

Para enviar un mensaje sobre varios productos, crea un objeto interactive de tipo product_list con los siguientes componentes:

Componentes obligatorios	Componentes opcionales
Objeto de encabezado: el tipo de encabezado debe estar definido como texto. Recuerda añadir un objeto de texto con el contenido deseado. Objeto de cuerpo Objeto de acción: debe incluir catalog_id y sections. Sections debe ser una matriz de objetos que describan cada sección mediante title y product_items. El valor de product_items de cada sección debe ser una matriz que describa cada producto de la sección mediante product_retailer_id y el número de SKU del producto.	Objeto de pie de página

Componentes obligatorios

Componentes opcionales

Objeto de encabezado: el tipo de encabezado debe estar definido como texto. Recuerda añadir un objeto de texto con el contenido deseado.
Objeto de cuerpo
Objeto de acción: debe incluir catalog_id y sections.
- Sections debe ser una matriz de objetos que describan cada sección mediante title y product_items.
  - El valor de product_items de cada sección debe ser una matriz que describa cada producto de la sección mediante product_retailer_id y el número de SKU del producto.

Objeto de pie de página

Consulta Mensajes, Objeto interactivo para obtener más información. Al final del proceso, el objeto interactivo debería tener un aspecto similar al siguiente:

{
  "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 anteriores coincide con un producto de tu catálogo de productos, se envía un mensaje de error y el mensaje sobre un solo producto o sobre varios no se envía al usuario.

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

Los mensajes se envían correctamente.
Los artículos sin coincidencia se eliminan.
Recibes un mensaje de error en el que se te solicita que actualices el catálogo.

Paso 2: Añadir parámetros de mensajes comunes

Una vez completado el objeto interactivo, añade los demás parámetros que forman un mensaje: recipient_type, to, messaging_product y type. Recuerda definir el valor de type como 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 ver todos los parámetros disponibles, consulta Referencia, Mensajes.

Paso 3: Enviar una solicitud al extremo de mensajes

Envía una solicitud POST al extremo /PHONE_NUMBER_ID/messages con el objeto JSON que has creado en los pasos 1 y 2. Si el mensaje se envía correctamente, recibirás la siguiente respuesta:

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

Mensajes de plantilla sobre varios productos

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

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