Langkau ke kandungan
WbizTool

API mesej

API Jadualkan Mesej WhatsApp

Jadualkan teks, imej atau dokumen WhatsApp untuk dihantar ke nombor telefon atau kumpulan pada tarikh dan masa pilihan anda. Gunakannya untuk peringatan temu janji, ucapan hari jadi, susulan dan tawaran yang terhad masa.

POSThttps://wbiztool.com/api/v1/schedule_msg/

Body: JSON atau medan borang

Mesej menunggu dalam baris gilir anda sehingga masa yang dijadualkan, kemudian dihantar dari nombor WhatsApp anda. Respons memberikan msg_id yang boleh anda gunakan untuk menyemak statusnya atau membatalkannya.

Contoh ringkas#

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

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

Parameter permintaan#

Pengesahan identiti

AuthorizationheaderDisyorkan

Bearer YOUR_API_KEY: kunci API anda dari Tetapan → Kunci API. Dengan pengepala ini, client_id dan api_key boleh ditinggalkan daripada badan; jika kedua-duanya dihantar, kunci sah dalam pengepala yang digunakan. Lihat Hantar kunci dalam pengepala.

client_idintegerTanpa pengepala Authorization

API Client ID anda dari Tetapan → Kunci API. Pilihan dengan pengepala; jika anda menghantarnya, ia mestilah Client ID ruang kerja kunci itu.

api_keystringTanpa pengepala Authorization

Kunci API anda dari halaman yang sama, apabila anda tidak menghantarnya dalam pengepala.

whatsapp_clientintegerwajib

ID nombor WhatsApp atau akaun Telegram yang digunakan untuk menghantar, dari tetapan WhatsApp. Tidak seperti Hantar mesej, endpoint ini tidak pernah memilih nombor untuk anda.

Jadual

datestringwajib

Hari untuk menghantar mesej, dalam format dd/mm/yyyy, contohnya 24/12/2026.

timestringwajib

Masa untuk menghantar mesej, dalam format 24 jam HH:MM, contohnya 09:00 atau 18:45. Jangan sertakan saat.

timezonestringpilihan

Zon waktu bagi date dan time. Lalai kepada IST (India) jika anda tidak menyertakannya. Lihat Zon waktu.

Penerima dan mesej

phonestringWajib kecuali anda menghantar group_name

Nombor WhatsApp penerima. Ruang, +, -, ., kurungan dan 00 di hadapan dibuang secara automatik, jadi +91 98765-43210 boleh digunakan. Nilai hamparan seperti 919876543210.0 dan 9.19876543210E+11 dibaca sebagai digitnya, tetapi nilai yang dibundarkan seperti 9.19877E+11 ditolak, kerana ada digit yang hilang. Hantar nombor sama ada dengan kod negaranya (919876543210) atau tanpa kod negara (9876543210) bersama country_code. Nombor tempatan yang ditulis dengan 0 di hadapan juga boleh digunakan: 09876543210 dengan country_code 91 dihantar ke 919876543210, dan 0612345678 dengan 39 (Itali, di mana 0 ialah sebahagian daripada nombor) dihantar ke 390612345678. Nombor yang ditulis dengan + atau 00 sudah membawa kod negaranya: country_code tidak ditambah kepadanya, dan (0) dalam kurungan selepas kod negara dibuang, jadi +44 (0)20 7946 0018 dihantar ke 442079460018. Daripada akaun Telegram, phone juga boleh berupa @username, pautan t.me/username atau tg:<id>.

group_namestringWajib kecuali anda menghantar phone

Nama kumpulan WhatsApp yang disertai oleh nombor anda. Kumpulan dicari dengan cara yang sama seperti dalam Hantar ke kumpulan. Hantar phone atau group_name, jangan kedua-duanya.

country_codestringpilihan

Kod panggilan negara tanpa +, contohnya 91 untuk India atau 1 untuk Amerika Syarikat. Kod ini ditambah di hadapan phone kecuali nombor itu sudah bermula dengannya atau ditulis dengan + atau 00. Pengecualian: dengan 91, nombor 10 digit sentiasa diberi awalan. Dengan kod lain, hantar nombor tempatan yang bermula dengan digit yang sama bersama kod negaranya. Diabaikan untuk kumpulan.

