Skip to main content
POST
/
instances
/
{INSTANCE_ID}
/
token
/
{INSTANCE_TOKEN}
/
send-button-list
Enviar Lista de Botões
curl --request POST \
  --url https://api.example.com/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-button-list

​
Descrição

Envia uma mensagem interativa com uma lista de opções organizadas em seções. O destinatário clica em um botão para abrir a lista e selecionar uma opção. Ideal para menus com muitas opções.

​
Request

​
Headers

Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json

​
Body

{
  "phone": "5511999999999",
  "message": "Selecione uma opção:",
  "buttonList": {
    "button": "Ver opções",
    "sections": [
      {
        "title": "Planos",
        "rows": [
          {
            "title": "Básico",
            "description": "Até 1.000 msg/mês",
            "id": "plan_basic"
          },
          {
            "title": "Pro",
            "description": "Até 10.000 msg/mês",
            "id": "plan_pro"
          }
        ]
      }
    ]
  }
}
CampoTipoObrigatórioDescrição
phonestringSimNúmero do destinatário no formato DDI+DDD+número
messagestringSimTexto principal da mensagem
buttonListobjectSimObjeto contendo a configuração da lista
buttonList.buttonstringSimTexto do botão que abre a lista
buttonList.sectionsarraySimArray de seções com title e rows

​
Estrutura de cada item em rows

CampoTipoDescrição
titlestringTítulo da opção
descriptionstringDescrição da opção
idstringIdentificador da opção (retornado quando selecionada)

​
Response

​
Sucesso (202)

{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}

​
Exemplo cURL

curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-button-list' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Selecione uma opção:",
    "buttonList": {
      "button": "Ver opções",
      "sections": [
        {
          "title": "Planos",
          "rows": [
            {"title": "Básico", "description": "Até 1.000 msg/mês", "id": "plan_basic"},
            {"title": "Pro", "description": "Até 10.000 msg/mês", "id": "plan_pro"}
          ]
        }
      ]
    }
  }'
Use múltiplas seções para organizar as opções em categorias. Cada seção pode ter seu próprio título e lista de opções.