Skip to main content
POST
/
messages
/
menu-poll
curl -X POST https://zapclass.com.br/api/messages/menu \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
  -d '{
    "number": "5511999999999",
    "title": "Qual sua forma de pagamento preferida?",
    "choices": [
      "Cartão de Crédito",
      "Pix",
      "Boleto Bancário",
      "Dinheiro"
    ],
    "answers": 3
  }'

{
  "success": true,
  "id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
  "chat_id": "5511999999999@s.whatsapp.net"
}
Enquetes permitem coletar feedback, realizar votações e pesquisas de opinião de forma interativa diretamente no WhatsApp. Os participantes podem votar em uma ou múltiplas opções.

​
Como Funciona

O usuário visualiza a pergunta e as opções disponíveis, seleciona sua(s) escolha(s) e confirma o voto. O WhatsApp exibe o progresso da votação em tempo real.

​
Características

Votação Simples

Uma opção por pessoa (padrão)

Votação Múltipla

Permite selecionar várias opções

Resultados em Tempo Real

Atualização automática dos votos

Até 12 Opções

Máximo de alternativas por enquete

​
Authorization

​
api_key
string
required
Chave de autenticação da sua conexão, utilizada no header Authorization como Bearer Token.
Você encontra sua API Key no botão API da sua conexão no painel ZapClass.
A chave sempre começa com o prefixo zc_.
Exemplo: zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP

​
Body Parameters

​
number
string
required
Número do destinatário no formato internacional.
Deve incluir código do país DDI + DDD + número.
Exemplo: 5511999999999
​
title
string
required
Pergunta da enquete (título principal).
Exemplo: Qual sua forma de pagamento preferida?
​
choices
array
required
Lista com as opções de voto (máximo 12 opções).
Cada item é uma string simples com o texto da opção.
Exemplo: ["Cartão de Crédito", "Pix", "Boleto", "Dinheiro"]
​
answers
integer
Número máximo de opções que podem ser selecionadas por pessoa.
Padrão: 1 (votação única)
Use 0 para permitir seleção ilimitada ou especifique um número.
Exemplo: 3
​
delay
integer
Atraso em milissegundos antes do envio.
Durante o atraso aparecerá “Digitando…”.
Exemplo: 1000
​
message_reply_id
string
Identificador da mensagem para responder.
Exemplo: 5511999999999:1AB2C3DEFG4H56I78JKL9M
​
message_source
string
Origem do envio da mensagem.
Normalmente usado para rastreamento da mensagem.
Exemplo: typebot
​
message_id
string
Identificador do envio da mensagem.
Combinado com o message_source pode ser usado para rastreamento.
Exemplo: 5511999999999:1AB2C3DEFG4H56I78JKL9M
​
mentions
string
Relação de números de telefone a serem mencionados na mensagem.
O números devem ser separads por vírgula.
Exemplo: 5511999999999,5511888888888
​
read
boolean
Marca a conversa como lida após o envio.
Exemplo: true
​
read_messages
boolean
Marca as últimas mensagens como lidas após o envio.
Exemplo: true
curl -X POST https://zapclass.com.br/api/messages/menu \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
  -d '{
    "number": "5511999999999",
    "title": "Qual sua forma de pagamento preferida?",
    "choices": [
      "Cartão de Crédito",
      "Pix",
      "Boleto Bancário",
      "Dinheiro"
    ],
    "answers": 3
  }'

{
  "success": true,
  "id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
  "chat_id": "5511999999999@s.whatsapp.net"
}