WhatsApp Interactivo - Mensajes individuales y multi-producto

¿Qué es un Mensaje de Producto?

Los mensajes de producto permiten a las empresas mostrar sus productos y servicios a sus clientes sin salir de la aplicación de WhatsApp.

Entendamos los tipos de mensajes de producto en detalle:

• Mensajes multi-producto: Mensajes que contienen una selección de hasta 30 artículos del inventario de un negocio.
• Mensajes de un solo producto: Mensajes con un solo artículo del inventario del negocio. El producto se muestra en un formato de página de detalles del producto (PDP).

Tanto los mensajes multi-producto como los mensajes de un solo producto son tipos de mensajes interactivos de sesión, lo que significa que no es necesario que WhatsApp lo apruebe, a diferencia de los mensajes de plantilla: no pueden enviarse como notificaciones, sino que solo pueden enviarse como parte de conversaciones existentes.

Los usuarios que reciben mensajes de productos múltiples y únicos pueden realizar 3 acciones principales:

• Ver productos: Los clientes pueden ver una lista de productos o un solo producto. Cuando un usuario hace click en un artículo específico, WhatsApp obtiene la información más reciente del producto y muestra el producto en un formato de página de detalles del producto (PDP). Actualmente, las PDP solo admiten imágenes de los productos: cualquier vídeo y/o GIF añadido al producto no se mostrará en la PDP.
• Añadir productos a la canasta: Cada vez que un usuario añade un producto a la canasta de compras, WhatsApp obtiene la información más reciente del artículo. Si se ha producido un cambio de estado en alguno de los artículos, WhatsApp muestra un cuadro de diálogo que dice "Se han actualizado uno o más artículos de tu cesta" – Consulta las actualizaciones de productos que se dan a continuación para obtener más información. Una canasta persiste en un hilo de chat entre el negocio y el cliente hasta que la canasta se envía al negocio – Ver Experiencia de la canasta de compras a continuación para más detalles.
• Enviar una canasta de compras al negocio: Después de añadir todos los artículos necesarios, los clientes pueden enviar su canasta al negocio con el que se están comunicando. Después, los negocios pueden definir los siguientes pasos, como solicitar información de entrega o dar opciones de pago.

Si un cliente tiene varios dispositivos vinculados a la misma cuenta de WhatsApp, los mensajes de varios productos y de un solo producto se sincronizarán entre los dispositivos. Sin embargo, la canasta de compras es local para cada dispositivo específico. Consulta experiencia de la canasta de compras a continuación para obtener más detalles.

Actualmente, este tipo de mensajes se pueden recibir en las siguientes plataformas:

• iOS: 2.21.100 (Mensajes de varios productos) y 2.21.210 (Mensajes de un solo producto).
• Android: 2.21.9.15 (Mensajes de varios productos) y 2.21.19 (Mensajes de un solo producto).
• Web: El cliente web que soporta estas características ha sido lanzado.

Si la versión de la app del destinatario no es compatible con los mensajes multi-producto o mono-producto, la empresa recibe una notificación de webhook que arroja un error que describe por qué no se pudo enviar el mensaje.

Actualizaciones de productos

Las empresas pueden necesitar actualizar las características de los artículos de su catálogo. Dependiendo de la característica actualizada, así es como manejamos cualquier mensaje que mencione ese producto:

Experiencia de la canasta de compras

Después de ver los productos, un cliente puede añadirlos a su canasta de compras y enviar esa canasta a un negocio. A efectos del comercio en WhatsApp, una canasta de compras:

• Es única para un hilo de chat entre persona y negocio en un dispositivo específico: Solo se crea una canasta por hilo de chat entre el cliente y el negocio y las canastas no persisten a través de múltiples dispositivos. Una vez que se envía una canasta, el cliente puede abrir otra canasta con el negocio y comenzar el proceso de nuevo.
• No tiene fecha de vencimiento: La canasta persiste en el hilo de chat hasta que se envía a la empresa. Una vez enviada, la canasta se borra.

Los clientes pueden añadir hasta 99 unidades de un mismo artículo del catálogo a una canasta de compras, pero no hay límite en el número de artículos distintos que se pueden añadir a una canasta.

Una vez que se ha enviado una canasta de compras, no se pueden realizar modificaciones. Los clientes pueden enviar una nueva canasta si necesitan nuevos artículos o desean modificar su pedido. Las empresas no pueden enviar canastas de compras a los clientes.

Pre-requisitos para enviar un mensaje de producto

1.    Crear el catálogo y añadir artículos al catálogo

1. Sigue esta guía si aún no has creado ningún catálogo, de lo contrario pasa al paso 2

