Plantilla Carrusel

Descripción general

La plantilla Carrusel admite dos formatos de envío:

Carrusel con tarjetas de producto personalizadas

Máxima flexibilidad para su caso de uso. Ideal cuando necesita personalización y libertad de marketing.

• Usted define el carrusel: número de tarjetas, textos, variables y botones

• Al enviar, proporciona imágenes y valores de las variables

• Útil para promociones a medida, ofertas especiales y contenido por segmento

• Control total del aspecto y del texto de cada tarjeta

---

Carrusel con tarjetas de producto de su Catálogo de WhatsApp

Rápido, automático y con menos errores. Ideal para envíos masivos y ventas recurrentes.

• Las tarjetas se obtienen directamente de su Catálogo de WhatsApp

• No hace falta rellenar descripciones, subir imágenes ni configurar botones a mano

• Los datos están siempre actualizados: precio, nombre, descripción, imágenes

• Menos trabajo manual y menos errores al enviar

---

Descripción

Las plantillas Carrusel permiten enviar un único mensaje de texto (1) junto con un conjunto de hasta 10 tarjetas de carrusel (2) con desplazamiento horizontal.

Los usuarios pueden ver el carrusel tanto en móvil como en el cliente web de WhatsApp.

Reglas básicas para crear la plantilla:

1. Es obligatorio un mensaje de burbuja (1). Las burbujas son solo texto y admiten variables.

2. Las plantillas Carrusel admiten hasta 10 tarjetas.

3. El formato del encabezado multimedia y los tipos de botones deben ser los mismos en todas las tarjetas.

4. Cada tarjeta debe tener un encabezado multimedia obligatorio (imagen o vídeo) y texto en el cuerpo.

5. Cada tarjeta debe tener al menos 1 botón. La plantilla admite como máximo 2 botones por tarjeta.

6. Tipos de botón admitidos: Quick Reply, URL de sitio web (CTA) y Número de teléfono (CTA). Pueden ser del mismo tipo o mezcla de Quick Reply, teléfono o URL por tarjeta.

Formas de enviar el Carrusel

El Carrusel se puede enviar de dos formas:

• Mediante plantilla (mensaje de plantilla) — para enviar fuera de la ventana de 24 horas. Requiere crear y que Meta apruebe la plantilla de WhatsApp. El envío es de pago.

• Como mensaje de servicio — dentro de la ventana de conversación de 24 horas. No hace falta plantilla. El envío es gratuito.

---

Crear la plantilla

La creación se describe en la API en el método /addTemplate.

La diferencia respecto a una plantilla básica es añadir el tipo CAROUSEL en components y el array cards.

También puede crear desde "Dev Toolkit" → "Test requests". No olvide indicar ejemplos de variables si las usa en el cuerpo o en la URL de los botones; si no, Meta puede rechazar la plantilla.

---

Parámetros de referencia

Parámetro	Tipo	Descripción	Ejemplo
BUBBLE_TEXT	String	Obligatorio. Texto de la burbuja. Admite variables. Máx. 1024 caracteres.	Summer is here, and we've got the freshest produce around! Use code {{1}} to get {{2}} off your next order.
BUBBLE_TEXT_VAR_EXAMPLE	Array de strings	Obligatorio si la burbuja tiene variables. Tantos ejemplos como variables.	"15OFF","15%"
CARD_BODY_TEXT	String	Obligatorio. Texto del cuerpo de la tarjeta. Admite variables. Máx. 160 caracteres.	Rare lemons for unique cocktails. Use code {{1}} to get {{2}} off all produce.
CARD_BODY_TEXT_VAR_EXAMPLE	Array de strings	Obligatorio si el cuerpo de la tarjeta tiene variables.	"15OFF","15%"
CARD_HEADER_FORMAT	Enum	Obligatorio. Formato del encabezado: IMAGE o VIDEO.	IMAGE
CARD_HEADER_HANDLE	—	Obligatorio. Ejemplo del medio enviado.	—
QUICK_REPLY_BUTTON_TEXT	String	Obligatorio si usa botón Quick Reply. Etiqueta. Máx. 25 caracteres.	Send more like this #2
TEMPLATE_CATEGORY	Enum	Obligatorio. MARKETING o UTILITY.	MARKETING
TEMPLATE_LANGUAGE	Enum	Obligatorio. Idioma y código de locale.	en
TEMPLATE_NAME	String	Obligatorio. Nombre de la plantilla. Máx. 512 caracteres.	marketing_carousel_01_test
URL_BUTTON_TEXT	String	Obligatorio si usa botón URL. Etiqueta. Máx. 25 caracteres.	Buy now
URL_BUTTON_URL	String	Obligatorio si usa botón URL. URL que se abre al pulsar. Admite 1 variable al final. Máx. 2000 caracteres.	https://www.luckyshrub.com/shop?promo={{1}}
URL_BUTTON_VAR_EXAMPLE	String	Obligatorio si la URL tiene variable. Ejemplo de URL.	https://www.luckyshrub.com/shop?promo=summer_lemons_2023

