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 по запятым, удаляет пробелы вокруг каждого элемента, а затем определяет, чем является каждый элемент:

• Только цифры (допускаются + в начале и ведущие нули): считается номером телефона. Добавляется country_code, если номер ещё не начинается с него; после этого номер должен содержать от 6 до 15 цифр.
• Всё остальное: считается названием группы WhatsApp, которая ищется так же, как в API отправки в группу.
• Группа, название которой состоит только из цифр (например, 2024), считается номером телефона, а группы с запятыми в названии нельзя отправить через этот endpoint. Для них используйте API отправки в группу.

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

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

Кредиты#

Перед созданием сообщений весь пакет сверяется с остатком ваших кредитов. Учитывается каждый непустой элемент в phone, включая те, что позже будут пропущены. Если их больше, чем оставшихся кредитов, сообщения не создаются, и вы получаете:

{
  "message": "Not enough credits: 120 messages requested, 85 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 отправки сообщений отдельно для каждого получателя.