API de envio para vários números

Envie a mesma mensagem de WhatsApp para vários números de telefone e grupos em uma única requisição. Use-a para pequenos disparos, como newsletters, ofertas e comunicados.

O WbizTool cria uma mensagem por destinatário e retorna um msg_id para cada uma, para que você possa verificar o status de cada mensagem individualmente.

Exemplo rápido#

curl -X POST https://wbiztool.com/api/v1/send_msg/multi/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210,9812345670,Sales Team Mumbai",
    "msg": "Our Diwali sale starts tomorrow. Get 20% off on all orders!"
  }'

import requests

response = requests.post(
    "https://wbiztool.com/api/v1/send_msg/multi/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "msg_type": 0,
        "country_code": "91",
        "phone": ",".join(["9876543210", "9812345670", "Sales Team Mumbai"]),
        "msg": "Our Diwali sale starts tomorrow. Get 20% off on all orders!",
    },
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 400

if result.get("status") == 1:
    for item in result["messages"]:
        print(item["contact"], "->", item["msg_id"])
else:
    print("Failed:", result.get("message", "no message in response"))

// 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/multi/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: 12345,
    api_key: "YOUR_API_KEY",
    whatsapp_client: 678,
    msg_type: 0,
    country_code: "91",
    phone: ["9876543210", "9812345670", "Sales Team Mumbai"].join(","),
    msg: "Our Diwali sale starts tomorrow. Get 20% off on all orders!",
  }),
});
const result = await response.json(); // read the body even when the HTTP code is 400

if (result.status === 1) {
  for (const item of result.messages) {
    console.log(item.contact, "->", item.msg_id);
  }
} else {
  console.error("Failed:", result.message ?? "no message in response");
}

<?php
$payload = [
    'client_id'       => 12345,
    'api_key'         => 'YOUR_API_KEY',
    'whatsapp_client' => 678,
    'msg_type'        => 0,
    'country_code'    => '91',
    'phone'           => implode(',', ['9876543210', '9812345670', 'Sales Team Mumbai']),
    'msg'             => 'Our Diwali sale starts tomorrow. Get 20% off on all orders!',
];

$ch = curl_init('https://wbiztool.com/api/v1/send_msg/multi/');
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) {
    foreach ($result['messages'] as $item) {
        echo $item['contact'] . ' -> ' . $item['msg_id'] . PHP_EOL;
    }
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no message in response');
}

Substitua 12345, YOUR_API_KEY e 678 pelos seus próprios valores. Veja em Autenticação onde encontrá-los.

Parâmetros da requisição#

curl -X POST https://wbiztool.com/api/v1/send_msg/multi/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210,9812345670",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts tomorrow."
  }'

Como os destinatários são lidos#

O WbizTool divide phone nas vírgulas, remove os espaços ao redor de cada item e então decide o que cada item é:

• Números de telefone podem ser escritos como você os tem: +91 98765 43210, 98765-43210, (987) 654-3210, 0091 98765 43210 e +44 (0)20 7946 0018 funcionam, assim como valores de planilha como 919876543210.0 e 9.19876543210E+11.
• country_code é adicionado a menos que o número já comece com ele ou esteja escrito com + ou 00: +44 20 7946 0018 com country_code 91 continua 442079460018. Assim, uma lista pode misturar países: escreva os números dos outros países com +.
• Um número local escrito com o 0 inicial também funciona: 09876543210 com country_code 91 vai para 919876543210, e 0612345678 com 39 (Itália, onde o 0 faz parte do número) vai para 390612345678.
• Com o código do país incluído, um número precisa ter de 7 a 15 dígitos.
• Texto com letras ou outros símbolos, como Sales Team Mumbai ou Family 2024, é tratado como nome de grupo de WhatsApp, encontrado da mesma forma que em Enviar para um grupo.
• Um nome de grupo sem letras, como 2024-2025, é lido como número de telefone, a menos que tenha menos de 10 dígitos e o seu espaço de trabalho já tenha enviado uma mensagem para um grupo com exatamente esse nome (ele aparece em Grupos nos Contatos). Um nome curto, com menos de 7 dígitos e um hífen, ponto ou parênteses, como 2024-25 ou (2024), é sempre um nome de grupo. Nomes de grupo que contêm vírgulas não podem ser usados neste endpoint. Para esses casos, use Enviar para um grupo.
• De uma conta do Telegram, um @username, um link t.me/username ou tg:<id> é uma pessoa, não um nome de grupo, e um número de telefone vai para essa pessoa no Telegram. De um número de WhatsApp, nomes de usuário, links t.me e tg:<id> são ignorados.