2.    Asignar una empresa asociada a tu catálogo

A. Dado que las WABA son creadas por el BSP, y el catálogo por los comerciantes / ISV / Empresas - tienen que asignar el BSP como negocio asociado a su catálogo, para ello sigue los siguientes pasos:

1. 1. 1. Ve a la configuración de tu empresa y selecciona tu negocio.
      2. Selecciona Fuentes de Datos.
      3. Selecciona Catálogos y selecciona el nombre de tu catálogo.
      4. Selecciona Asignar Socio.
      5. Selecciona el ID de la empresa
      6. Introduce el ID de la empresa como 1900820339959633 y en la sección de permisos de control total selecciona la opción Gestionar catálogo. Una vez hecho esto, selecciona Siguiente y luego Cerrar.

B. Una vez enviada la solicitud, escribe a devsupport@gupshup.io con el asunto: Aprobar solicitud de catálogo: <<Nombre de la aplicación>> y en el cuerpo del correo debe figurar el Nombre e ID del Catálogo. Aprobaremos la solicitud del socio y también conectaremos el Catálogo a la app en línea mencionada en el asunto. Nota: Sólo se puede asociar 1 Catálogo a una WABA.

3. Si la WABA es de la India (número de teléfono +91), es necesario el cumplimiento de comercio electrónico de la empresa: Comparte los siguientes detalles con Gupshup en el mismo correo electrónico para registrar tu WABA:

Datos de la entidad/empresa:

Datos de atención al cliente:

Datos del responsable de reclamaciones:

Nota: Para más información, consulta aquí. Por ejemplo, cómo cumplir con las leyes para vender en línea en la India utilizando la API de WhatsApp Business

Especificación de la API para enviar mensajes de productos

Punto final de la API:

POST https://api.gupshup.io/sm/api/v1/msg

Encabezados

Solicitud común de payload

Objeto de payload del mensaje

Muestra individual pr

Mensaje del producto:

{
    "type": "product_details",
    "subType": "product",
    "catalogId": "558215241949699",
    "destination": "9184********",
    "productId": "2v3fh1axoq",
    "body": {
        "text": "body content!"
    },
    "footer": {
        "text": "footer content!"
    }
}

Ejemplo de mensaje multi-producto:

CURL

curl --location --request POST 'https://api.gupshup.io/sm/api/v1/msg' \
--header 'apikey: xxxxxxxxxxxx' \

--header 'content-type: application/x-www-form-urlencoded' \
--data-urlencode 'channel=whatsapp' \
--data-urlencode 'source=553598XXXX29' \
--data-urlencode 'destination=91996XXXX68' \
--data-urlencode 'message={
  "type": "product_details",
  "subType": "product_list",
  "catalogId": "1598140273855917",
  "productId": "",
  "destination": "919964XXX68",
  "body": {
    "text": "body content!"
  },
  "header": {
    "type": "text",
    "text": "header content!"
  },
  "footer": {
    "text": "footer content!"
  },
  "sections": [
    {
      "title": "",
      "productList": [
        {
          "productId": "559iac23i3"
        },
        {
          "productId": "c358j92ic3"
        }
      ]
    }
  ]
}' \
--data-urlencode 'src.name=Gersjdn'

Mensaje de entrada:

La búsqueda de un producto:

{
    "app": "Extra9",
    "timestamp": 1637840344966,
    "version": 2,
    "type": "message",
    "payload": {
        "id": "ABEGkZlpNARoAgo-sKGeURk3EWXT",
        "source": "919969340468",
        "type": "text",
        "payload": {
            "text": "Hello"
        },
        "sender": {
            "phone": "919969340468",
            "name": "Omkar Mestry",
            "country_code": "91",
            "dial_code": "9969340468"
        }
    }
}

Pedido realizado:

{
    "app": "DemoApp",
    "timestamp": 1590854464792,
    "version": 2,
    "type": "order",
    "payload": {
        "id": "ABEGkYaYVSEEAgo-sMx1DoUoQJRW",
        "source": "918x98xx21x4",
        "type": "text",
        "payload": {
            "text": "hi"
        },
        "sender": {
            "phone": "918x98xx21x4",
            "name": "Smit",
            "country_code": "91",
            "dial_code": "8x98xx21x4"
        },
        "context": {
            "catalog": {
                "id": "",
                "order": {
                    "items": [
                        {
                            "id": "",
                            "currency": "",
                            "amount": "",
                            "quantity": ""
                        },
                        {
                            "id": "",
                            "currency": "",
                            "amount": "",
                            "quantity": ""
                        }
                    ]
                }
            }
        }
    }

Objeto de payload del mensaje entrante: