Langsung ke konten
WbizTool

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.

POSThttps://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!"
  }'

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

Parameter request#

Autentikasi

AuthorizationheaderDisarankan

Bearer YOUR_API_KEY: kunci API Anda dari Pengaturan → Kunci API. Dengan header ini, client_id dan api_key boleh tidak dikirim di body; jika keduanya dikirim, kunci valid di header yang dipakai. Lihat Mengirim kunci di header.

client_idintegerTanpa header Authorization

API Client ID Anda dari Pengaturan → Kunci API. Opsional jika memakai header; jika Anda mengirimnya, nilainya harus Client ID workspace kunci tersebut.

api_keystringTanpa header Authorization

Kunci API Anda dari halaman yang sama, jika Anda tidak mengirimnya di header.

whatsapp_clientintegerwajib

ID 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

phonestringwajib

Nomor 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_codestringopsional

Kode panggilan negara tanpa +, misalnya 91. Kode ini ditambahkan di depan setiap nomor telepon kecuali nomornya sudah diawali kode tersebut atau ditulis dengan + atau 00. Di JSON, string ("91") maupun angka (91) sama-sama bisa dipakai.

msg_typeintegeropsional

0 teks (default), 1 gambar, 2 file atau dokumen.

msgstringWajib jika msg_type bernilai 0

Teks pesan. Untuk gambar dan file, ini adalah keterangan (caption) dan boleh kosong. Format WhatsApp berfungsi: *bold*, _italic_, ~strikethrough~. message diterima sebagai alias.

Gambar dan file

img_urlstringWajib jika msg_type bernilai 1

URL http atau https publik dari gambar.

file_urlstringWajib jika msg_type bernilai 2

URL http atau https publik tempat file dapat diunduh secara langsung.

file_namestringopsional

Nama 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

webhookstringopsional

URL yang menerima POST untuk setiap pesan ketika terkirim, gagal, dibatalkan, atau kedaluwarsa. Payload-nya sama seperti pada Kirim pesan.

idempotency_keystringopsional

Opsional, 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.

Gambar dari URLcURL
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 0018 semuanya bisa dipakai, begitu pula nilai spreadsheet seperti 919876543210.0 dan 9.19876543210E+11.
  • country_code ditambahkan kecuali nomornya sudah diawali kode tersebut atau ditulis dengan + atau 00: +44 20 7946 0018 dengan country_code 91 tetap menjadi 442079460018. Jadi satu daftar boleh berisi nomor dari beberapa negara: tulis nomor dari negara lain dengan +.
  • Nomor lokal yang ditulis dengan awalan 0 juga bisa: 09876543210 dengan country_code 91 dikirim ke 919876543210, dan 0612345678 dengan 39 (Italia, tempat 0 merupakan bagian dari nomor) dikirim ke 390612345678.
  • Setelah kode negara ditambahkan, nomor harus sepanjang 7 hingga 15 digit.
  • Teks yang berisi huruf atau simbol lain, seperti Sales Team Mumbai atau Family 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, seperti 2024-25 atau (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, tautan t.me/username, atau tg:<id> adalah seseorang, bukan nama grup, dan nomor telepon dikirimi pesan di Telegram. Dari nomor WhatsApp, username, tautan t.me, dan tg:<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 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 dapat dikirim sebagai gambar (msg_type 1), dan file (msg_type 2) 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
}
FieldTipeDeskripsi
statusinteger1 jika setidaknya satu pesan masuk antrean, selain itu 0.
messagestringSuccessfully created N messages jika berhasil, selain itu berisi error.
msg_idsarray integerID pesan dalam antrean, sesuai urutan phone. Hanya ada jika berhasil.
messagesarraySatu objek per pesan dalam antrean. Hanya ada jika berhasil.
messages[].msg_idintegerID pesan.
messages[].contactstringNomor telepon dengan kode negara yang sudah diterapkan, atau nama grup.
messages[].is_groupbooleantrue 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 }
PesanCara memperbaikinya
Auth ErrorKirim client_id dan api_key.
Invalid Client IdKirim client_id sebagai angka. Dikembalikan dengan HTTP 403.
Auth Error: invalid api keyPastikan kunci tersebut ada, belum dihapus, dan milik client_id ini. Dikembalikan dengan HTTP 400.
Msg cant be nullPesan teks (msg_type 0) memerlukan msg.
Image Url Can't be nullUntuk msg_type 1, kirim img_url.
File Url Can't be nullUntuk msg_type 2, kirim file_url.
Not enough credits: … messages requested, … credits remainingPesan 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 clientID whatsapp_client tersebut tidak ada di workspace Anda.
No valid contacts foundSetiap item di phone kosong atau dilewati. Pastikan nomornya 7 hingga 15 digit termasuk kode negara.
Demo Account can not access apisGunakan akun biasa.
Invalid JSON format: …Body JSON tidak valid, atau Anda mengirim field formulir tanpa client_id.

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, 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 msg yang sama ke semua orang. Panggil Kirim pesan sekali per penerima untuk mempersonalisasi setiap pesan.