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

# Enviar Enquete

<Card title="Webhook relacionado: Voto de Enquete" icon="bolt" href="/webhook-reference/events/voto" horizontal>
  Cada voto dispara o evento **Voto de Enquete** já descriptografado, com o nome da opção escolhida.
</Card>

## Descrição

Este endpoint envia uma **enquete** (poll) interativa. O destinatário vê a pergunta e as
alternativas e pode votar diretamente no chat. Ideal para pesquisas rápidas, votações e
coleta de preferências.

### Parâmetros

<ParamField body="appkey" type="string" required>
  Chave de aplicação.
</ParamField>

<ParamField body="authkey" type="string" required>
  Chave de autenticação do usuário.
</ParamField>

<ParamField body="to" type="string" required>
  Número de telefone no formato internacional ou ID do grupo.
</ParamField>

<ParamField body="message" type="string" required>
  A **pergunta** da enquete (o texto que aparece no topo).
</ParamField>

<ParamField body="opcoes" type="array" required>
  Array de textos com as alternativas. Mínimo de **2** e máximo de **12** opções. Não pode
  haver opções repetidas.
</ParamField>

<ParamField body="multiplaEscolha" type="boolean" default="false">
  Quando `true`, o destinatário pode marcar **mais de uma** opção. Quando `false` (padrão),
  a enquete permite apenas **uma** escolha.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://chatbot.menuia.com/api/create-message \
    -H "Content-Type: application/json" \
    -d '{
      "appkey": "SUA_APPKEY_AQUI",
      "authkey": "SUA_AUTHKEY_AQUI",
      "to": "+5581999999999",
      "message": "Qual sua cor favorita?",
      "opcoes": ["Azul", "Verde", "Vermelho"],
      "multiplaEscolha": false
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://chatbot.menuia.com/api/create-message', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      appkey: 'SUA_APPKEY_AQUI',
      authkey: 'SUA_AUTHKEY_AQUI',
      to: '+5581999999999',
      message: 'Qual sua cor favorita?',
      opcoes: ['Azul', 'Verde', 'Vermelho'],
      multiplaEscolha: false
    })
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://chatbot.menuia.com/api/create-message',
      json={
          'appkey': 'SUA_APPKEY_AQUI',
          'authkey': 'SUA_AUTHKEY_AQUI',
          'to': '+5581999999999',
          'message': 'Qual sua cor favorita?',
          'opcoes': ['Azul', 'Verde', 'Vermelho'],
          'multiplaEscolha': False
      }
  )
  ```

  ```php PHP theme={null}
  $response = Http::post('https://chatbot.menuia.com/api/create-message', [
      'appkey' => 'SUA_APPKEY_AQUI',
      'authkey' => 'SUA_AUTHKEY_AQUI',
      'to' => '+5581999999999',
      'message' => 'Qual sua cor favorita?',
      'opcoes' => ['Azul', 'Verde', 'Vermelho'],
      'multiplaEscolha' => false,
  ]);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Sucesso theme={null}
  {
    "status": 200,
    "message": "Mensagem enviada com sucesso.",
    "data": {
      "idMensagem": "3EB03B7749D1CE95272DC4",
      "dataEnvio": "2026-07-27 13:40:00"
    }
  }
  ```

  ```json 403 - Enquete inválida theme={null}
  {
    "status": 403,
    "message": "A enquete precisa de pelo menos 2 opcoes"
  }
  ```

  ```json 404 - Dispositivo não encontrado theme={null}
  {
    "status": 404,
    "message": "Nenhum dispositivo conectado encontrado"
  }
  ```
</ResponseExample>