msg_typeintegerpilihan

0 teks (lalai), 1 imej, 2 fail atau dokumen.

msgstringWajib apabila msg_type ialah 0

Teks mesej. Untuk imej dan fail, ini ialah kapsyen dan boleh dibiarkan kosong. Format WhatsApp boleh digunakan: *bold*, _italic_, ~strikethrough~. message diterima sebagai alias.

Imej dan fail

img_urlstringWajib apabila msg_type ialah 1

URL http atau https awam bagi imej.

file_urlstringWajib apabila msg_type ialah 2

URL http atau https awam tempat fail boleh dimuat turun secara terus.

file_namestringpilihan

Nama fail yang dilihat oleh penerima, seperti invoice-4821.pdf. Nama dihantar dalam huruf kecil, aksara seperti & : ? * $ ; digantikan dengan _, dan nama dipotong kepada 150 aksara. Jika anda tidak menyertakannya, nama diambil daripada URL.

Pilihan penghantaran

webhookstringpilihan

URL yang menerima POST apabila mesej dihantar, gagal, dibatalkan atau tamat tempoh. Muatannya sama seperti untuk Hantar mesej.

idempotency_keystringpilihan

Pilihan, sehingga 255 aksara. Selama 24 jam, jika anda mencuba semula dengan nilai yang sama, anda menerima respons pertama, bukan mesej kedua. Anda juga boleh menghantarnya sebagai pengepala Idempotency-Key. Lihat Mencuba semula dengan selamat.

Bila mesej dihantar#

  • WbizTool menukar date, time dan timezone kepada satu detik masa dan menghantar mesej sebaik sahaja detik itu berlalu, selagi nombor WhatsApp anda disambungkan.
  • Masa yang telah berlalu diterima. Mesej dihantar serta-merta, seperti penghantaran biasa. Semak semula format tarikh (dd/mm/yyyy, hari dahulu) supaya anda tidak menghantar mesej beberapa bulan lebih awal.
  • Jika nombor anda terputus sambungan pada masa yang dijadualkan, mesej akan menunggu dan dihantar sebaik sahaja nombor itu disambungkan semula, walaupun jauh lebih lewat daripada yang dirancang. Endpoint ini tiada tamat tempoh, jadi batalkan mesej jika ia tidak lagi relevan. Mesej yang masih menunggu pada nombor yang terputus sambungan atau dipadam 90 hari selepas masa yang dijadualkan akan dipadam.
  • Sehingga ia dihantar, mesej mempunyai status 0 (Created) dan boleh dibatalkan. Ia dikira dalam had harian nombor itu pada hari anda menjadualkannya (dan dalam mesej pelan percuma).

Zon waktu#

timezone menerima sama ada nama zon waktu atau salah satu singkatan di bawah.

Nama zon waktu seperti Asia/Kolkata, America/New_York, Europe/London atau Australia/Sydney. Mana-mana nama daripada pangkalan data zon waktu IANA boleh digunakan. Ini pilihan yang paling boleh dipercayai. Lihat Rujukan zon waktu untuk senarainya.

Singkatan boleh ditulis dalam huruf besar atau huruf kecil (IST atau ist). Setiap satu dipetakan kepada satu rantau, dan waktu jimat siang rantau itu digunakan secara automatik:

SingkatanDianggap sebagai
ISTAsia/Kolkata
UTCUTC
GMTGMT
ESTUS/Eastern
CSTUS/Central
MSTUS/Mountain
PSTUS/Pacific
CET, CESTEurope/Paris
EET, EESTEurope/Athens
JSTAsia/Tokyo
AEST, AEDTAustralia/Sydney

Contohnya, EST pada bulan Julai bermaksud waktu musim panas New York (UTC−4), bukan UTC−5 yang tetap.

Menjadualkan untuk kumpulan#

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

Respons#

Permintaan yang berjaya memulangkan HTTP 200:

{
  "msg_id": 9817263,
  "message": "Created",
  "status": 1
}
MedanJenisPenerangan
statusinteger1 jika mesej telah dijadualkan, 0 jika permintaan gagal.
messagestringCreated jika berjaya, jika tidak, mesej ralat.
msg_idintegerID mesej yang dijadualkan. Simpan untuk menyemak status atau membatalkannya kemudian. Hanya ada jika berjaya.