Outros pontos importantes:

• Números curtos ou longos demais depois de adicionar o código do país, valores de planilha arredondados e itens que são só zeros (0, 00) são ignorados sem aviso. Eles não aparecem na resposta e não recebem um msg_id.
• Duplicados não são removidos. Um número listado duas vezes recebe duas mensagens.
• Se um número local começar com os mesmos dígitos de country_code (por exemplo 9123456780 com country_code 91), o código não é adicionado. Envie esses números já com o código do país incluído (919123456780).
• As URLs de imagens e arquivos não são verificadas quando você chama a API. Elas são baixadas no envio de cada mensagem, então um link quebrado faz as mensagens falharem depois, e não a requisição. Valem as mesmas regras de envio de Enviar mensagem: imagens acima de 16 MB e vídeos acima de 64 MB falham, áudio WAV e OGG não pode ser enviado como imagem (msg_type 1), e arquivos (msg_type 2) sem extensão ou com uma que não é aceita recebem .pdf no final. Veja Enviar imagens e arquivos.

Limites de mensagens#

O lote inteiro é verificado antes de qualquer mensagem ser criada, então uma lista nunca é enviada pela metade. Todo item não vazio em phone conta, inclusive os que forem ignorados depois, e mensagens na fila que ainda não foram enviadas também contam.

• Todos os planos: o lote precisa caber no limite diário de uso justo do número que envia – 1.000 mensagens em quaisquer 24 horas. Caso contrário, nenhuma mensagem é criada e você recebe:

{
  "message": "Daily limit reached: a number can send 1,000 messages in 24 hours (fair use). Send the rest tomorrow. 1200 messages requested, 640 more can go out from this number in the next 24 hours.",
  "code": "daily_limit_reached",
  "status": 0
}

• Plano gratuito: o lote também precisa caber nas mensagens grátis que restam ao espaço de trabalho (50 em quaisquer 30 dias). Caso contrário, você recebe:

{
  "message": "Not enough credits: 120 messages requested, 35 credits remaining",
  "status": 0
}

Divida listas grandes entre vários números ou dias. Para campanhas grandes, envie uma planilha pela página Campanhas.

Resposta#

Uma requisição bem-sucedida retorna HTTP 200:

{
  "msg_ids": [9817263, 9817264, 9817265],
  "messages": [
    { "msg_id": 9817263, "contact": "919876543210", "is_group": false },
    { "msg_id": 9817264, "contact": "919812345670", "is_group": false },
    { "msg_id": 9817265, "contact": "Sales Team Mumbai", "is_group": true }
  ],
  "message": "Successfully created 3 messages",
  "status": 1
}

Compare messages com a lista que você enviou para encontrar números ignorados, e confira se is_group é false em todos os itens que você queria enviar como número de telefone.

Erros#

A maioria dos erros retorna HTTP 200 com status igual a 0, então sempre verifique status no corpo. Com exceção dos erros HTTP 400 e 403, as respostas (inclusive as de sucesso) são JSON enviado com Content-Type: text/html, então interprete o corpo você mesmo em vez de depender da detecção automática de JSON (por exemplo, em ferramentas no-code):

{ "message": "Invalid whatsapp client", "status": 0 }

Dicas#

• Envie phone como string: junte sua lista com vírgulas. Um array JSON retorna {}.
• Não use o send_bulk_messages do cliente Python por enquanto: ele envia a lista como phones, que este endpoint ignora. Chame o endpoint diretamente, como nos exemplos acima.
• Acompanhe cada mensagem: guarde cada msg_id de messages, ou informe um webhook para ser notificado quando cada uma for enviada, falhar, for cancelada ou expirar.
• Mantenha seu número conectado: todas as mensagens são enviadas do seu número de WhatsApp, então ele precisa continuar conectado nas configurações do WhatsApp até que o lote inteiro tenha sido enviado.
• Texto diferente para cada pessoa: este endpoint envia o mesmo msg para todos. Chame Enviar mensagem uma vez por destinatário para personalizar cada mensagem.