API akaun WhatsApp
API Status Sambungan WhatsApp
Semak sama ada salah satu nombor WhatsApp anda disambungkan dan sedia untuk menghantar mesej. Gunakannya sebelum kempen, atau semasa menunggu nombor yang baru disambungkan selesai dipautkan. Gunakan endpoint ini dan bukannya /api/v1/whatsapp/status/<id>/, yang tidak berfungsi.
https://wbiztool.com/api/v1/whatsapp-client/status/Body: JSON atau medan borang
Contoh ringkas#
curl -X POST https://wbiztool.com/api/v1/whatsapp-client/status/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 678
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/whatsapp-client/status/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 678,
},
timeout=30,
)
result = response.json() # read the body even when the HTTP code is 400 or 403
if result["status"] == 1:
print("Connected")
elif result["message"] == "Disconnected":
print("Not connected. Reconnect it in WhatsApp settings.")
else:
print("Failed:", result["message"])// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/whatsapp-client/status/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_id: 12345,
api_key: "YOUR_API_KEY",
whatsapp_client: 678,
}),
});
const result = await response.json(); // read the body even when the HTTP code is 400 or 403
if (result.status === 1) {
console.log("Connected");
} else if (result.message === "Disconnected") {
console.log("Not connected. Reconnect it in WhatsApp settings.");
} else {
console.error("Failed:", result.message);
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
'whatsapp_client' => 678,
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp-client/status/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if (($result['status'] ?? 0) === 1) {
echo 'Connected';
} elseif (($result['message'] ?? '') === 'Disconnected') {
echo 'Not connected. Reconnect it in WhatsApp settings.';
} else {
echo 'Failed: ' . ($result['message'] ?? 'no 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#
client_idintegerwajibAPI Client ID anda dari Settings → API keys (Tetapan → Kunci API).
api_keystringwajibKunci API anda dari halaman yang sama.
whatsapp_clientintegerwajibID nombor WhatsApp yang hendak disemak, dari tetapan WhatsApp, Senarai akaun atau
whatsapp_client_idyang dipulangkan oleh Sambung nombor.
Menggunakan klien rasmi#
Klien Python memanggil endpoint ini untuk anda.
from wbiztool_client import WbizToolClient
client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)
result = client.get_whatsapp_client_status(678)
print(result)Klien Python menimbulkan requests.exceptions.HTTPError apabila API memulangkan HTTP 400 atau 403, jadi balut panggilan dalam try/except.
getWhatsAppClientStatus() klien Node.js memanggil alamat yang tidak wujud dan gagal dengan 404. Gunakan fetch seperti dalam Contoh ringkas.
Respons#
Permintaan memulangkan HTTP 200 dengan salah satu badan berikut apabila kelayakan anda sah.
Nombor disambungkan:
{ "message": "Connected", "status": 1 }
Nombor tidak disambungkan:
{ "message": "Disconnected", "status": 0 }
| Medan | Jenis | Penerangan |
|---|---|---|
status | integer | 1 jika nombor disambungkan. 0 jika ia tidak disambungkan atau permintaan gagal. |
message | string | Connected, Disconnected, atau mesej ralat. |
Nombor yang telah anda padam dari tetapan WhatsApp juga memulangkan Disconnected.
Ralat#
| Mesej | HTTP | Cara membetulkannya |
|---|---|---|
Auth Error | 200 | Hantar client_id, api_key dan whatsapp_client berangka dalam badan POST, sebagai JSON atau medan borang yang sah. |
Invalid Client Id | 403 | Hantar client_id sebagai nombor bulat, seperti 12345. |
Auth Error: invalid api key | 400 | Pastikan kunci wujud, belum dipadam dan milik client_id ini. |
Auth Error 2 | 200 | ID whatsapp_client itu tiada dalam ruang kerja kunci API ini. |
Demo Account can not access apis | 200 | Gunakan akaun biasa. |
Petua#
- Sebelum menghantar: jika nombor yang digunakan untuk menghantar terputus sambungan, mesejnya menunggu dalam baris gilir sehingga nombor itu disambungkan semula atau mesej tamat tempoh, jadi semak status sebelum penghantaran besar. Mesej yang belum dihantar pada nombor yang terputus sambungan akan dibuang selepas 90 hari.
- Selepas menyambung nombor: tinjau endpoint ini setiap beberapa saat sehingga ia memulangkan
Connected. Webhookconnectedboleh tiba beberapa saat sebelum endpoint ini memulangkanConnected, jadi teruskan meninjau sehingga satu minit selepas peristiwa itu. Lihat Sambung nombor. - Semua nombor sekali gus: untuk mendapatkan status setiap nombor dalam satu panggilan, gunakan Senarai akaun.
