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

Resumen
Nuevos parámetros y estructuras de payload
Avisos importantes

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, plantillas (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 plantilla de mensaje (template) seleccionado en Meta. No todos los parámetros funcionan en 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": "¡Hola! Consulta nuestra 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": "Consulta nuestra 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).

La solicitud debe enviarse mediante el protocolo HTTP utilizando el método POST al endpoint de la plataforma Blip.

Método HTTP: POST
URL del endpoint: https://{{idcontrato}}.http.msging.net/messages

Nota: Reemplaza la variable {{idcontrato}} por el identificador único del contrato o enrutador de tu cuenta en la plataforma Blip.

Define los siguientes encabezados al enviar la solicitud:

Clave (Key)

Valor (Value)

Descripción

Authorization

Clave de API de autorización del enrutador/bot de Blip.

Content-Type

application/json

Especifica el formato del cuerpo de la solicitud.

El cuerpo de la solicitud debe tener formato JSON, como se muestra en el siguiente ejemplo:

{
  "id": "{{random.guid}}",
  "to": "{{contact.identity}}",
  "type": "application/json",
  "content": {
    "messaging_product": "whatsapp",
    "status": "read",
    "message_id": "{{input.message.id}}",
    "typing_indicator": {
      "type": "text"
    }
  }
}

Si el comando se está configurando directamente dentro de un bloque de Solicitud HTTP de Blip Builder, completa la sección Guardar respuesta con las siguientes variables para el seguimiento:

Variable para el estado de la respuesta: statusDigitando
Variable para el cuerpo de la respuesta: bodyDigitando

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 plantilla 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 una plantilla 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": "Elige un producto:"
    },
    "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 una plantilla 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": "Producto 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 de la plantilla registrada 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 plantilla o realizar el envío.

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