How to configure the new WhatsApp message parameters in Blip – Blip | Blip Help

Summary
New parameters and payload structures
Important notices

Summary

Blip is making new conversational components available for the WhatsApp channel, enabling greater flexibility and customization when sending interactive messages, templates, and advanced features on the platform.

This article presents the new message parameters released by Meta for the WhatsApp channel through Blip, detailing the purpose and complete payload structure for each one. The goal is to enable you to configure advanced features such as limited-time offers, coupon codes, interactive flows, voice notes, and identifying parameters by name.

Before you start

Make sure that the WhatsApp channel is properly connected to your Blip account.
Attention: The availability of each parameter depends on the configuration and type of message template (template) selected in Meta. Not all parameters work with every type of message. Always consult Meta's official documentation before sending messages.

New parameters and payload structures

1. Bid Spec – Click-to-WhatsApp Ads

Allows you to specify a bid multiplier per message in Click-to-WhatsApp ad scenarios.

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

2. Category – Message category

Indicates the category associated with the message sent to the WhatsApp API.

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

3. Typing Indicator

Informs Meta that the company or bot is typing a response. It must be sent together with a read confirmation request (read receipt).

The request must be sent over the HTTP protocol using the POST method to the Blip platform endpoint.

HTTP Method: POST
Endpoint URL: https://{{idcontrato}}.http.msging.net/messages

Note: Replace the {{idcontrato}} variable with the unique identifier of your account's contract or router on the Blip platform.

Set the following headers when sending the request:

Key

Value

Description

Authorization

Authorization API key for the Blip Router/Bot.

Content-Type

application/json

Specifies the format of the request body.

The request body must be formatted as JSON according to the example below:

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

If the command is being configured directly within an HTTP Request block in Blip Builder, fill in the Save Response section with the following variables for tracking:

Variable for response status: statusDigitando
Variable for response body: bodyDigitando

4. Limited Time Offer (LTO)

Allows you to work with an offer that has an expiration date and time. The expiration_time_ms field represents the exact expiration time, measured in milliseconds.

{
  "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

Allows you to send the coupon code used by a copy_code button, usually associated with an offer or promotion.

{
  "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 – Voice note (PTT)

Indicates that the audio file sent should be natively treated as a voice note (push to talk / PTT) in the user interface.

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

7. WhatsApp Flow – flow_action_data

Allows you to send initial data to a WhatsApp Flow triggered through a message template button. The flow_action_data object carries the information that will be made available to the Flow when it opens.

{
  "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

Allows you to identify the variables in a message template by their own name through the parameter_name field, instead of using only numeric positions.

{
  "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

Allows you to add quick reply buttons (quick reply) individually within the cards of an interactive carousel.

{
  "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 in Cards

Allows you to use named parameters (parameter_name) within the card structure of a carousel-formatted message template as well.

{
  "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"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Important notices

Not all properties presented can be freely combined. The acceptance and behavior of each element depend on prior approval and the structure of the template registered in Meta.
If you have questions about the behavior of a specific parameter, consult the official WhatsApp Business API documentation before configuring your template or sending the message.

Need more help? Explore our content on Blip Academy or Blip Community, watch tutorials on our YouTube channel or get your questions answered through our support channel 😃