> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bliper.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Enquete

> Cria e envia uma enquete com opções de votação

## 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

```json theme={null}
{
  "phone": "5511999999999",
  "message": "Qual é o melhor plano?",
  "poll": [
    {"name": "Básico"},
    {"name": "Pro"},
    {"name": "Enterprise"}
  ],
  "selectableCount": 1
}
```

| Campo             | Tipo   | Obrigatório | Descrição                                                      |
| ----------------- | ------ | ----------- | -------------------------------------------------------------- |
| `phone`           | string | Sim         | Número do destinatário no formato DDI+DDD+número               |
| `message`         | string | Sim         | Pergunta da enquete                                            |
| `poll`            | array  | Sim         | Lista de opções, cada uma como um objeto com o campo `name`    |
| `selectableCount` | number | Não         | Número máximo de opções que podem ser selecionadas (padrão: 1) |

## Response

### Sucesso (202)

```json theme={null}
{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
```

## Exemplo cURL

```bash theme={null}
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
  }'
```

<Tip>Defina `selectableCount` maior que 1 para permitir que os usuários votem em mais de uma opção simultaneamente.</Tip>