Enviar Enquetes Automatizadas Para Canais WhatsApp Via API

1 de outubro de 2024

O recurso de enquetes nos Canais do WhatsApp é uma nova forma para administradores de canal interagirem com seu público e obterem feedback sobre diversos tópicos.

As enquetes são uma maneira simples e eficaz de aumentar o engajamento e promover a conexão da comunidade dentro dos Canais do WhatsApp. Com essa adição e a automação que Wassenger oferece, empresas podem facilmente estimular mais respostas e interagir com seu público de forma significativa.

Esses recursos abrem novas oportunidades para interações diretas e criativas com seu público, oferecendo às marcas maneiras novas de se conectar e ampliar sua comunidade.

🤩 🤖 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!

Requisitos

  • Ter um número do WhatsApp já vinculado à plataforma e online.
  • ID do Canal do WhatsApp (WID) que você pode encontrar de duas formas:
  1. No painel de gerenciamento do seu número do WhatsApp, vá em “Groups”. A partir daí você verá os canais aos quais seu número tem acesso.
  2. Usando a API, consulte os canais disponíveis em seu dispositivo pelo endpoint.

Endpoint da API

Neste tutorial usaremos o seguinte endpoint da API:

Preparar a requisição

URL alvo da API usando o método POST

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

Cabeçalhos HTTPS obrigató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": "$CHANNEL_ID@newsletter",
  "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? Vá para o testador de API ao vivo 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 em 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"
querystring = {"limit":"100"}
payload = {
"group": "$CHANNEL_ID@newsletter", 
"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?limit=100',
  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' => '$CHANNEL_ID@newsletter',
    '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' => '$CHANNEL_ID@newsletter',
    '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->setQuery(
  new http\QueryString([
    'limit' => '100',
  ])
);
$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?limit=100")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"group\":\"$CHANNEL_ID@newsletter\", \"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 do 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!

Teste ao vivo usando a API

Explore nosso testador de API ao vivo

Perguntas Frequentes

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

Se você tem vários números conectados à sua conta, é necessário especificar o campo device no corpo JSON com o ID do dispositivo do número WhatsApp (valor hexadecimal de 24 caracteres) que você deseja usar para 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 através de um número específico do WhatsApp

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

Você precisa enviar várias 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á vinculado a uma conta do WhatsApp e pode receber mensagens.

A API fornece um endpoint que pode validar se um determinado 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 checagem do WhatsApp é limitado por mês com base no seu plano de assinatura. Por favor, confira 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, por favor consulte a documentação onde você encontrará todos os detalhes sobre os parâmetros aceitos na requisição, 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