API Hantar ke Beberapa Nombor

Hantar mesej WhatsApp yang sama ke beberapa nombor telefon dan kumpulan dalam satu permintaan. Gunakannya untuk siaran kecil seperti surat berita, tawaran dan pengumuman.

Wbiztool mencipta satu mesej bagi setiap penerima dan memulangkan msg_id untuk setiap satu, supaya anda boleh menyemak statusnya secara berasingan.

Contoh ringkas#

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

Gantikan 12345, YOUR_API_KEY dan 678 dengan nilai anda sendiri. Lihat Pengesahan identiti untuk mengetahui di mana nilai ini boleh didapati.

Parameter permintaan#

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 memisahkan phone mengikut koma, membuang ruang di sekeliling setiap item, kemudian menentukan jenis setiap item:

• Digit sahaja (+ atau sifar di hadapan dibenarkan): dianggap sebagai nombor telefon. country_code ditambah kecuali nombor itu sudah bermula dengannya, kemudian nombor mesti sepanjang 6 hingga 15 digit.
• Selain itu: dianggap sebagai nama kumpulan WhatsApp, dicari dengan cara yang sama seperti dalam Hantar ke kumpulan.
• Kumpulan yang namanya hanya digit (contohnya 2024) dianggap sebagai nombor telefon, dan nama kumpulan yang mengandungi koma tidak boleh dihantar dari endpoint ini. Gunakan Hantar ke kumpulan untuk kumpulan sebegini.

Perkara lain yang perlu diketahui:

• Nombor yang terlalu pendek atau terlalu panjang selepas kod negara ditambah akan dilangkau tanpa pemberitahuan. Nombor ini tidak muncul dalam respons dan tidak mendapat msg_id.
• Pendua tidak dibuang. Nombor yang disenaraikan dua kali akan menerima dua mesej.
• Jika nombor tempatan kebetulan bermula dengan digit yang sama seperti country_code (contohnya 9123456780 dengan country_code 91), kod tidak ditambah. Hantar nombor sebegini dengan kod negara sudah disertakan (919123456780).
• URL imej dan fail tidak disemak semasa anda memanggil API. URL dimuat turun semasa setiap mesej dihantar, jadi pautan yang rosak menyebabkan mesej gagal kemudian, bukan permintaan. Peraturan semasa penghantaran yang sama seperti Hantar mesej terpakai: imej melebihi 16 MB dan video melebihi 64 MB akan gagal, audio WAV dan OGG tidak disokong, dan fail (msg_type 2) tanpa sambungan yang disokong akan ditambah .pdf. Lihat Menghantar imej dan fail.

Kredit#

Keseluruhan kelompok disemak berbanding baki kredit anda sebelum apa-apa dicipta. Setiap item yang tidak kosong dalam phone dikira, termasuk item yang kemudiannya dilangkau. Jika jumlahnya melebihi baki kredit anda, tiada mesej dicipta dan anda akan menerima:

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

Mesej yang berada dalam baris gilir tetapi belum dihantar juga dikira dalam baki kredit anda. Pecahkan senarai besar kepada permintaan yang lebih kecil atau tambah nilai pelan anda. Untuk kempen besar, muat naik hamparan dari halaman Campaigns (Kempen).

Respons#

Permintaan yang berjaya memulangkan 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 senarai yang anda hantar untuk mencari nombor yang dilangkau, dan pastikan is_group ialah false bagi setiap item yang anda maksudkan sebagai nombor telefon.

Ralat#

Kebanyakan ralat memulangkan HTTP 200 dengan status ditetapkan kepada 0, jadi sentiasa semak status dalam badan respons. Kecuali ralat HTTP 400 dan 403, respons (termasuk yang berjaya) ialah JSON yang dihantar dengan Content-Type: text/html, jadi huraikan badan respons sendiri dan jangan bergantung pada pengesanan JSON automatik (contohnya dalam alat tanpa kod):

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

Petua#

• Hantar phone sebagai rentetan: gabungkan senarai anda dengan koma. Tatasusunan JSON memulangkan {}.
• Jangan gunakan send_bulk_messages klien Python buat masa ini: ia menghantar senarai sebagai phones, yang diabaikan oleh endpoint ini. Panggil endpoint secara terus seperti dalam contoh di atas.
• Jejaki setiap mesej: simpan setiap msg_id daripada messages, atau hantar webhook untuk dimaklumkan apabila setiap mesej dihantar atau gagal.
• Pastikan nombor anda kekal disambungkan: setiap mesej dihantar dari nombor WhatsApp anda, jadi ia mesti kekal disambungkan di tetapan WhatsApp sehingga keseluruhan kelompok selesai dihantar.
• Teks berbeza bagi setiap orang: endpoint ini menghantar msg yang sama kepada semua orang. Panggil Hantar mesej sekali bagi setiap penerima untuk memperibadikan setiap mesej.