Respons tidak mengulangi masa atau zon waktu yang dijadualkan, jadi rekodkan apa yang anda hantar.

Ralat#

Kebanyakan ralat memulangkan HTTP 200 dengan status ditetapkan kepada 0, jadi sentiasa semak status dalam badan respons:

{ "message": "Scheduled date & time is not in valid format", "status": 0 }
MesejCara membetulkannya
Auth ErrorHantar kedua-dua client_id dan api_key.
Invalid Client IdHantar client_id sebagai nombor. Dipulangkan dengan HTTP 403.
Auth Error: invalid api keyPastikan kunci wujud, belum dipadam dan milik client_id ini. Dipulangkan dengan HTTP 400.
Either phone or group_name parameter is requiredTambah phone atau group_name.
Please provide either phone OR group_name, not bothBuang salah satu daripadanya.
Invalid phone numberphone mesti nombor dengan 6–17 digit. Huruf dan simbol lain tidak dibenarkan, begitu juga nilai hamparan yang dibundarkan seperti 9.19877E+11.
Invalid Contact Number "…"Selepas kod negara ditambah, nombor mesti sepanjang 7–15 digit.
Msg cant be nullMesej teks (msg_type 0) memerlukan msg.
Image Url Can't be nullUntuk msg_type 1, hantar img_url.
File Url Can't be nullUntuk msg_type 2, hantar file_url.
Scheduled date & time is not in valid formatdate atau time tiada, atau timezone ialah rentetan 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 (contohnya 2026-12-24 atau 09:00:00) atau bukan tarikh sebenar (31/02/2026).
Unknown timezone "…": …timezone bukan nama zon waktu atau salah satu singkatan di atas. Ofset seperti GMT+5:30 tidak diterima.
Invalid msg_type: use 0 (text), 1 (image) or 2 (file)Hantar msg_type sebagai 0, 1 atau 2.
Invalid whatsapp client …whatsapp_client tiada atau bukan salah satu nombor anda. Gunakan ID yang dipaparkan untuk nombor yang disambungkan pada papan pemuka anda.
Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client@username, pautan t.me atau tg:<id> dalam phone memerlukan akaun Telegram sebagai whatsapp_client.
Server error: the message was not scheduled. Please try again.Berlaku masalah di pihak kami. Dipulangkan dengan HTTP 500; tiada apa-apa yang dijadualkan, jadi cuba lagi.
Not enough creditsRuang kerja menggunakan pelan percuma dan tiada baki mesej: pelan berbayar menghantar mesej tanpa had. Lihat Apabila mesej 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")Nombor ini telah menerima 1,000 mesej dalam 24 jam yang lalu (penggunaan berpatutan). Respons masih mengandungi msg_id mesej yang ditolak, yang dipaparkan sebagai gagal. Hantar bakinya kemudian atau daripada nombor lain.
Demo Account can not access apisGunakan akaun biasa.
Invalid JSON format: …Badan JSON tidak sah, atau anda menghantar medan borang tanpa client_id.

Petua#

  • Bina tarikh dengan teliti: dalam Python gunakan strftime("%d/%m/%Y") dan strftime("%H:%M"). Dalam JavaScript, format tarikh dan masa dalam zon waktu yang sama yang anda hantar dalam timezone, bukan waktu tempatan pelayan 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"
  • Sahkan masanya: jadualkan mesej ujian lima minit ke hadapan dan pastikan ia tiba pada masa yang anda jangkakan.

  • Perubahan rancangan: untuk menjadualkan semula, batalkan mesej dan jadualkan mesej baharu.

  • Jangan gunakan klien rasmi untuk menjadualkan buat masa ini: schedule_message Python menghantar tarikh sebagai YYYY-MM-DD (ditolak kerana bukan dalam format yang sah), dan scheduleMessage Node menghantar schedule_time, yang tidak dibaca oleh endpoint ini. Panggil endpoint secara terus seperti yang ditunjukkan di atas.

  • Mesej berulang: untuk mesej yang berulang, seperti peringatan bayaran bulanan, lihat Cipta peringatan.