Mensajes de productos WhatsApp

Los mensajes de producto permiten a las empresas mostrar y compartir productos y servicios con los clientes a través de un chat de WhatsApp, y a esos clientes examinar los artículos, añadirlos a un carrito y enviar un pedido sin salir del chat.

Para trabajar con Mensajes de Producto hay que seguir unos pocos pasos:

Creación de un catálogo de productos

Los datos subyacentes de los productos enviados en los mensajes de producto existen en forma de Catálogo de Productos.

Los catálogos se crean y gestionan a través de la aplicación Meta Responsable de Comercio INTERFAZ DE USUARIO. Aquí puede crear nuevos catálogos o actualizar los existentes.

Screenshot of catalog creation box

Tendrás que seguir varios pasos, como seleccionar un tipo de catálogo, elegir un nombre y configurar algunos ajustes. Como parte de la configuración, puede seleccionar un método de carga de productos, ya sea manualmente o conectándose a una plataforma asociada compatible, como Shopify, BigCommerce u OpenCart, entre otras. Una vez creado el catálogo, se le asignará un nombre único catalog_idesto será necesario cuando trabaje con Mensajes de Producto.

El siguiente paso una vez creado el catálogo es añadir artículos al mismo. Al añadir un artículo, debe proporcionar varios detalles sobre ese artículo, como una imagen, un título, una descripción, una moneda y un precio, y un enlace al sitio web. Esta información es la que se mostrará en una Página de Detalles del Producto cuando se incluya ese artículo en un Mensaje de Producto. Una vez que se ha añadido un artículo a su catálogo, se le asignará un nombre único product_retailer_idque se necesitará cuando se trabaje con Mensajes de Producto. Este ID aparece como "ID de contenido" en la interfaz de usuario de Commerce Manger.

Screenshot of product item Content ID

Una vez que se ha añadido un artículo al Catálogo, puede editar los detalles y cambiar la disponibilidad. La edición de estos detalles afectará a los Mensajes de Producto que se hayan enviado (esto se tratará más adelante en este documento).

Para obtener más información sobre la creación de un catálogo, consulte la sección Metadocumentación.

Para poder incluir artículos de productos en los Mensajes de productos enviados desde un número asociado a su WhatsApp Business Account (WABA), el Catálogo que contiene dichos artículos debe estar vinculado a esa WABA.

Nota: Sólo se puede asociar un catálogo a la vez a una WhatsApp Business Account. No obstante, puede desconectar un catálogo conectado y volver a conectar otro.

El proceso para vincular su WhatsApp Business Account a su Catálogo dependerá del tipo de cuenta que tenga.

Conectar una Owned Account

Una cuenta WABA propia es una cuenta que se ha creado mediante el proceso de registro integrado (a través de la sección Panel de Vonage).

Para conectar su Catálogo a una cuenta propia, siga los siguientes pasos:

  1. Navegue hasta el Gestor de Meta Commerce
  2. Seleccione su empresa en el menú desplegable
  3. Haz clic en el icono de la hamburguesa para abrir el menú "Todas las herramientas" y haz clic en el icono del gestor de WhatsApp.
  4. En el menú de la izquierda, en "Herramientas de Account", haga clic en "Catálogo".
  5. En el cuadro de diálogo "Conectar un catálogo", seleccione el catálogo adecuado en el menú desplegable y haga clic en "Conectar catálogo".

Conectar una Managed Account

Una Managed Account es aquella que ha sido creada para ti por una empresa asociada como Vonage. Para conectar un catálogo a una cuenta administrada, debes asignar la empresa asociada (como Vonage) al catálogo. Esto se puede hacer siguiendo los siguientes pasos:

  1. Navegue hasta el Gestor de Meta Commerce
  2. Seleccione su empresa en el menú desplegable
  3. Haga clic en el icono de la hamburguesa para abrir el menú "Todas las herramientas" y, a continuación, en el icono "Configuración de la empresa".
  4. En el menú de la izquierda, en "Fuentes de datos", haga clic en "Catálogos".
  5. Seleccione el Catálogo correspondiente y haga clic en "Asignar socio". A partir de este punto hay dos procesos posibles para asignar un socio:

