Como Enviar Enquetes Para Grupos do WhatsApp Via API

29 de setembro de 2024

Aprenda como enviar mensagens de enquete para Grupos do WhatsApp usando a API da Wassenger, que torna super fácil automatizar a comunicação pelo WhatsApp para sua empresa e clientes.

Vamos dar uma olhada mais de perto nas enquetes do WhatsApp, desde exatamente como elas funcionam até as melhores formas de empresas usarem enquetes em suas estratégias de marketing e automação com a Wassenger API.

🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100 casos de uso da API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos! https://wassenger.com/register

Requisitos

  • Ter um número do WhatsApp já vinculado à plataforma e online.
  • ID do Grupo do WhatsApp (WID) que você pode encontrar de duas maneiras:

Como obter o ID do Grupo do WhatsApp

Você pode obter o ID do Grupo do WhatsApp usando um destes métodos:

  1. Web: vá para configurações do número > Grupos > Copie o WID do Grupo.
  2. API: consulte os grupos disponíveis no seu número usando este endpoint.

Endpoint da API

Usaremos o seguinte endpoint da API para enviar uma nova enquete:

Preparar a requisição

URL da API alvo usando o método POST

https://api.wassenger.com/v1/messages

Cabeçalhos HTTPS necessários > Obtenha sua chave de API aqui

Content-Type: application/json
Token: $API_TOKEN

Use o corpo em formato JSON para enviar a nova enquete

{
  "group": "$GROUP_ID@g.us",
  "poll": {
    "name": "Which product of ours do you use the most?",
    "options": [
      "Product A - Wireless Headphones",
      "Product B - Smartwatch",
      "Product C - Fitness Tracker",
      "Product D - Bluetooth Speaker",
      "Product E - Smartphone Charger",
      "Product F - Laptop Stand",
      "Product G - Home Security Camera",
      "Product H - Smart Light Bulb",
      "Product I - Portable Power Bank"
    ]
  }
}

🖥️ Procurando um exemplo de código? Acesse o testador ao vivo da API e obtenha exemplos de código prontos para uso em mais de 15 linguagens de programação, incluindo Python, JavaScript, PHP, C#, Java, Ruby, Go, Powershell, cURL e mais.

Enviar enquetes usando código

Explore como usar o código no seu navegador sem instalar nenhum software.

Além disso, você pode encontrar diferentes linguagens que pode testar no Replit.com:

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = {
"group": "$GROUP_ID@g.us", 
"poll": {
"name": "Which product of ours do you use the most?", 
"options": ["Product A - Wireless Headphones", "Product B - Smartwatch", "Product C - Fitness Tracker", "Product D - Bluetooth Speaker", "Product E - Smartphone Charger", "Product F - Laptop Stand", "Product G - Home Security Camera", "Product H - Smart Light Bulb", "Product I - Portable Power Bank"]
}
}
headers = {
"Content-Type": "application/json", 
"Token": "API TOKEN GOES HERE"
}
response = requests.post(url, json=payload, headers=headers, params=querystring)
print(response.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
    'group' => '$GROUP_ID@g.us',
    'poll' => [
      'name' => 'Which product of ours do you use the most?',
      'options' => [
        'Product A - Wireless Headphones',
        'Product B - Smartwatch',
        'Product C - Fitness Tracker',
        'Product D - Bluetooth Speaker',
        'Product E - Smartphone Charger',
        'Product F - Laptop Stand',
        'Product G - Home Security Camera',
        'Product H - Smart Light Bulb',
        'Product I - Portable Power Bank',
      ],
    ],
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Token: API TOKEN GOES HERE',
  ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}

🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!

// Examples requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://pecl.php.net/package/pecl_http/3.2.0
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'group' => '$GROUP_ID@g.us',
    'poll' => [
      'name' => 'Which product of ours do you use the most?',
      'options' => [
        'Product A - Wireless Headphones',
        'Product B - Smartwatch',
        'Product C - Fitness Tracker',
        'Product D - Bluetooth Speaker',
        'Product E - Smartphone Charger',
        'Product F - Laptop Stand',
        'Product G - Home Security Camera',
        'Product H - Smart Light Bulb',
        'Product I - Portable Power Bank',
      ],
    ],
  ])
);
$request->setRequestUrl('https://api.wassenger.com/v1/messages');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'API TOKEN GOES HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();
// This code requires you to have installed Unirest package.
// Documentation: https://kong.github.io/unirest-java/#requests
// Installation: http://kong.github.io/unirest-java/
HttpResponse<String> response = Unirest.post("https://api.wassenger.com/v1/messages")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"group\":\"$GROUP_ID@g.us\", \"poll\":{\"name\":\"Which product of ours do you use the most?\", \"options\":[\"Product A - Wireless Headphones\", \"Product B - Smartwatch\", \"Product C - Fitness Tracker\", \"Product D - Bluetooth Speaker\", \"Product E - Smartphone Charger\", \"Product F - Laptop Stand\", \"Product G - Home Security Camera\", \"Product H - Smart Light Bulb\", \"Product I - Portable Power Bank\"]}}")
.asString();

Precisa de mais? Explore todos os nossos exemplos de enquetes no WhatsApp e mergulhe de cabeça!

🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100 casos de uso da API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos! https://wassenger.com/register

Teste ao vivo usando a API

Explore nosso testador ao vivo da API

Perguntas Frequentes

Tenho vários números conectados: como envio mensagens através de um número específico?

Se você tiver vários números conectados à sua conta, precisa especificar o campo device no corpo JSON com o ID do dispositivo do número do WhatsApp alvo (valor hexadecimal de 24 caracteres) pelo qual deseja enviar as mensagens.

Se o campo device não for especificado, as mensagens serão enviadas pelo primeiro número do WhatsApp conectado na sua conta.

Aqui está um exemplo de como enviar uma mensagem por um número específico do WhatsApp

Como enviar mensagens para vários números de telefone

Você precisa enviar múltiplas requisições à API, uma por número de telefone alvo.

Por exemplo, se você quiser enviar uma mensagem para 10 números de telefone, deve enviar 10 requisições HTTPS independentes para a API.

Não há opção para enviar múltiplas mensagens em uma única requisição da API.

Como validar se um número de telefone pode receber mensagens do WhatsApp

Você pode validar se um determinado número de telefone está ligado a uma conta do WhatsApp e pode receber mensagens.

A API fornece um endpoint que pode validar se um dado número de telefone existe no WhatsApp ou não.

O único requisito é ter pelo menos um número do WhatsApp conectado à plataforma na sua conta atual.

Para mais detalhes, por favor consulte a documentação do endpoint da API aqui.

Antes de verificar se um número de telefone existe no WhatsApp, você também pode validar e normalizar o formato de uma lista de números de telefone usando o endpoint validador de números. Este endpoint apenas valida o formato correto E164 format, mas não verifica se o número de telefone efetivamente existe no WhatsApp.

Nota: O número de validações de verificação do WhatsApp é limitado por mês com base no seu plano de assinatura. Por favor, consulte a tabela de preços para mais detalhes sobre os limites.

Procurando mais respostas? Confira as FAQs estendidas.

Outros recursos úteis

Documentação da API

Para mais detalhes sobre o endpoint da API, consulte a documentação onde você encontrará todos os detalhes sobre os parâmetros de requisição aceitos, possíveis respostas de sucesso ou erro e exemplos de código prontos para uso em múltiplas linguagens de programação:

https://app.wassenger.com/docs/#tag/Messages/operation/createMessage

🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free