---

Ejemplo: crear plantilla Carrusel (tarjetas personalizadas)

Los enlaces son de prueba; use los correctos al copiar. Ejemplo tomado de 360Dialog.

POST https://api.1msg.io/{{channel}}/addTemplate
Content-Type: application/json

{
  "name": "marketing_carousel_01_test",
  "allow_category_change": true,
  "category": "MARKETING",
  "language": "en",
  "components": [
    {
      "text": "Summer is here, and we have the freshest produce around! Use code {{1}} to get {{2}} off your next order.",
      "type": "BODY",
      "example": { "body_text": [["15OFF", "15%"]] }
    },
    {
      "type": "CAROUSEL",
      "cards": [
        {
          "components": [
            {
              "type": "HEADER",
              "format": "IMAGE",
              "example": { "header_handle": ["https://img.example.com/delicious-background-orange-slices_23-2148231462.jpg"] }
            },
            {
              "type": "BODY",
              "text": "Rare lemons for unique cocktails. Use code {{1}} to get {{2}} off all produce",
              "example": { "body_text": [["150FF", "10%"]] }
            },
            {
              "type": "BUTTONS",
              "buttons": [
                { "type": "QUICK_REPLY", "text": "Send more like this #1" },
                { "type": "URL", "text": "Buy now", "url": "https://www.luckyshrub.com/shop?promo={{1}}", "example": ["summer_lemons_2023"] }
              ]
            }
          ]
        },
        {
          "components": [
            {
              "type": "HEADER",
              "format": "IMAGE",
              "example": { "header_handle": ["https://img.example.com/top-view-citric-fruit-slices-table_23-2148495686.jpg"] }
            },
            {
              "type": "BODY",
              "text": "Exotic fruit for unique cocktails! Use code {{1}} to get {{2}} off all exotic produce",
              "example": { "body_text": [["20OFFEXOTIC", "20%"]] }
            },
            {
              "type": "BUTTONS",
              "buttons": [
                { "type": "QUICK_REPLY", "text": "Send more like this #2" },
                { "type": "URL", "text": "Buy now", "url": "https://www.luckyshrub.com/shop?promo={{1}}", "example": ["exotic_produce_2023"] }
              ]
            }
          ]
        }
      ]
    }
  ]
}

---

Ejemplo: crear plantilla Carrusel con productos del Catálogo de WhatsApp

Ejemplos para pruebas; sustituya por datos reales. Los ID de producto se rellenan al enviar.

POST https://api.1msg.io/{{channel}}/addTemplate
Content-Type: application/json

{
  "name": "marketing_carousel_01_test",
  "allow_category_change": true,
  "category": "MARKETING",
  "language": "en",
  "components": [
    {
      "type": "BODY",
      "text": "Hi, {{1}}! Summer is here, and we have the freshest produce around!",
      "example": { "body_text": [["Anna"]] }
    },
    {
      "type": "CAROUSEL",
      "cards": [
        {
          "components": [
            { "type": "HEADER", "format": "PRODUCT" },
            { "type": "BUTTONS", "buttons": [{ "type": "SPM", "text": "View" }] }
          ]
        },
        {
          "components": [
            { "type": "HEADER", "format": "PRODUCT" },
            { "type": "BUTTONS", "buttons": [{ "type": "SPM", "text": "View" }] }
          ]
        }
      ]
    }
  ]
}

---

Enviar un Carrusel

Enviar plantilla Carrusel

El Carrusel en plantilla:

• Tiene su propio type: CAROUSEL

• El objeto CAROUSEL contiene un array cards. Solo se usa en este tipo de plantilla.

• Cada tarjeta tiene card_index — orden en el carrusel. 0 = primera, 1 = segunda, etc.

Ejemplo: enviar plantilla Carrusel (tarjetas personalizadas)

Plantilla de 2 tarjetas. Cada una: botón Quick Reply y botón URL. Encabezado: imagen.

POST https://api.1msg.io/{{channel}}/sendTemplate
Content-Type: application/json

{
  "token": "{{token}}",
  "namespace": "{{namespace}}",
  "template": "marceting_carousel_01_test",
  "language": { "policy": "deterministic", "code": "en" },
  "params": [
    {
      "type": "body",
      "parameters": [
        { "type": "text", "text": "21OFF" },
        { "type": "text", "text": "21" }
      ]
    },
    {
      "type": "carousel",
      "cards": [
        {
          "card_index": 0,
          "components": [
            {
              "type": "header",
              "parameters": [
                { "type": "image", "image": { "link": "https://img.freepik.com/free-photo/top-view-citric-fruit-slices-table_23-2148495686.jpg" } }
              ]
            },
            {
              "type": "button",
              "sub_type": "url",
              "index": 1,
              "parameters": [{ "type": "text", "text": "summer" }]
            },
            {
              "type": "body",
              "parameters": [
                { "type": "text", "text": "10F" },
                { "type": "text", "text": "10" }
              ]
            }
          ]
        },
        {
          "card_index": 1,
          "components": [
            {
              "type": "header",
              "parameters": [
                { "type": "image", "image": { "link": "https://img.freepik.com/free-photo/delicious-background-orange-slices_23-2148231462.jpg" } }
              ]
            },
            {
              "type": "button",
              "sub_type": "url",
              "index": 1,
              "parameters": [{ "type": "text", "text": "winter" }]
            },
            {
              "type": "body",
              "parameters": [
                { "type": "text", "text": "30F" },
                { "type": "text", "text": "30" }
              ]
            }
          ]
        }
      ]
    }
  ],
  "phone": "[phone]"
}

