Plantillas de carrusel de WhatsApp

Las plantillas de carrusel de tarjetas multimedia te permiten mostrar varios productos en un único mensaje de plantilla de marketing en WhatsApp. Cada producto aparece como una tarjeta desplazable horizontalmente, lo que permite a los usuarios navegar, comparar y actuar sobre las ofertas sin verse abrumados por múltiples mensajes.

Este formato es especialmente eficaz para promociones y campañas estacionales.

Una plantilla de carrusel de tarjetas multimedia es una plantilla de marketing de WhatsApp que combina:

  • Un único texto en el cuerpo del mensaje, y
  • Un carrusel desplazable horizontalmente de hasta 10 fichas de producto

Cada tarjeta representa un producto o una oferta y está diseñada para conducir a los usuarios a una página externa de compra o información.

Las tarjetas de carrusel sólo son compatibles con los mensajes de las plantillas de marketing y no están disponibles para las plantillas de utilidades o autenticación.

Componentes de un carrusel

Cada tarjeta de carrusel puede contener los siguientes componentes:

Encabezado (obligatorio)
Una imagen o un vídeo que represente el producto.

Texto del cuerpo (opcional)
Texto descriptivo breve, como el nombre del producto, el precio o la promoción.

Botones (opcionales, hasta dos por tarjeta)
Los tipos de botones admitidos son:

  • Botones URL
  • Botones de números de teléfono
  • Botones de respuesta rápida

Puede mezclar tipos de botones dentro de una misma tarjeta (por ejemplo, un botón de URL y otro de respuesta rápida).

Requisito de coherencia
Todas las tarjetas de una misma plantilla de carrusel deben utilizar el mismo conjunto de componentes.
Por ejemplo, si una tarjeta incluye un cuerpo de texto y dos botones, todas las tarjetas deberán incluir también un cuerpo de texto y dos botones.

Crear una plantilla de carrusel de WhatsApp

Los carruseles de tarjetas multimedia deben crearse como plantillas de marketing utilizando la API de gestión de plantillas.

Cada plantilla consta de:

  • A BODY componente (se aplica a todo el mensaje)
  • A CAROUSEL componente que contiene hasta 10 tarjetas
  • Cada tarjeta debe definir los mismos componentes

Carrusel de recomendaciones de productos

Este ejemplo crea una plantilla de carrusel con tres fichas de producto, cada una de las cuales incluye:

  • Una cabecera de imagen
  • Un organismo con un parámetro de precio dinámico
  • Un botón URL y un botón de respuesta rápida
An example WhatsApp message showing a product recommendation card for the Vonage Video API.

Respuesta

Status 202 ACCEPTED

Carrusel con parámetros de URL dinámicos

Esta plantilla muestra botones de URL dinámicos, en los que parte de la URL se proporciona en el momento del envío.

An example WhatsApp message showing a link to more information about the Vonage Communication APIs.

Respuesta

Status 202 Accepted

Carrusel informativo sin parámetros

Esta plantilla utiliza texto estático en el cuerpo y botones, sin que se requieran parámetros al enviar.

An example WhatsApp message showing some information about SIP Trunking, followed by a link to the related documentation.

Respuesta

Status 202 ACCEPTED

Experiencia del usuario al recibir un carrusel

Cuando un usuario pulsa un botón de URL en una tarjeta de carrusel:

  • La URL asignada se abre en el navegador web predeterminado del dispositivo
  • El usuario sale de la experiencia del cliente de WhatsApp

Porque las compras se realizan fuera de WhatsApp:

  • No se activan webhooks de WhatsApp para los pedidos
  • Los detalles del pedido no están disponibles en las API de WhatsApp

Cargar archivos multimedia

Antes de enviar plantillas de carrusel con medios, es posible que tenga que cargar sus archivos multimedia para obtener manejadores de medios. Cargue los archivos multimedia mediante la Media Upload API para obtener los manejadores de medios.

Cargar solicitud de medios:

curl --location 'https://api.nexmo.com/v2/whatsapp-manager/media/uploads?file_type=image%2Fjpg' \
  --header 'Authorization: Basic xxxxxxxxxxx' \
  --form 'mediafile=@"/Users/pcristobaldelrio/Desktop/client-sdk.png"'

Para más información