Cómo configurar los nuevos parámetros de mensajes de WhatsApp en Blip – Blip | Blip Help

Resumen

Blip está poniendo a disposición nuevos componentes conversacionales para el canal de WhatsApp, lo que permite una mayor flexibilidad y personalización en el envío de mensajes interactivos, modelos (templates) y recursos avanzados en la plataforma.

Este artículo presenta los nuevos parámetros de mensaje habilitados por Meta para el canal de WhatsApp mediante Blip, y detalla la finalidad y la estructura completa del payload de cada uno. El objetivo es permitirte configurar recursos avanzados, como ofertas por tiempo limitado, códigos de cupón, flujos interactivos, notas de voz e identificación de parámetros por nombre.

Antes de comenzar

Asegúrate de que el canal de WhatsApp esté correctamente conectado a tu cuenta de Blip.
Atención: La disponibilidad de cada parámetro depende de la configuración y del tipo de modelo de mensaje (template) seleccionado en Meta. No todos los parámetros funcionan con cualquier tipo de mensaje. Consulta siempre la documentación oficial de Meta antes de realizar los envíos.

Nuevos parámetros y estructuras de payload

1. Bid Spec – Anuncios de Click-to-WhatsApp

Permite informar un multiplicador de bid por mensaje en escenarios de anuncios del tipo Click-to-WhatsApp.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "text",
  "text": {
    "body": "Olá! Confira nossa oferta."
  },
  "bid_spec": {
    "per_message_bid_multiplier": 1.5
  }
}

2. Category – Categoría del mensaje

Indica la categoría asociada al mensaje enviado a la API de WhatsApp.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "text",
  "category": "marketing",
  "text": {
    "body": "Confira nossa oferta especial."
  }
}

3. Typing Indicator – Indicador de escritura

Informa a Meta que la empresa o el bot está escribiendo una respuesta. Debe enviarse junto con una solicitud de confirmación de lectura (read receipt).

{
  "messaging_product": "whatsapp",
  "status": "read",
  "message_id": "wamid.HBgL123456789",
  "typing_indicator": {
    "type": "text"
  }
}

4. Limited Time Offer (LTO) – Oferta por tiempo limitado

Permite trabajar con una oferta que tiene fecha y hora de expiración. El campo expiration_time_ms representa el momento exacto de la expiración, medido en milisegundos.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "promocao_lto",
    "language": {
      "code": "pt_BR"
    },
    "components": [
      {
        "type": "limited_time_offer",
        "parameters": [
          {
            "type": "limited_time_offer",
            "limited_time_offer": {
              "expiration_time_ms": "1770000000000"
            }
          }
        ]
      }
    ]
  }
}

5. Coupon Code – Copy Code

Permite enviar el código de cupón utilizado por un botón del tipo copy_code, normalmente asociado a una oferta o promoción.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "promocao_cupom",
    "language": {
      "code": "pt_BR"
    },
    "components": [
      {
        "type": "button",
        "sub_type": "copy_code",
        "index": "0",
        "parameters": [
          {
            "type": "coupon_code",
            "coupon_code": "PROMO10"
          }
        ]
      }
    ]
  }
}

6. Audio Voice – Nota de voz (PTT)

Indica que el archivo de audio enviado debe tratarse de forma nativa como una nota de voz (push to talk / PTT) en la interfaz de usuario.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "audio",
  "audio": {
    "id": "MEDIA_ID",
    "voice": true
  }
}

7. WhatsApp Flow – flow_action_data

Permite enviar datos iniciales a un WhatsApp Flow activado mediante un botón de modelo de mensaje. El objeto flow_action_data contiene la información que estará disponible para el Flow al momento de abrirse.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "meu_flow",
    "language": {
      "code": "pt_BR"
    },
    "components": [
      {
        "type": "button",
        "sub_type": "flow",
        "index": "0",
        "parameters": [
          {
            "type": "action",
            "action": {
              "flow_token": "FLOW_TOKEN",
              "flow_action_data": {
                "customer_id": "12345",
                "origin": "campaign"
              }
            }
          }
        ]
      }
    ]
  }
}

8. Named Parameters – Parámetros con nombre

Permite identificar las variables de un modelo de mensaje por su propio nombre mediante el campo parameter_name, en lugar de utilizar únicamente posiciones numéricas.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "pedido",
    "language": {
      "code": "pt_BR"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "parameter_name": "customer_name",
            "text": "Teste"
          }
        ]
      }
    ]
  }
}

9. Carousel Cards – Quick Reply

Permite agregar botones de respuesta rápida (quick reply) individualmente dentro de las tarjetas de un carrusel interactivo.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "interactive",
  "interactive": {
    "type": "carousel",
    "body": {
      "text": "Escolha um produto:"
    },
    "action": {
      "cards": [
        {
          "card_index": 0,
          "action": {
            "buttons": [
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "produto_001",
                  "title": "Comprar"
                }
              }
            ]
          }
        }
      ]
    }
  }
}

10. Named Parameters en Cards

Permite utilizar parámetros con nombre (parameter_name) también dentro de la estructura de tarjetas de un modelo de mensaje en formato de carrusel.

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "catalogo",
    "language": {
      "code": "pt_BR"
    },
    "components": [
      {
        "type": "cards",
        "cards": [
          {
            "card_index": 0,
            "components": [
              {
                "type": "body",
                "parameters": [
                  {
                    "type": "text",
                    "parameter_name": "product_name",
                    "text": "Produto A"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Avisos importantes

No todas las propiedades presentadas pueden combinarse libremente. La aceptación y el comportamiento de cada elemento dependen de la aprobación previa y de la estructura del modelo registrado en Meta.
Si tienes dudas sobre el comportamiento de un parámetro específico, consulta la documentación oficial de la API de WhatsApp Business antes de configurar tu template o realizar el envío.

¿Necesitas más ayuda? Explora nuestros contenidos en la Blip Academy o en la Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