Compartir productos con los clientes

Las empresas tienen varias maneras de compartir productos con los clientes:

• 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 que contienen imágenes en miniatura del catálogo y un enlace al catálogo completo de productos.
• Mensajes de productos: mensajes 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

Es 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 publicación

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

Las empresas pueden enviar un enlace a su catálogo completo de productos. Para ello, deben crear un enlace wa.me e incluirlo en un mensaje de texto estándar. Cuando envían un mensaje de texto, las empresas tienen 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 una empresa inhabilita el catálogo, cuando toques 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 el número de teléfono comercial de la 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

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 usuarios que reciben mensajes multiproducto o de un solo producto pueden realizar tres acciones principales:

1. Ver productos: los clientes pueden ver una lista de productos o solo un producto. Cada vez que un usuario 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 de 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 mostrarán en la PDP.
2. Agregar productos a un carrito: un usuario puede agregar un producto al carrito o modificar las cantidades directamente desde la lista o en la página de detalles del producto. 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 la empresa y el cliente hasta que se lo envía a la empresa. Consulta Experiencia con el carrito de compras para obtener más detalles.
3. Enviar un carrito de compras a la empresa: después de agregar todos los artículos necesarios, los clientes pueden enviar su carrito a la empresa con la que están intercambiando mensajes. Después, las empresas pueden definir los pasos a seguir, como solicitar información de envío u ofrecer opciones de pago.

Si un cliente tiene varios dispositivos vinculados a la misma cuenta de WhatsApp, 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 destinatario 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 usa una versión desactualizada de WhatsApp. Además, la empresa recibirá una notificación de webhook que le indicará que no se pudo entregar el mensaje debido a que el destinatario usa una versión desactualizada de WhatsApp.

Comportamiento esperado de los mensajes

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

• Los puede reenviar un usuario a otro.
• Un usuario puede reabrirlos dentro de la misma conversación.

Los mensajes de catálogo y los mensajes multiproducto o de un solo producto:

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

Novedades de productos

Es posible que las empresas deban actualizar las propiedades de los artículos de sus catálogos. Según la propiedad que actualicen, así manejaremos los mensajes en los que se mencione el producto:

Experiencia con el carrito de compras

Después de ver los productos, el cliente puede agregarlos a su carrito de compras y enviar el carrito a una empresa. 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 una persona y una empresa en un dispositivo específico: solo se crea un carrito por conversación de chat entre un cliente y una empresa, y los carritos no se sincronizan entre diferentes dispositivos. Una vez que se envía un carrito, el cliente puede abrir otro con la empresa 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 la empresa. 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. Las empresas no pueden enviar carritos a los clientes.

Ejemplo de experiencia con carrito de compras y comportamiento esperado en caso de que cambie el estado de un artículo.

Por qué debes usar este recurso

Los mensajes multiproducto y de un solo mensaje son propicios para brindar experiencias de usuario simples y personalizadas: la mejor experiencia es aquella que permite guiar al cliente a un subconjunto de artículos que le resulten interesantes en vez de que tenga que buscar por todo el inventario.

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 rápidamente 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 mayor 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 usar este recurso

Los mensajes multiproducto funcionan mejor para guiar a los clientes hacia un subconjunto específico del inventario de una empresa, 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 su pedido para retirar de menos de 30 artículos.

Los mensajes de un solo producto funcionan mejor para guiar a los clientes hacia un artículo específico del inventario de una empresa, ya que ofrecen respuestas rápidas de entre 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.

Comencemos

Antes de enviar los mensajes, necesitas obtener el identificador de WhatsApp de tu receptor haciendo una llamada al nodo /contacts.

Recomendamos configurar webhooks para recibir el estado de los mensajes y las notificaciones de mensajes entrantes. De esta manera, puedes realizar un seguimiento para verificar si se envió un mensaje y de las respuestas de los clientes.

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:

Tras finalizar el proceso, el objeto interactivo debería tener un aspecto como el 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 multiproducto

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

Tras finalizar el proceso, el objeto interactive debería verse algo así:

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

Si ninguno de los artículos proporcionados en las llamadas a la API que se muestran arriba coincide con un producto del catálogo de Facebook de la empresa, se devolverá un mensaje de error y no se le enviará 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 del catálogo de Facebook de la empresa. En este caso:

• Los mensajes se envían correctamente.
• Se omiten los artículos que no tienen coincidencias.
• La empresa recibe un mensaje de error en el que se le pide que actualice el catálogo.

Paso 2: Agregar parámetros de mensajes comunes

Una vez que el objeto interactivo está completo, adjunta los otros parámetros que forman un mensaje: recipient_type, to y type. Recuerda configurar type en 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: Haz una solicitud POST a /messages

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

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