API отправки на несколько номеров

Отправляйте одно и то же сообщение WhatsApp на несколько номеров телефонов и в группы одним запросом. Подходит для небольших рассылок: новостей, предложений и объявлений.

WbizTool создаёт отдельное сообщение для каждого получателя и возвращает msg_id для каждого из них, чтобы вы могли проверить их статус по отдельности.

Быстрый пример#

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');
}

Замените 12345, YOUR_API_KEY и 678 своими значениями. Где их найти, описано в разделе Аутентификация.

Параметры запроса#

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."
  }'

Как разбираются получатели#

WbizTool разбивает phone по запятым, удаляет пробелы вокруг каждого элемента, а затем определяет, чем является каждый элемент:

• Номера телефонов можно писать так, как они у вас есть: +91 98765 43210, 98765-43210, (987) 654-3210, 0091 98765 43210 и +44 (0)20 7946 0018 подходят, как и значения из таблиц, например 919876543210.0 и 9.19876543210E+11.
• country_code добавляется, если номер ещё не начинается с него и не написан с + или 00: +44 20 7946 0018 с country_code 91 остаётся 442079460018. Поэтому в одном списке можно смешивать страны: пишите номера других стран с +.
• Местный номер с ведущим 0 тоже работает: 09876543210 с country_code 91 уходит на 919876543210, а 0612345678 с 39 (Италия, где 0 — часть номера) — на 390612345678.
• Вместе с кодом страны номер должен содержать от 7 до 15 цифр.
• Текст с буквами или другими символами, например Sales Team Mumbai или Family 2024, считается названием группы WhatsApp, которая ищется так же, как в API отправки в группу.
• Название группы без букв, например 2024-2025, читается как номер телефона, если только в нём не меньше 10 цифр и ваше рабочее пространство уже не отправляло сообщение в группу с точно таким названием (она есть в разделе Группы в Контактах). Короткое название, в котором меньше 7 цифр и есть дефис, точка или скобки, например 2024-25 или (2024), всегда считается названием группы. Группы с запятыми в названии нельзя отправить через этот endpoint. Для них используйте API отправки в группу.
• С аккаунта Telegram @username, ссылка t.me/username или tg:<id> — это человек, а не название группы, а номер телефона уходит этому человеку в Telegram. С номера WhatsApp имена пользователей, ссылки t.me и tg:<id> пропускаются.

Что ещё нужно знать:

• Номера, которые после добавления кода страны оказываются слишком короткими или слишком длинными, округлённые значения из таблиц и элементы только из нулей (0, 00) молча пропускаются. Они не появляются в ответе и не получают msg_id.
• Дубликаты не удаляются. Номер, указанный дважды, получит два сообщения.
• Если местный номер случайно начинается с тех же цифр, что и country_code (например, 9123456780 при country_code 91), код не добавляется. Передавайте такие номера сразу с кодом страны (919123456780).
• URL изображений и файлов не проверяются при вызове API. Они скачиваются при отправке каждого сообщения, поэтому из-за нерабочей ссылки позже завершатся ошибкой сами сообщения, а не запрос. Действуют те же правила отправки, что и в API отправки сообщений: изображения больше 16 МБ и видео больше 64 МБ не проходят, аудио WAV и OGG нельзя отправить как изображение (msg_type 1), а к файлам (msg_type 2) без расширения или с неподдерживаемым расширением добавляется .pdf. См. Отправка изображений и файлов.

Лимиты сообщений#

Весь пакет проверяется до создания сообщений, поэтому список никогда не отправляется частично. Учитывается каждый непустой элемент в phone, включая те, что позже будут пропущены, а также сообщения, которые стоят в очереди, но ещё не отправлены.

• Любой тариф: пакет должен уложиться в дневной лимит честного использования номера-отправителя — 1 000 сообщений за любые 24 часа. Иначе сообщения не создаются, и вы получаете:

{
  "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
}

• Бесплатный тариф: пакет также должен уложиться в оставшиеся бесплатные сообщения рабочего пространства (50 за любые 30 дней). Иначе вы получаете:

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

Распределяйте большие списки на несколько номеров или дней. Для крупных кампаний загрузите таблицу на странице Кампании.

Ответ#

Успешный запрос возвращает 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
}

Сравните messages с отправленным списком, чтобы найти пропущенные номера, и проверьте, что is_group равен false для каждого элемента, который вы передавали как номер телефона.

Ошибки#

Большинство ошибок возвращаются с HTTP 200 и status, равным 0, поэтому всегда проверяйте status в теле ответа. Кроме ошибок с HTTP 400 и 403, ответы (включая успешные) — это JSON с заголовком Content-Type: text/html, поэтому разбирайте тело самостоятельно, а не полагайтесь на автоматическое определение JSON (например, в no-code-инструментах):

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

Советы#

• Передавайте phone строкой: объедините список через запятую. На JSON-массив возвращается {}.
• Пока не используйте send_bulk_messages из клиента для Python: он передаёт список как phones, а этот endpoint такое поле игнорирует. Вызывайте endpoint напрямую, как в примерах выше.
• Отслеживайте каждое сообщение: сохраняйте каждый msg_id из messages или передайте webhook, чтобы получать уведомление об отправке, ошибке, отмене или истечении срока каждого сообщения.
• Держите номер подключённым: все сообщения отправляются с вашего номера WhatsApp, поэтому он должен оставаться подключённым в настройках WhatsApp, пока не уйдёт весь пакет.
• Разный текст для разных людей: этот endpoint отправляет всем один и тот же msg. Чтобы персонализировать сообщения, вызывайте API отправки сообщений отдельно для каждого получателя.