Mensagens
Enviar enquete
Poll com escolha única ou múltipla. Depois consulte os votos em GET /api/chat/poll/{instance}.
Quando usar
`name` é a pergunta. `options` é a lista de strings. `selectableOptionsCount` = 1 para única.
Os votos agregados voltam em GET `/api/chat/poll/{instance}?messageId=`.
POST
/api/message/poll/{instance}Enviar enquete
Votação nativa do WhatsApp.
Auth: TokenInstance
Body
| Campo | Tipo | Descrição | |
|---|---|---|---|
number | string | obrigatório | destino |
name | string | obrigatório | pergunta |
options | string[] | obrigatório | ["A","B","C"] |
selectableOptionsCount | number | 1 = única (padrão) |
cURL
curl -X POST https://api.wagzap.com.br/api/message/poll/vendas \
-H "token: $TOKEN_INSTANCE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999999999",
"name": "Qual canal você prefere?",
"options": [
"WhatsApp",
"E-mail",
"Telefone"
],
"selectableOptionsCount": 1
}'Resposta
{
"success": true,
"messageId": "3EB08FCF27E532F1F5F5",
"data": { "messageId": "3EB08FCF27E532F1F5F5" }
}Erros
| HTTP | Mensagem |
|---|---|
| 400 | number and message required / payload inválido |
| 401 | missing token / invalid token |
| 403 | token does not match instance |
| 404 | instance not found |
| 429 | rate limit exceeded (padrão 100/min) |
| 502 | Falha no WhatsApp / instância desconectada |