Compartir productos con los clientes

Las empresas tienen varias opciones para compartir 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 que contienen miniaturas del catálogo y un enlace a todo el catálogo de productos.
• Mensajes de productos: mensajes 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": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

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

Propiedades

Ejemplo de solicitud

{
  "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

Las empresas pueden crear un enlace wa.me e incluirlo en un mensaje de texto estándar para enviar un enlace a todo su catálogo de productos. Al enviar un mensaje de texto, las empresas pueden usar el parámetro opcional preview_url definido como 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 las empresas inhabilitan 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 la empresa con 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 usuarios que reciben mensajes sobre un solo producto y sobre varios pueden realizar tres acciones principales:

1. Ver productos: los clientes pueden ver una lista de productos o solo un producto. Cuando un usuario 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.
2. Añadir productos a un carrito: un usuario puede añadir un producto a su carrito o modificar las cantidades directamente desde la lista o en la página de detalles del producto. 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 la empresa y el cliente hasta que se envía a la empresa. Consulta Experiencia del carrito de la compra para obtener más información al respecto.
3. Enviar un carrito de la compra a la empresa: después de añadir todos los artículos necesarios, los clientes pueden enviar su carrito a la empresa con la que intercambian mensajes. A continuación, las empresas pueden definir los siguientes pasos, como solicitar la información de entrega o proporcionar las opciones de pago.

Si un cliente tiene varios dispositivos enlazados a la misma cuenta de WhatsApp, 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 destinatario 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. La empresa también recibirá una notificación del webhook en la que se indicará que no se ha podido entregar el mensaje porque el destinatario 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 de catálogo ni los mensajes sobre un solo producto y sobre varios:

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

Actualizaciones de productos

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

Experiencia del carrito de la compra

Después de ver los productos, el cliente puede añadirlos a su carrito de la compra y enviar el carrito a una empresa. 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 usuario en un dispositivo concreto: solo se crea un carrito por conversación entre el cliente y la empresa, y los carritos no se mantienen entre varios dispositivos. Una vez enviado un carrito, el cliente puede abrir otro carrito con la empresa y volver a empezar el proceso.
• No tiene fecha de caducidad: el carrito se mantiene en la conversación hasta que se envía a la empresa. 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. Las empresas no pueden 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 utilizar esta función

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 relevantes para él, en lugar de explorar todo el inventario de una empresa.

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 del inventario de una empresa:

• 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 del inventario de una empresa 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 cada mensaje, tienes que obtener el identificador de WhatsApp del destinatario con una llamada al nodo /contacts.

Te recomendamos configurar webhooks para recibir notificaciones de mensajes entrantes y de estado de mensajes. De esta forma, puedes comprobar si se ha enviado un mensaje y consultar las respuestas de los clientes.

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:

Al final, el objeto interactivo debería tener un aspecto similar al siguiente:

"interactive": {
    "type": "product",
    "body": {
      "text": "text-body-content"
    },
    "footer": {
      "text": "text-footer-content"
    },
    "action": {
      "catalog_id": "catalog-id",
      "product_retailer_id": "product-SKU-in-catalog"
    }
}

Mensajes sobre varios productos

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

Al final, el objeto interactive debería tener un aspecto similar al siguiente:

"interactive": 
    {
    "type": "product_list",
    "header":{
       "type": "text",
        "text": "text-header-content"
     },
     "body":{
        "text": "text-body-content"
      },
     "footer":{
        "text":"text-footer-content"
     },
     "action":{
        "catalog_id":"catalog-id",
        "sections": [
             {
             "title": "the-section-title",             
             "product_items": [
                  { "product_retailer_id": "product-SKU-in-catalog" },
                  { "product_retailer_id": "product-SKU-in-catalog" },
                            ...
              ]},
              {
              "title": "the-section-title",
              "product_items": [
                 { "product_retailer_id": "product-SKU-in-catalog" }
                           ...
              ]},
               ...
       ]
     },  
    }

Artículos que faltan

Si ninguno de los artículos proporcionados en las llamadas a la API anteriores coincide con un producto del catálogo de Facebook de la empresa, 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 del catálogo de Facebook de la empresa. En este caso:

• Los mensajes se envían correctamente.
• Los artículos sin coincidencia se eliminan.
• La empresa recibe un mensaje de error en el que se solicita una actualización del 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 y type. Recuerda definir el valor de type como interactive.

{
  "recipient_type": "individual",
  "to" : "whatsapp-id", // WhatsApp ID of the recipient
  "type": "interactive",
  "interactive":{
    // The interactive object  
   }
  }

Consulta los parámetros comunes a todos los tipos de mensajes aquí.

Paso 3: Realizar una llamada POST a /messages

Realiza una llamada POST al extremo /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:

{
  "messages": [{
    "id": "{message-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.