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

# Enviar Enquete

> Criar enquete interativa para votação e coleta de opinião

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`

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

```javascript JavaScript theme={null}
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 PHP theme={null}
<?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);
?>
```

```json 200 theme={null}
{
  "success": true,
  "id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
  "chat_id": "5511999999999@s.whatsapp.net"
}
```

```json 400 theme={null}
{
  "success": false,
  "message": "Token de autenticação inválido"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.