Enviar Enquete

Enviar enquete (votação) para um contato ou grupo

POST /api/sendPoll

Enviar uma enquete com opções

cURL

curl --request POST \
  --url https://{host}/api/sendPoll \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "chatId": "[e-mail]",
  "poll": {
    "name": "Qual o melhor horário para a reunião?",
    "options": [
      "Manhã (9h)",
      "Tarde (14h)",
      "Noite (19h)"
    ],
    "multipleAnswers": false
  },
  "session": "my-session",
  "reply_to": null
}
'

Resposta de Sucesso

{
  "success": true,
  "messageId": "3EB0XXXXXX"
}

Descrição

Este endpoint permite enviar uma enquete (poll) para contatos individuais ou grupos no WhatsApp. Você pode criar enquetes com múltiplas opções e configurar se permite respostas múltiplas ou apenas uma resposta.

Body

{
  "sessionId": "my-session",
  "jid": "[e-mail]",
  "poll": {
    "name": "Meu Grupo",
    "options": [
      "Opção 1",
      "Opção 2"
    ],
    "multipleAnswers": true
  }
}

Parâmetros do Body

Propriedade	Tipo	Obrigatório	Descrição
sessionId	string	✅ Sim	ID da sessão autenticada que enviará a enquete
jid	string	✅ Sim	Identificador do destinatário (JID do WhatsApp). Formato: [e-mail] para contatos ou [e-mail] para grupos
poll	object	✅ Sim	Objeto contendo as informações da enquete
poll.name	string	✅ Sim	Pergunta ou título da enquete
poll.options	array	✅ Sim	Array de strings com as opções de resposta (mínimo 2 opções)
poll.multipleAnswers	boolean	❌ Não	Define se permite múltiplas respostas (padrão: false)

Resposta de Sucesso

{
  "success": true,
  "messageId": "3EB0XXXXXX"
}

Códigos de Status

• 200 - Enquete enviada com sucesso
• 400 - Parâmetros inválidos
• 401 - Sessão não autorizada
• 404 - Sessão não encontrada

Exemplo de Uso

cURL

curl -X POST https://api.wappfy.com.br/api/sendPoll \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "my-session",
    "jid": "[e-mail]",
    "poll": {
      "name": "Qual o melhor horário para a reunião?",
      "options": ["Manhã (9h)", "Tarde (14h)", "Noite (19h)"],
      "multipleAnswers": false
    }
  }'

Authorizations

apikey · string · header · required

Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)

Body

application/json

chatId · string · required

Identificador do chat (JID do WhatsApp)

Example:

"[e-mail]"

poll · object · required

Objeto contendo as informações da enquete

Show child attributes

session · string · required

Nome da sessão (instanceName)

Example:

"my-session"

reply_to · string

ID da mensagem à qual você deseja responder

Example:

null

Response

201 - undefined