API Pesan
API Jadwalkan Pesan WhatsApp
Jadwalkan teks, gambar, atau dokumen WhatsApp untuk dikirim ke nomor telepon atau grup pada tanggal dan jam pilihan Anda. Gunakan untuk pengingat janji temu, ucapan ulang tahun, tindak lanjut, dan penawaran berbatas waktu.
https://wbiztool.com/api/v1/schedule_msg/Body: JSON atau field formulir
Pesan menunggu di antrean Anda sampai waktu yang dijadwalkan, lalu dikirim dari nomor WhatsApp Anda. Respons memberi Anda msg_id yang dapat digunakan untuk memeriksa statusnya atau membatalkannya.
Contoh singkat#
curl -X POST https://wbiztool.com/api/v1/schedule_msg/ \
-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",
"msg": "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
"date": "24/12/2026",
"time": "09:00",
"timezone": "Asia/Kolkata"
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/schedule_msg/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 678,
"msg_type": 0,
"country_code": "91",
"phone": "9876543210",
"msg": "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
"date": "24/12/2026",
"time": "09:00",
"timezone": "Asia/Kolkata",
},
timeout=60,
)
result = response.json() # read the body even when the HTTP code is 400
if result.get("status") == 1:
print("Scheduled with msg_id", result["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/schedule_msg/", {
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",
msg: "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
date: "24/12/2026",
time: "09:00",
timezone: "Asia/Kolkata",
}),
});
const result = await response.json(); // read the body even when the HTTP code is 400
if (result.status === 1) {
console.log("Scheduled with msg_id", result.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' => '9876543210',
'msg' => 'Hi Aman, a reminder that your appointment is today at 11:30 AM.',
'date' => '24/12/2026',
'time' => '09:00',
'timezone' => 'Asia/Kolkata',
];
$ch = curl_init('https://wbiztool.com/api/v1/schedule_msg/');
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) {
echo 'Scheduled with msg_id ' . $result['msg_id'];
} 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.
Jadwal
datestringwajibTanggal pengiriman pesan, dalam format
dd/mm/yyyy, misalnya24/12/2026.timestringwajibJam pengiriman pesan, dalam format 24 jam
HH:MM, misalnya09:00atau18:45. Jangan sertakan detik.timezonestringopsionalZona waktu yang digunakan untuk
datedantime. Default-nyaIST(India) jika tidak dikirim. Lihat Zona waktu.
Penerima dan pesan
phonestringWajib kecuali Anda mengirim group_nameNomor WhatsApp penerima. Spasi,
+,-,., tanda kurung, dan awalan00otomatis dihapus, jadi+91 98765-43210bisa dipakai. Nilai spreadsheet seperti919876543210.0dan9.19876543210E+11dibaca sebagai digitnya, tetapi nilai yang dibulatkan seperti9.19877E+11ditolak, karena ada digit yang hilang. Kirim nomor dengan kode negaranya (919876543210) atau tanpa kode negara (9876543210) bersamacountry_code. Nomor lokal yang ditulis dengan awalan0juga bisa:09876543210dengancountry_code91dikirim ke919876543210, dan0612345678dengan39(Italia, tempat0merupakan bagian dari nomor) dikirim ke390612345678. Nomor yang ditulis dengan+atau00sudah membawa kode negaranya:country_codetidak ditambahkan ke nomor itu, dan(0)dalam tanda kurung setelah kode negara dibuang, jadi+44 (0)20 7946 0018dikirim ke442079460018. Dari akun Telegram,phonejuga dapat berupa@username, tautant.me/username, atautg:<id>.group_namestringWajib kecuali Anda mengirim phoneNama grup WhatsApp yang beranggotakan nomor Anda. Grup dicari dengan cara yang sama seperti di Kirim ke grup. Kirim
phoneataugroup_name, jangan keduanya.country_codestringopsionalKode panggilan negara tanpa
+, misalnya91untuk India atau1untuk Amerika Serikat. Kode ini ditambahkan di depanphonekecuali nomornya sudah diawali kode tersebut atau ditulis dengan+atau00. Pengecualian: dengan91, nomor 10 digit selalu mendapat awalan. Dengan kode lain, kirim nomor lokal yang diawali angka yang sama lengkap dengan kode negaranya. Diabaikan untuk grup.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
invoice-4821.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
POSTketika pesan 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.
Kapan pesan dikirim#
- WbizTool mengonversi
date,time, dantimezonemenjadi satu titik waktu dan mengirim pesan setelah waktu tersebut terlewati, selama nomor WhatsApp Anda terhubung. - Waktu yang sudah lewat tetap diterima. Pesan langsung dikirim, seperti pengiriman biasa. Periksa kembali format tanggal (
dd/mm/yyyy, tanggal lebih dulu) agar Anda tidak mengirim pesan berbulan-bulan lebih awal. - Jika nomor Anda terputus pada waktu yang dijadwalkan, pesan menunggu dan dikirim segera setelah nomor terhubung kembali, meskipun jauh lebih lambat dari rencana. Endpoint ini tidak memiliki masa kedaluwarsa, jadi batalkan pesan jika sudah tidak relevan. Pesan yang masih menunggu pada nomor yang terputus atau dihapus 90 hari setelah waktu jadwalnya akan dihapus.
- Sampai terkirim, pesan berstatus
0(Created) dan dapat dibatalkan. Pesan ini dihitung dalam batas harian nomor tersebut pada hari Anda menjadwalkannya (dan dalam pesan paket gratis).
Zona waktu#
timezone menerima nama zona waktu atau salah satu singkatan di bawah ini.
Nama zona waktu seperti Asia/Kolkata, America/New_York, Europe/London, atau Australia/Sydney. Nama apa pun dari database zona waktu IANA dapat digunakan. Ini adalah opsi yang paling andal. Lihat Referensi zona waktu untuk daftarnya.
Singkatan dapat ditulis dengan huruf kapital maupun huruf kecil (IST atau ist). Setiap singkatan dipetakan ke sebuah wilayah, dan waktu musim panas (daylight saving time) wilayah tersebut diterapkan secara otomatis:
| Singkatan | Diperlakukan sebagai |
|---|---|
IST | Asia/Kolkata |
UTC | UTC |
GMT | GMT |
EST | US/Eastern |
CST | US/Central |
MST | US/Mountain |
PST | US/Pacific |
CET, CEST | Europe/Paris |
EET, EEST | Europe/Athens |
JST | Asia/Tokyo |
AEST, AEDT | Australia/Sydney |
Misalnya, EST di bulan Juli berarti waktu musim panas New York (UTC−4), bukan UTC−5 yang tetap.
Menjadwalkan untuk grup#
curl -X POST https://wbiztool.com/api/v1/schedule_msg/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 678,
"msg_type": 0,
"group_name": "Sales Team Mumbai",
"msg": "Team meeting starts in 15 minutes.",
"date": "24/12/2026",
"time": "14:45",
"timezone": "Asia/Kolkata"
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/schedule_msg/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 678,
"msg_type": 0,
"group_name": "Sales Team Mumbai",
"msg": "Team meeting starts in 15 minutes.",
"date": "24/12/2026",
"time": "14:45",
"timezone": "Asia/Kolkata",
},
timeout=60,
)
print(response.json())// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/schedule_msg/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_id: 12345,
api_key: "YOUR_API_KEY",
whatsapp_client: 678,
msg_type: 0,
group_name: "Sales Team Mumbai",
msg: "Team meeting starts in 15 minutes.",
date: "24/12/2026",
time: "14:45",
timezone: "Asia/Kolkata",
}),
});
console.log(await response.json());<?php
$ch = curl_init('https://wbiztool.com/api/v1/schedule_msg/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
'whatsapp_client' => 678,
'msg_type' => 0,
'group_name' => 'Sales Team Mumbai',
'msg' => 'Team meeting starts in 15 minutes.',
'date' => '24/12/2026',
'time' => '14:45',
'timezone' => 'Asia/Kolkata',
]),
CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);
curl_close($ch);Respons#
Request yang berhasil mengembalikan HTTP 200:
{
"msg_id": 9817263,
"message": "Created",
"status": 1
}
| Field | Tipe | Deskripsi |
|---|---|---|
status | integer | 1 jika pesan berhasil dijadwalkan, 0 jika request gagal. |
message | string | Created jika berhasil, selain itu berisi error. |
msg_id | integer | ID pesan terjadwal. Simpan untuk memeriksa status atau membatalkannya nanti. Hanya ada jika berhasil. |
Respons tidak mengulang waktu jadwal atau zona waktu, jadi catat apa yang Anda kirim.
Error#
Sebagian besar error mengembalikan HTTP 200 dengan status bernilai 0, jadi selalu periksa status di body:
{ "message": "Scheduled date & time is not in valid format", "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. |
Either phone or group_name parameter is required | Tambahkan phone atau group_name. |
Please provide either phone OR group_name, not both | Hapus salah satunya. |
Invalid phone number | phone harus berupa nomor dengan 6–17 digit. Huruf dan simbol lain tidak diperbolehkan, begitu pula nilai spreadsheet yang dibulatkan seperti 9.19877E+11. |
Invalid Contact Number "…" | Setelah kode negara ditambahkan, nomor harus sepanjang 7–15 digit. |
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. |
Scheduled date & time is not in valid format | date atau time tidak dikirim, atau timezone berupa string kosong. |
Scheduled date & time is not in valid format: date DD/MM/YYYY and time HH:MM (24-hour) | date atau time dalam format lain (misalnya 2026-12-24 atau 09:00:00) atau bukan tanggal yang nyata (31/02/2026). |
Unknown timezone "…": … | timezone bukan nama zona waktu maupun salah satu singkatan di atas. Offset seperti GMT+5:30 tidak diterima. |
Invalid msg_type: use 0 (text), 1 (image) or 2 (file) | Kirim msg_type sebagai 0, 1, atau 2. |
Invalid whatsapp client … | whatsapp_client tidak dikirim atau bukan salah satu nomor Anda. Gunakan ID yang ditampilkan untuk nomor yang terhubung di dashboard Anda. |
Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client | @username, tautan t.me, atau tg:<id> di phone memerlukan akun Telegram sebagai whatsapp_client. |
Server error: the message was not scheduled. Please try again. | Ada yang gagal di sisi kami. Dikembalikan dengan HTTP 500; tidak ada yang dijadwalkan, jadi coba lagi. |
Not enough credits | Workspace memakai paket gratis dan pesannya sudah habis: paket berbayar mengirim pesan tanpa batas. Lihat Saat pesan Anda habis. |
Daily limit reached: a number can send 1,000 messages in 24 hours (fair use). Send the rest tomorrow. (HTTP 429, "code": "daily_limit_reached") | Nomor ini sudah menerima 1.000 pesan dalam 24 jam terakhir (penggunaan wajar). Respons tetap berisi msg_id pesan yang ditolak, yang tampil sebagai gagal. Kirim sisanya nanti atau dari nomor lain. |
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#
-
Susun tanggal dengan cermat: di Python gunakan
strftime("%d/%m/%Y")danstrftime("%H:%M"). Di JavaScript, format tanggal dan jam dalam zona waktu yang sama dengan yang Anda kirim ditimezone, bukan waktu lokal server Anda:const tz = "Asia/Kolkata"; // d is the Date to send at const date = new Intl.DateTimeFormat("en-GB", { timeZone: tz, day: "2-digit", month: "2-digit", year: "numeric" }).format(d); // "24/12/2026" const time = new Intl.DateTimeFormat("en-GB", { timeZone: tz, hour: "2-digit", minute: "2-digit", hourCycle: "h23" }).format(d); // "09:00" -
Pastikan waktunya benar: jadwalkan pesan uji lima menit ke depan dan periksa apakah pesan tiba sesuai harapan.
-
Perubahan rencana: untuk mengubah jadwal, batalkan pesan lalu jadwalkan pesan baru.
-
Jangan gunakan klien resmi untuk penjadwalan untuk saat ini:
schedule_messagedi Python mengirim tanggal sebagaiYYYY-MM-DD(ditolak karena format tidak valid), danscheduleMessagedi Node mengirimschedule_time, yang tidak dibaca oleh endpoint ini. Panggil endpoint secara langsung seperti contoh di atas. -
Pesan berulang: untuk pesan yang berulang, seperti pengingat pembayaran bulanan, lihat Buat pengingat.

