Como configurar os novos parâmetros de mensagens do WhatsApp no Blip – Blip | Blip Help

Resumo

A Blip está disponibilizando novos componentes conversacionais para o canal WhatsApp, permitindo maior flexibilidade e personalização no envio de mensagens interativas, modelos (templates) e recursos avançados na plataforma.

Este artigo apresenta os novos parâmetros de mensagem liberados pela Meta para o canal WhatsApp via Blip, detalhando a finalidade e a estrutura completa de payload para cada um deles. O objetivo é permitir que você configure recursos avançados, como ofertas por tempo limitado, códigos de cupom, fluxos interativos, notas de voz e identificação de parâmetros por nome.

Antes de começar

Garanta que o canal WhatsApp esteja devidamente conectado à sua conta Blip.
Atenção: A disponibilidade de cada parâmetro depende da configuração e do tipo de modelo de mensagem (template) selecionado na Meta. Nem todos os parâmetros funcionam em qualquer tipo de mensagem. Consulte sempre a documentação oficial da Meta antes de realizar os envios.

Novos parâmetros e estruturas de payload

1. Bid Spec – Click-to-WhatsApp Ads

Permite informar um multiplicador de bid por mensagem em cenários de anúncios do 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 – Categoria da mensagem

Indica a categoria associada à mensagem enviada para a API do WhatsApp.

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

3. Typing Indicator – Indicador de digitação

Informa à Meta que a empresa ou o bot está digitando uma resposta. Deve ser enviado juntamente com uma requisição de confirmação de leitura (read receipt).

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

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

Permite trabalhar com uma oferta que possui data e hora de expiração. O campo expiration_time_ms representa o momento exato da expiração, medido em milissegundos.

{
  "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 o código de cupom utilizado por um botão do tipo copy_code, normalmente associado a uma oferta ou promoção.

{
  "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 o arquivo de áudio enviado deve ser tratado nativamente como uma nota de voz (push to talk / PTT) na interface do usuário.

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

7. WhatsApp Flow – flow_action_data

Permite enviar dados iniciais para um WhatsApp Flow acionado por meio de um botão de modelo de mensagem. O objeto flow_action_data carrega as informações que serão disponibilizadas ao Flow no momento da abertura.

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

Permite identificar as variáveis de um modelo de mensagem pelo seu próprio nome através do campo parameter_name, em vez de utilizar apenas posições 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 adicionar botões de resposta rápida (quick reply) individualmente dentro dos cards de um carrossel interativo.

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

Permite utilizar parâmetros nomeados (parameter_name) também dentro da estrutura de cards de um modelo de mensagem em formato carrossel.

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

Nem todas as propriedades apresentadas podem ser combinadas livremente. A aceitação e o comportamento de cada elemento dependem da aprovação prévia e da estrutura do modelo cadastrado na Meta.
Em caso de dúvidas sobre o comportamento de um parâmetro específico, consulte a documentação oficial da API do WhatsApp Business antes de configurar seu template ou realizar o envio.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