Pular para o conteúdo
WbizTool

Envie mensagens para um grupo do WhatsApp com a API

Publique avisos da equipe, novidades da comunidade e relatórios diários em um grupo do WhatsApp a partir do seu próprio código. Seu número de WhatsApp conectado envia para qualquer grupo de que ele seja membro, escolhido pelo nome exato do grupo.

Comece grátis

Teste grátis: 50 mensagens em quaisquer 30 dias, sem cartão.

Como funciona

  1. Pegue sua chave de API e conecte seu número

    Cadastre-se e conecte seu número de WhatsApp na página Números do WhatsApp com um código QR ou um código de login, como no WhatsApp Web. Em Configurações → Chaves de API, crie uma chave e copie seu Client ID (o guia de chaves de API abaixo mostra onde). O ID no cartão do número (como ID 678) é o seu whatsapp_client.

  2. Confira se o seu número está no grupo

    O número que envia precisa ser membro do grupo, e administrador se só os administradores puderem postar nele. Anote o nome do grupo exatamente como o WhatsApp mostra, com emojis e pontuação.

  3. Envie para o grupo

    Faça um POST para https://wbiztool.com/api/v1/send_msg/group/ com group_name e msg. Uma resposta com "status": 1 e um msg_id significa que a mensagem está na fila.

  4. Confira se ela saiu

    O grupo é procurado quando a mensagem é enviada, não quando você chama a API. Consulte o status da mensagem ou um webhook: um nome errado falha nesse momento com Group not found.

Exemplos de código: Mensagens para grupos

Enviar um texto para um grupo (cURL)
curl -X POST https://wbiztool.com/api/v1/send_msg/group/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "group_name": "Sales Team Mumbai",
    "msg": "Reminder: *weekly review* starts at 4 PM today."
  }'
Python (requests)
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/send_msg/group/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "msg_type": 0,
        "group_name": "Sales Team Mumbai",
        "msg": "Reminder: *weekly review* starts at 4 PM today.",
    },
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 400

if result.get("status") == 1:
    print("Queued with msg_id", result["msg_id"])
else:
    print("Failed:", result.get("message"))
Python (cliente oficial)
from wbiztool_client import WbizToolClient

client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)

result = client.send_message_to_group(
    group_name="Sales Team Mumbai",
    msg="Reminder: weekly review starts at 4 PM today.",
    whatsapp_client=678,
)
print(result)
Node.js (fetch): uma imagem a partir de uma URL
// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/send_msg/group/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: 12345,
    api_key: "YOUR_API_KEY",
    whatsapp_client: 678,
    msg_type: 1,
    group_name: "Sales Team Mumbai",
    img_url: "https://example.com/reports/weekly-sales.png",
    msg: "This week's sales summary",
  }),
});
console.log(await response.json());
PHP (extensão cURL)
<?php
$payload = [
    'client_id'       => 12345,
    'api_key'         => 'YOUR_API_KEY',
    'whatsapp_client' => 678,
    'msg_type'        => 0,
    'group_name'      => 'Sales Team Mumbai',
    'msg'             => 'Reminder: *weekly review* starts at 4 PM today.',
];

$ch = curl_init('https://wbiztool.com/api/v1/send_msg/group/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['status'] ?? 0) === 1) {
    echo 'Queued with msg_id ' . $result['msg_id'];
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

O que você pode fazer

  • Textos, imagens e arquivos

    msg_type 0 envia texto, 1 uma imagem de img_url e 2 um arquivo de file_url, ou envie o arquivo como multipart form data em um campo chamado file.

  • Escolhido pelo nome do grupo

    Não há ID de grupo para procurar: group_name é o nome exato do grupo no WhatsApp. Escreva-o com as mesmas maiúsculas e minúsculas que o WhatsApp mostra; nomes parciais não funcionam.

  • Agende uma mensagem para o grupo

    A API de agendamento de mensagens (/api/v1/schedule_msg/) aceita group_name em vez de phone, com data, hora e fuso horário.

  • Grupos e números na mesma requisição

    O envio para vários números aceita nomes de grupos misturados com números de telefone, então uma chamada pode chegar a vários grupos.

  • Status por webhook

    Passe webhook para receber um POST com o msg_id e SENT ou FAILED, ou consulte o status da mensagem com o msg_id.

Bom saber

  • Enviar para um grupo do WhatsApp pela API (group_name em vez de phone) funciona em todos os planos, inclusive no teste grátis.
  • O nome do grupo não é verificado quando você chama a API, então "status": 1 significa só que a mensagem está na fila. Um nome que não bate exatamente, um contato com o mesmo nome ou um grupo só para administradores em que o seu número não pode postar falha depois com Group not found.
  • Se dois grupos tiverem exatamente o mesmo nome, a mensagem vai para o primeiro nos resultados de busca do WhatsApp. Dê a cada grupo um nome único e atualize group_name se alguém renomear o grupo.
  • Cada mensagem para grupo conta como uma mensagem nas 1.000 por dia do número dentro do uso justo.
  • As mensagens saem do seu próprio número de WhatsApp, então as regras do próprio WhatsApp valem: mande mensagens para quem espera ter notícias suas.

Perguntas frequentes

Como encontro o ID de um grupo do WhatsApp?
Você não precisa dele. A API encontra o grupo pelo nome: envie group_name exatamente como o WhatsApp mostra, com emojis e pontuação, de um número que esteja no grupo.
Quais planos podem enviar para grupos pela API?
Todos os planos, inclusive o teste grátis. Uma mensagem para grupo conta como uma mensagem, igual a uma mensagem para um número de telefone.
Por que minha mensagem para o grupo falhou com Group not found?
O nome não bateu exatamente com um grupo, um contato tem o mesmo nome, seu número não está no grupo, ou só administradores podem postar e o seu número não é um deles. Confira a grafia exata e as maiúsculas no WhatsApp.
Posso agendar uma mensagem para um grupo?
Sim. Faça um POST para /api/v1/schedule_msg/ com group_name em vez de phone, mais date (dd/mm/aaaa), time (HH:MM) e timezone.
Preciso da API oficial do WhatsApp Business ou de aprovação da Meta?
Não. O WbizTool envia do seu próprio número de WhatsApp ou WhatsApp Business, conectado como no WhatsApp Web. Não há aprovação da Meta nem modelos de mensagem para aprovar.

Leia os guias

Veja também

Envie hoje sua primeira mensagem automática de WhatsApp

Crie uma conta, escaneie o QR code e envie uma mensagem em menos de cinco minutos.

Comece grátis

Planos pagos a partir de US$ 25 por mês nos EUA. Preços