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
}'
const response = await fetch("https://zapclass.com.br/api/messages/menu", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
number: "5511999999999",
title: "Qual sua forma de pagamento preferida?",
choices: ["Cartão de Crédito", "Pix", "Boleto Bancário", "Dinheiro"],
answers: 3,
}),
});
<?php
$ch = curl_init('https://zapclass.com.br/api/messages/menu');
$payload = [
"number" => "5511999999999",
"title" => "Qual sua forma de pagamento preferida?",
"choices" => [
"Cartão de Crédito",
"Pix",
"Boleto Bancário",
"Dinheiro"
],
"answers" => 3
];
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
?>
{
"success": true,
"id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
"chat_id": "5511999999999@s.whatsapp.net"
}
{
"success": false,
"message": "Token de autenticação inválido"
}
Mensagens
Enviar Enquete
Criar enquete interativa para votação e coleta de opinião
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
}'
const response = await fetch("https://zapclass.com.br/api/messages/menu", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
number: "5511999999999",
title: "Qual sua forma de pagamento preferida?",
choices: ["Cartão de Crédito", "Pix", "Boleto Bancário", "Dinheiro"],
answers: 3,
}),
});
<?php
$ch = curl_init('https://zapclass.com.br/api/messages/menu');
$payload = [
"number" => "5511999999999",
"title" => "Qual sua forma de pagamento preferida?",
"choices" => [
"Cartão de Crédito",
"Pix",
"Boleto Bancário",
"Dinheiro"
],
"answers" => 3
];
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
?>
{
"success": true,
"id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
"chat_id": "5511999999999@s.whatsapp.net"
}
{
"success": false,
"message": "Token de autenticação inválido"
}
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
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
Exemplo:
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_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aPBody Parameters
string
required
Número do destinatário no formato internacional.
Deve incluir código do país DDI + DDD + número.
Exemplo:
Deve incluir código do país DDI + DDD + número.
Exemplo:
5511999999999string
required
Pergunta da enquete (título principal).
Exemplo:
Exemplo:
Qual sua forma de pagamento preferida?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:
Cada item é uma string simples com o texto da opção.
Exemplo:
["Cartão de Crédito", "Pix", "Boleto", "Dinheiro"]integer
Número máximo de opções que podem ser selecionadas por pessoa.
Padrão:
Use
Exemplo:
Padrão:
1 (votação única) Use
0 para permitir seleção ilimitada ou especifique um número. Exemplo:
3integer
Atraso em milissegundos antes do envio.
Durante o atraso aparecerá “Digitando…”.
Exemplo:
Durante o atraso aparecerá “Digitando…”.
Exemplo:
1000string
Identificador da mensagem para responder.
Exemplo:
Exemplo:
5511999999999:1AB2C3DEFG4H56I78JKL9Mstring
Origem do envio da mensagem.
Normalmente usado para rastreamento da mensagem.
Exemplo:
Normalmente usado para rastreamento da mensagem.
Exemplo:
typebotstring
Identificador do envio da mensagem.
Combinado com o
Exemplo:
Combinado com o
message_source pode ser usado para rastreamento. Exemplo:
5511999999999:1AB2C3DEFG4H56I78JKL9Mstring
Relação de números de telefone a serem mencionados na mensagem.
O números devem ser separads por vírgula.
Exemplo:
O números devem ser separads por vírgula.
Exemplo:
5511999999999,5511888888888boolean
Marca a conversa como lida após o envio.
Exemplo:
Exemplo:
trueboolean
Marca as últimas mensagens como lidas após o envio.
Exemplo:
Exemplo:
truecurl -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
}'
const response = await fetch("https://zapclass.com.br/api/messages/menu", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
number: "5511999999999",
title: "Qual sua forma de pagamento preferida?",
choices: ["Cartão de Crédito", "Pix", "Boleto Bancário", "Dinheiro"],
answers: 3,
}),
});
<?php
$ch = curl_init('https://zapclass.com.br/api/messages/menu');
$payload = [
"number" => "5511999999999",
"title" => "Qual sua forma de pagamento preferida?",
"choices" => [
"Cartão de Crédito",
"Pix",
"Boleto Bancário",
"Dinheiro"
],
"answers" => 3
];
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
?>
{
"success": true,
"id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
"chat_id": "5511999999999@s.whatsapp.net"
}
{
"success": false,
"message": "Token de autenticação inválido"
}
⌘I