Puede omitir body si el texto común no tiene variables. Puede omitir el body de la tarjeta si su texto no tiene variables.

---

Ejemplo: enviar plantilla Carrusel con productos del Catálogo de WhatsApp

Plantilla de 2 tarjetas con productos del catálogo.

POST https://api.1msg.io/{{channel}}/sendTemplate
Content-Type: application/json

{
  "namespace": "{{namespace}}",
  "template": "marketing_carousel_01_test",
  "language": { "policy": "deterministic", "code": "en" },
  "params": [
    {
      "type": "body",
      "parameters": [{ "type": "text", "text": "Anna" }]
    },
    {
      "type": "carousel",
      "cards": [
        {
          "card_index": 0,
          "components": [
            {
              "type": "header",
              "parameters": [
                { "type": "product", "product": { "product_retailer_id": "0001", "catalog_id": "{{catalog_id}}" } }
              ]
            }
          ]
        },
        {
          "card_index": 1,
          "components": [
            {
              "type": "header",
              "parameters": [
                { "type": "product", "product": { "product_retailer_id": "0002", "catalog_id": "{{catalog_id}}" } }
              ]
            }
          ]
        }
      ]
    }
  ],
  "phone": "{{phone}}"
}

---

Enviar Carrusel como mensaje de servicio

Para enviar el Carrusel como mensaje de servicio (sin plantilla Meta creada de antemano), use el método /sendCarousel.

No hace falta crear una plantilla Meta antes.

La estructura es parecida al envío por plantilla, pero debe indicar todos los elementos explícitamente, porque el mensaje se envía sin plantilla.

---

Ejemplo: enviar Carrusel vía /sendCarousel (tarjetas personalizadas)

2 tarjetas. Cada una: 2 botones Quick Reply. Encabezado: imagen.

POST https://api.1msg.io/{{channel}}/sendCarousel
Content-Type: application/json

{
  "phone": "{{phone}}",
  "params": [
    {
      "type": "BODY",
      "parameters": [{ "type": "text", "text": "Text Body" }]
    },
    {
      "type": "CAROUSEL",
      "cards": [
        {
          "card_index": 0,
          "components": [
            {
              "type": "header",
              "parameters": [
                { "type": "image", "image": { "link": "https://test-pick.ru/38eff70e116842949fd3019b226d31db.jpg" } }
              ]
            },
            {
              "type": "BODY",
              "parameters": [{ "type": "text", "text": "Description card 1" }]
            },
            {
              "type": "button",
              "sub_type": "quick_reply",
              "parameters": [
                { "text": "Button", "id": "Buttons1" },
                { "text": "Button 2", "id": "Buttons2" }
              ]
            }
          ]
        },
        {
          "card_index": 1,
          "components": [
            {
              "type": "header",
              "parameters": [
                { "type": "image", "image": { "link": "https://test-pick.ru/38eff70e116842949fd3019b226d31db.jpg" } }
              ]
            },
            {
              "type": "body",
              "parameters": [{ "type": "text", "text": "Description card 2" }]
            },
            {
              "type": "button",
              "sub_type": "quick_reply",
              "parameters": [
                { "text": "Button", "id": "Button3" },
                { "text": "Button 2", "id": "Button4" }
              ]
            }
          ]
        }
      ]
    }
  ]
}

---

Ejemplo: enviar Carrusel vía /sendCarousel con productos del Catálogo de WhatsApp

2 tarjetas de producto del Catálogo de WhatsApp.

POST https://api.1msg.io/{{channel}}/sendCarousel
Content-Type: application/json

{
  "phone": "{{phone}}",
  "params": [
    {
      "type": "BODY",
      "parameters": [{ "type": "text", "text": "Text body" }]
    },
    {
      "type": "CAROUSEL",
      "cards": [
        {
          "card_index": 0,
          "components": [
            {
              "type": "header",
              "parameters": [
                { "type": "product", "product": { "product_retailer_id": "0001", "catalog_id": "{{catalog_id}}" } }
              ]
            }
          ]
        },
        {
          "card_index": 1,
          "components": [
            {
              "type": "header",
              "parameters": [
                { "type": "product", "product": { "product_retailer_id": "0002", "catalog_id": "{{catalog_id}}" } }
              ]
            }
          ]
        }
      ]
    }
  ]
}