API Kirim ke Banyak Nomor

Kirim pesan WhatsApp yang sama ke beberapa nomor telepon dan grup dalam satu request. Gunakan untuk siaran kecil seperti newsletter, penawaran, dan pengumuman.

Wbiztool membuat satu pesan per penerima dan mengembalikan msg_id untuk masing-masing, sehingga Anda dapat memeriksa statusnya satu per satu.

Contoh singkat#

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

Ganti 12345, YOUR_API_KEY, dan 678 dengan nilai Anda sendiri. Lihat Autentikasi untuk mengetahui di mana menemukannya.

Parameter request#

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

Cara penerima dibaca#

Wbiztool memecah phone berdasarkan koma, menghapus spasi di sekitar setiap item, lalu menentukan jenis setiap item:

• Hanya angka (awalan + atau angka nol di depan tidak masalah): diperlakukan sebagai nomor telepon. country_code ditambahkan kecuali nomornya sudah diawali kode tersebut, lalu nomornya harus sepanjang 6 hingga 15 digit.
• Selain itu: diperlakukan sebagai nama grup WhatsApp, yang dicari dengan cara yang sama seperti di Kirim ke grup.
• Grup yang namanya hanya berisi angka (misalnya 2024) diperlakukan sebagai nomor telepon, dan nama grup yang mengandung koma tidak bisa dikirimi dari endpoint ini. Gunakan Kirim ke grup untuk grup tersebut.

Hal lain yang perlu diketahui:

• Nomor yang terlalu pendek atau terlalu panjang setelah kode negara ditambahkan dilewati tanpa pemberitahuan. Nomor tersebut tidak muncul di respons dan tidak mendapat msg_id.
• Duplikat tidak dihapus. Nomor yang dicantumkan dua kali menerima dua pesan.
• Jika sebuah nomor lokal kebetulan diawali angka yang sama dengan country_code (misalnya 9123456780 dengan country_code 91), kode negara tidak ditambahkan. Kirim nomor seperti itu lengkap dengan kode negaranya (919123456780).
• URL gambar dan file tidak diperiksa saat Anda memanggil API. URL tersebut diunduh saat setiap pesan dikirim, sehingga tautan yang rusak membuat pesan gagal belakangan, bukan request-nya. Aturan saat pengiriman yang sama seperti Kirim pesan berlaku: gambar lebih dari 16 MB dan video lebih dari 64 MB gagal, audio WAV dan OGG tidak didukung, dan file (msg_type 2) tanpa ekstensi yang didukung ditambahi .pdf. Lihat Mengirim gambar dan file.

Kredit#

Seluruh batch diperiksa terhadap sisa kredit Anda sebelum ada pesan yang dibuat. Setiap item yang tidak kosong di phone ikut dihitung, termasuk item yang kemudian dilewati. Jika jumlahnya melebihi sisa kredit Anda, tidak ada pesan yang dibuat dan Anda mendapatkan:

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

Pesan yang sudah masuk antrean tetapi belum terkirim juga mengurangi sisa kredit Anda. Pecah daftar besar menjadi beberapa request yang lebih kecil atau isi ulang paket Anda. Untuk kampanye besar, unggah spreadsheet dari halaman Campaigns (Kampanye).

Respons#

Request yang berhasil mengembalikan 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
}

Bandingkan messages dengan daftar yang Anda kirim untuk menemukan nomor yang dilewati, dan pastikan is_group bernilai false untuk setiap item yang Anda maksudkan sebagai nomor telepon.

Error#

Sebagian besar error mengembalikan HTTP 200 dengan status bernilai 0, jadi selalu periksa status di body. Kecuali error HTTP 400 dan 403, respons (termasuk yang berhasil) berupa JSON yang dikirim dengan Content-Type: text/html, jadi parse body sendiri, jangan mengandalkan deteksi JSON otomatis (misalnya di alat tanpa kode):

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

Tips#

• Kirim phone sebagai string: gabungkan daftar Anda dengan koma. Array JSON mengembalikan {}.
• Jangan gunakan send_bulk_messages dari klien Python untuk saat ini: method ini mengirim daftar sebagai phones, yang diabaikan oleh endpoint ini. Panggil endpoint secara langsung seperti pada contoh di atas.
• Pantau setiap pesan: simpan setiap msg_id dari messages, atau kirim webhook agar Anda diberi tahu saat setiap pesan terkirim atau gagal.
• Jaga nomor Anda tetap terhubung: setiap pesan dikirim dari nomor WhatsApp Anda, jadi nomor tersebut harus tetap terhubung di WhatsApp settings sampai seluruh batch terkirim.
• Teks berbeda untuk setiap orang: endpoint ini mengirim msg yang sama ke semua orang. Panggil Kirim pesan sekali per penerima untuk mempersonalisasi setiap pesan.