Asignación de un interlocutor mediante un ID de empresa

  1. Introduzca el "Business ID" como 2290848174274168
  2. En la sección de permisos "Control total", seleccione la opción "Gestionar catálogo".
  3. Seleccione "Siguiente" y, a continuación, "Cerrar".
  4. Comunícate con el soporte de Vonage, que se encargará de aprobar la solicitud del socio y de conectar el catálogo.

Asignar un interlocutor generando un enlace

  1. Seleccione "Obtener enlace" para generar un enlace
  2. Seleccione la tarea "Gestionar catálogo
  3. Envía el enlace a Vonage. Nota: cada enlace solo puede usarse una vez y caduca a los 30 días.

Envío de mensajes sobre productos

Una vez conectado un Catálogo a su WhatsApp Business Account, puede empezar a enviar Mensajes de Producto a sus clientes y recibir respuestas de ellos.

Hay dos tipos de Mensaje de Producto que puede enviar:

  • Mensajes de un solo producto
  • Mensajes multiproducto

Tanto los mensajes de un solo producto como los de varios son un tipo de WhatsApp Mensaje interactivo. Dentro de Vonage Messages APILos mensajes interactivos de WhatsApp se envían utilizando el tipo de mensaje personalizado. Puede leer más sobre Mensajes personalizadospero esencialmente, en el contexto de los mensajes interactivos, utilizan un custom con un objeto type con el valor interactive y un interactive con una estructura que se corresponda exactamente con la estructura desafiada para interactive dentro de la Meta API.

Para los mensajes de un solo producto, el interactive tiene un objeto type con el valor product. Para los mensajes multiproducto, tiene un type con el valor product_list.

El componente clave del interactive tanto para mensajes de un solo producto como de varios productos es el objeto action objetos. Contiene datos sobre los productos que se mostrarán en el mensaje. La estructura exacta de los objetos action varía en función de si está enviando un mensaje de un solo producto o de varios:

  • Para los mensajes de un solo producto, sólo contiene el catalog_id y product_retailer_id campos.
  • Para los mensajes multiproducto contiene uno o varios sections (hasta un máximo de 10), cada una con un title y uno o varios product_items (hasta un máximo de 30 en todas las secciones) que contengan el product_retailer_id.

Además del action hay otras tres propiedades de los mensajes de producto interactive que determinan la apariencia del mensaje en la interfaz de usuario de WhatsApp:

  • A header objeto. Esto es obligatorio para mensajes multiproducto (con un type de texty un text cuyo valor es el texto de la cabecera), pero no disponible para mensajes de un solo producto.
  • A body con un objeto text cuyo valor es el texto del cuerpo. Esta propiedad es obligatorio para mensajes multiproducto, pero opcional para mensajes de un solo producto.
  • A footer con un objeto text cuyo valor es el texto del pie de página. Esta propiedad es opcional para mensajes de uno o varios productos.

Puede ver ejemplos de la estructura JSON para mensajes de un solo producto y de varios productos en el archivo Metadocumentación.

También puedes ver ejemplos de código para enviar a través de Messages API de Vonage:

Nota: un Mensaje de producto no puede utilizarse para iniciar una conversación de WhatsApp, sólo puede enviarse como parte de una conversación existente que haya sido iniciada bien por el cliente enviando un mensaje a la empresa, bien por la empresa enviando un Plantilla de mensaje al cliente. Consulte Normas para enviar mensajes a los clientes.

Interfaz de usuario de WhatsApp

Gran parte de la lógica de la forma en que los clientes interactúan con los mensajes de producto existe dentro de la interfaz de usuario de WhatsApp. Los datos de los productos que se muestran en la interfaz se obtienen directamente de los detalles añadidos al catálogo identificado por el botón catalog_id y productos identificados por product_retailer_id en el mensaje saliente.

Apariencia del mensaje

La forma en que aparecerá el mensaje en la interfaz de usuario variará en función de si se trata de un mensaje de un solo producto o de varios productos, y también de la forma en que se hayan estructurado los mensajes salientes en la aplicación interactive objeto.

Mensaje de producto único

Un único mensaje de producto que contenga sólo los elementos requeridos mostrará la imagen, el título, el precio y el botón "Ver".

Screenshot of basic single product message

El texto del botón "Ver" se genera automáticamente y varía en función del idioma que el usuario haya configurado en los ajustes de la aplicación WhatsApp. Por ejemplo, si el idioma es el francés, aparecerá "Afficher".

Screenshot of basic single product message with View button in French

Si body y footer debajo de la información principal del producto y encima del botón "Ver".

