API Pesan
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.
https://wbiztool.com/api/v1/send_msg/multi/Body: JSON atau field formulir
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#
Autentikasi
AuthorizationheaderDisarankanBearer YOUR_API_KEY: kunci API Anda dari Pengaturan → Kunci API. Dengan header ini,client_iddanapi_keyboleh tidak dikirim di body; jika keduanya dikirim, kunci valid di header yang dipakai. Lihat Mengirim kunci di header.client_idintegerTanpa header AuthorizationAPI Client ID Anda dari Pengaturan → Kunci API. Opsional jika memakai header; jika Anda mengirimnya, nilainya harus Client ID workspace kunci tersebut.
api_keystringTanpa header AuthorizationKunci API Anda dari halaman yang sama, jika Anda tidak mengirimnya di header.
whatsapp_clientintegerwajibID nomor WhatsApp atau akun Telegram yang digunakan untuk mengirim, dari WhatsApp settings (pengaturan WhatsApp). Berbeda dengan Kirim pesan, endpoint ini tidak pernah memilihkan nomor untuk Anda.
Penerima dan pesan
phonestringwajibNomor telepon dan nama grup dalam satu string yang dipisahkan koma, misalnya
9876543210,9812345670,Sales Team Mumbai. Jangan kirim array JSON. Lihat Cara penerima dibaca.country_codestringopsionalKode panggilan negara tanpa
+, misalnya91. Kode ini ditambahkan di depan setiap nomor telepon kecuali nomornya sudah diawali kode tersebut atau ditulis dengan+atau00. Di JSON, string ("91") maupun angka (91) sama-sama bisa dipakai.msg_typeintegeropsional0teks (default),1gambar,2file atau dokumen.msgstringWajib jika msg_type bernilai 0Teks pesan. Untuk gambar dan file, ini adalah keterangan (caption) dan boleh kosong. Format WhatsApp berfungsi:
*bold*,_italic_,~strikethrough~.messagediterima sebagai alias.
Gambar dan file
img_urlstringWajib jika msg_type bernilai 1URL
httpatauhttpspublik dari gambar.file_urlstringWajib jika msg_type bernilai 2URL
httpatauhttpspublik tempat file dapat diunduh secara langsung.file_namestringopsionalNama file yang dilihat penerima, misalnya
price-list.pdf. Nama dikirim dalam huruf kecil, karakter seperti& : ? * $ ;diganti dengan_, dan dipotong menjadi 150 karakter. Jika tidak dikirim, nama diambil dari URL.
Opsi pengiriman
webhookstringopsionalURL yang menerima
POSTuntuk setiap pesan ketika terkirim, gagal, dibatalkan, atau kedaluwarsa. Payload-nya sama seperti pada Kirim pesan.idempotency_keystringopsionalOpsional, maksimal 255 karakter. Selama 24 jam, jika Anda mencoba lagi dengan nilai yang sama, Anda menerima respons pertama, bukan pesan kedua. Anda juga dapat mengirimnya sebagai header
Idempotency-Key. Lihat Mencoba lagi dengan aman.
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:
- Nomor telepon dapat ditulis apa adanya:
+91 98765 43210,98765-43210,(987) 654-3210,0091 98765 43210, dan+44 (0)20 7946 0018semuanya bisa dipakai, begitu pula nilai spreadsheet seperti919876543210.0dan9.19876543210E+11. country_codeditambahkan kecuali nomornya sudah diawali kode tersebut atau ditulis dengan+atau00:+44 20 7946 0018dengancountry_code91tetap menjadi442079460018. Jadi satu daftar boleh berisi nomor dari beberapa negara: tulis nomor dari negara lain dengan+.- Nomor lokal yang ditulis dengan awalan
0juga bisa:09876543210dengancountry_code91dikirim ke919876543210, dan0612345678dengan39(Italia, tempat0merupakan bagian dari nomor) dikirim ke390612345678. - Setelah kode negara ditambahkan, nomor harus sepanjang 7 hingga 15 digit.
- Teks yang berisi huruf atau simbol lain, seperti
Sales Team MumbaiatauFamily 2024, diperlakukan sebagai nama grup WhatsApp, yang dicari dengan cara yang sama seperti di Kirim ke grup. - Nama grup tanpa huruf, seperti
2024-2025, dibaca sebagai nomor telepon, kecuali jika digitnya kurang dari 10 dan workspace Anda sudah pernah mengirim pesan ke grup dengan nama yang persis sama (grup itu tercantum di bawah Grup di Kontak). Nama pendek dengan kurang dari 7 digit dan tanda hubung, titik, atau tanda kurung, seperti2024-25atau(2024), selalu dibaca sebagai nama grup. Nama grup yang mengandung koma tidak bisa dikirimi dari endpoint ini. Gunakan Kirim ke grup untuk grup tersebut. - Dari akun Telegram,
@username, tautant.me/username, atautg:<id>adalah seseorang, bukan nama grup, dan nomor telepon dikirimi pesan di Telegram. Dari nomor WhatsApp, username, tautant.me, dantg:<id>dilewati.
Hal lain yang perlu diketahui:
- Nomor yang terlalu pendek atau terlalu panjang setelah kode negara ditambahkan, nilai spreadsheet yang dibulatkan, dan item yang hanya berisi nol (
0,00) dilewati tanpa pemberitahuan. Nomor tersebut tidak muncul di respons dan tidak mendapatmsg_id. - Duplikat tidak dihapus. Nomor yang dicantumkan dua kali menerima dua pesan.
- Jika sebuah nomor lokal kebetulan diawali angka yang sama dengan
country_code(misalnya9123456780dengancountry_code91), 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 dapat dikirim sebagai gambar (
msg_type1), dan file (msg_type2) tanpa ekstensi atau dengan ekstensi yang tidak didukung ditambahi.pdf. Lihat Mengirim gambar dan file.
Batas pesan#
Seluruh batch diperiksa sebelum ada pesan yang dibuat, sehingga daftar tidak pernah terkirim sebagian. Setiap item yang tidak kosong di phone ikut dihitung, termasuk item yang kemudian dilewati, dan pesan yang sudah masuk antrean tetapi belum terkirim juga dihitung.
- Semua paket: batch harus muat dalam batas harian penggunaan wajar nomor pengirim – 1.000 pesan dalam 24 jam mana pun. Jika tidak, tidak ada pesan yang dibuat dan Anda mendapatkan:
{
"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
}
- Paket gratis: batch juga harus muat dalam sisa pesan gratis workspace (50 dalam 30 hari mana pun). Jika tidak, Anda mendapatkan:
{
"message": "Not enough credits: 120 messages requested, 35 credits remaining",
"status": 0
}
Bagi daftar besar ke beberapa nomor atau hari. 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
}
| Field | Tipe | Deskripsi |
|---|---|---|
status | integer | 1 jika setidaknya satu pesan masuk antrean, selain itu 0. |
message | string | Successfully created N messages jika berhasil, selain itu berisi error. |
msg_ids | array integer | ID pesan dalam antrean, sesuai urutan phone. Hanya ada jika berhasil. |
messages | array | Satu objek per pesan dalam antrean. Hanya ada jika berhasil. |
messages[].msg_id | integer | ID pesan. |
messages[].contact | string | Nomor telepon dengan kode negara yang sudah diterapkan, atau nama grup. |
messages[].is_group | boolean | true jika item diperlakukan sebagai nama grup. |
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 }
| Pesan | Cara memperbaikinya |
|---|---|
Auth Error | Kirim client_id dan api_key. |
Invalid Client Id | Kirim client_id sebagai angka. Dikembalikan dengan HTTP 403. |
Auth Error: invalid api key | Pastikan kunci tersebut ada, belum dihapus, dan milik client_id ini. Dikembalikan dengan HTTP 400. |
Msg cant be null | Pesan teks (msg_type 0) memerlukan msg. |
Image Url Can't be null | Untuk msg_type 1, kirim img_url. |
File Url Can't be null | Untuk msg_type 2, kirim file_url. |
Not enough credits: … messages requested, … credits remaining | Pesan paket gratis tidak cukup untuk daftar ini. Kirim ke lebih sedikit penerima atau pilih paket. Lihat Batas pesan. |
Daily limit reached: … messages requested, … more can go out from this number in the next 24 hours. | Bagi daftar ke beberapa hari atau nomor. Lihat Batas pesan. |
Invalid whatsapp client | ID whatsapp_client tersebut tidak ada di workspace Anda. |
No valid contacts found | Setiap item di phone kosong atau dilewati. Pastikan nomornya 7 hingga 15 digit termasuk kode negara. |
Demo Account can not access apis | Gunakan akun biasa. |
Invalid JSON format: … | Body JSON tidak valid, atau Anda mengirim field formulir tanpa client_id. |
Tips#
- Kirim
phonesebagai string: gabungkan daftar Anda dengan koma. Array JSON mengembalikan{}. - Jangan gunakan
send_bulk_messagesdari klien Python untuk saat ini: method ini mengirim daftar sebagaiphones, yang diabaikan oleh endpoint ini. Panggil endpoint secara langsung seperti pada contoh di atas. - Pantau setiap pesan: simpan setiap
msg_iddarimessages, atau kirimwebhookagar Anda diberi tahu saat setiap pesan terkirim, gagal, dibatalkan, atau kedaluwarsa. - 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
msgyang sama ke semua orang. Panggil Kirim pesan sekali per penerima untuk mempersonalisasi setiap pesan.

