Skip to main content
POST
/
instances
/
{INSTANCE_ID}
/
token
/
{INSTANCE_TOKEN}
/
send-poll
Enviar Enquete
curl --request POST \
  --url https://api.example.com/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-poll

​
Descrição

Cria e envia uma enquete interativa para um contato ou grupo. Os destinatários podem votar nas opções diretamente pelo WhatsApp.

​
Request

​
Headers

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

​
Body

{
  "phone": "5511999999999",
  "message": "Qual é o melhor plano?",
  "poll": [
    {"name": "Básico"},
    {"name": "Pro"},
    {"name": "Enterprise"}
  ],
  "selectableCount": 1
}
CampoTipoObrigatórioDescrição
phonestringSimNúmero do destinatário no formato DDI+DDD+número
messagestringSimPergunta da enquete
pollarraySimLista de opções, cada uma como um objeto com o campo name
selectableCountnumberNãoNúmero máximo de opções que podem ser selecionadas (padrão: 1)

​
Response

​
Sucesso (202)

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

​
Exemplo cURL

curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-poll' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Qual é o melhor plano?",
    "poll": [
      {"name": "Básico"},
      {"name": "Pro"},
      {"name": "Enterprise"}
    ],
    "selectableCount": 1
  }'
Defina selectableCount maior que 1 para permitir que os usuários votem em mais de uma opção simultaneamente.