Screenshot of single product message with body and footer

Si pulsa en cualquier lugar del mensaje, aparecerá la página de detalles del producto.

Mensaje multiproducto

Los mensajes multiproducto se muestran inicialmente de forma similar con algunas ligeras diferencias. Hay una imagen, algo de texto en el encabezado y el número de artículos, seguido por el texto del cuerpo y luego el texto del pie de página (si se utiliza) y, finalmente, un botón "Ver artículos" (de nuevo, el texto del botón depende de la configuración de idioma de WhatsApp).

Screenshot of basic multi-product message

Al pulsar en cualquier lugar de un mensaje multiproducto, se mostrará la lista de productos, dividida en sections.

Screenshot of multi-product message product list

Se pueden añadir artículos a la cesta de la compra directamente desde la lista de productos, y también hay un botón para ver la cesta.

Al pulsar sobre un artículo individual se mostrará la página de detalles del producto.

Página de detalles del producto

La Página de Detalles del Producto muestra información sobre un producto individual, como la imagen, el título, la moneda y el precio, la descripción y la URL. También hay controles para añadir un artículo a la cesta y ajustar la cantidad, para ver la cesta y para enviar un mensaje a la empresa.

Screenshot of the product details page

Cesta de la compra

La cesta de la compra enumera los artículos añadidos, con un coste por partida y un subtotal global, y dispone de opciones para ajustar la cantidad y enviar la cesta a la empresa.

Hay una cantidad máxima de 99 para cualquier artículo.

Nota: no se pueden realizar cambios en el carro una vez enviado, aunque los clientes pueden crear y enviar varios carros a partir del mismo mensaje de producto inicial.

Screenshot of the Shopping Cart

Acciones de los clientes

Independientemente de la estructura del mensaje, o de si se trata de un mensaje de un solo producto o de varios, las acciones que puede realizar el cliente son esencialmente las mismas:

  • Ver productos. Ya sea en una Lista de productos (para mensajes de varios productos) o en la página Detalles del producto (para mensajes de uno o varios productos).
  • Añadir productos a la cesta. Ya sea desde la Lista de productos (para mensajes de varios productos) o desde la página Detalles del producto (para mensajes de uno o varios productos).
  • Actualizar el carro. Las cantidades pueden ajustarse hacia arriba o hacia abajo, desde el carro, desde la Lista de productos (para mensajes multiproducto) o desde la página Detalles del producto (para mensajes tanto de un solo producto como multiproducto).
  • Envíe el carro a la empresa.
  • Póngase en contacto con la empresa. Ya sea dentro del chat o desde una página de Detalles del producto.

Actualizaciones de productos en directo

Si se realizan cambios en los artículos del Meta Commerce Manager, como cambios de precio o disponibilidad, estos cambios se reflejarán en los mensajes que ya se han enviado. Si se modifica la disponibilidad de un producto de forma que deja de estar disponible, el cliente verá un mensaje en la interfaz de usuario informándole de ello.

Screenshot of availability message

Puede haber un ligero retraso en la actualización de un producto en la interfaz de usuario de WhatsApp tras una actualización en el gestor de comercio, pero si, por ejemplo, un cliente intenta interactuar con un artículo que ya no está disponible, verá un mensaje indicándolo y no podrá añadir el artículo a su cesta.

Screenshot of removal message

Encontrará más información sobre las actualizaciones de productos en la sección Metadocumentación

Recepción de respuestas

Para recibir respuestas a los mensajes de producto, es necesario tener un Webhook de mensajes entrantes configura tu aplicación de Vonage.

El tipo de mensaje entrante recibido dependerá de la forma en que el cliente se haya puesto en contacto con la empresa.

  • Mensaje de texto estándar. Si el cliente envía un mensaje de texto como parte de la conversación, el mensaje entrante será del tipo textpero el context no contendrá ningún detalle del producto.
  • Mensaje de producto cotizado. Si el cliente cita un mensaje de producto, éste también será de tipo textpero en este caso el context contendrá un objeto whatsapp_referred_product que contiene un objeto catalog_id y product_retailer_id.
  • Cesta de la compra enviada. Un carro de la compra enviado será del tipo ordery contienen un catalog_id así como una serie de product_items y sus datos asociados (product_retailer_id, quantity, item_price, currency).

Para más información

Ejemplos de códigos