API Akun WhatsApp
API Daftar akun WhatsApp
Gunakan API ini untuk mendapatkan daftar lengkap semua nomor WhatsApp Anda beserta status koneksinya, dalam satu panggilan. Berbeda dengan Daftar nomor terhubung, API ini juga menyertakan nomor yang terputus.
https://wbiztool.com/api/v1/whatsapp/accounts/Body: JSON atau field formulir
| Perbedaan | Daftar akun | Daftar nomor terhubung |
|---|---|---|
| Menyertakan nomor yang terputus dan dihapus | Ya | Tidak |
| Key setiap item | whatsapp_client_id, whatsapp_number, status | id, whatsapp_client_id, whatsapp_client_number, is_connected |
message saat berhasil | Tidak disertakan | okay |
Contoh singkat#
curl -X POST https://wbiztool.com/api/v1/whatsapp/accounts/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY"
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/whatsapp/accounts/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
},
timeout=30,
)
result = response.json() # read the body even when the HTTP code is 400 or 403
if result.get("status") == 1:
for account in result["whatsapp_clients"]:
print(account["whatsapp_client_id"], account["whatsapp_number"], account["status"])
else:
print("Failed:", result.get("message", "no response"))// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/whatsapp/accounts/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_id: 12345,
api_key: "YOUR_API_KEY",
}),
});
const result = await response.json(); // read the body even when the HTTP code is 400 or 403
if (result.status === 1) {
for (const account of result.whatsapp_clients) {
console.log(account.whatsapp_client_id, account.whatsapp_number, account.status);
}
} else {
console.error("Failed:", result.message ?? "no response");
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp/accounts/');
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) {
foreach ($result['whatsapp_clients'] as $account) {
echo $account['whatsapp_client_id'] . ' ' . $account['whatsapp_number'] . ' ' . $account['status'] . PHP_EOL;
}
} else {
echo 'Failed: ' . ($result['message'] ?? 'no response');
}Ganti 12345 dan YOUR_API_KEY dengan nilai Anda sendiri. Lihat Autentikasi untuk mengetahui di mana menemukannya.
Kedua klien resmi tidak memiliki method untuk endpoint ini, jadi panggil secara langsung seperti pada contoh.
Parameter request#
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. Daftar yang dikembalikan adalah untuk workspace tempat kunci ini dibuat.
Respons#
Request yang berhasil mengembalikan HTTP 200:
{
"whatsapp_clients": [
{
"whatsapp_client_id": 678,
"whatsapp_number": "919876543210",
"status": "connected"
},
{
"whatsapp_client_id": 702,
"whatsapp_number": "919812345678",
"status": "not_connected"
}
],
"status": 1
}
| Field | Tipe | Deskripsi |
|---|---|---|
status | integer | 1 jika berhasil, 0 jika request gagal. |
whatsapp_clients | array | Setiap nomor WhatsApp yang pernah ditambahkan ke workspace ini. Hanya ada jika berhasil. |
whatsapp_clients[].whatsapp_client_id | integer | ID nomor tersebut. Kirim sebagai whatsapp_client di panggilan API lainnya. |
whatsapp_clients[].whatsapp_number | string | Nomor telepon seperti yang disimpan saat ditambahkan. |
whatsapp_clients[].status | string | connected atau not_connected. |
Urutan daftar tidak dijamin. Urutkan berdasarkan whatsapp_client_id jika urutan penting.
Respons yang berhasil tidak memiliki field message, jadi bacalah dengan nilai cadangan (fallback) seperti pada contoh.
Error#
| Pesan | HTTP | Cara memperbaikinya |
|---|---|---|
Auth Error | 200 | Kirim client_id dan api_key di body POST, sebagai JSON atau field formulir yang valid. |
Invalid Client Id | 403 | Kirim client_id sebagai bilangan bulat, misalnya 12345. |
Auth Error: invalid api key | 400 | Pastikan kunci tersebut ada, belum dihapus, dan milik client_id ini. |
Jika server mengalami masalah tak terduga, atau request bukan POST, responsnya berupa objek kosong: {}. Anggap status yang tidak ada sebagai kegagalan.
Tips#
- Menghubungkan kembali nomor: nomor
not_connecteddapat dihubungkan kembali di WhatsApp settings atau dengan Hubungkan nomor. - Hanya satu nomor: untuk memeriksa satu nomor, gunakan Status koneksi.
- Beberapa workspace: Kunci API menentukan workspace mana yang ditampilkan. Gunakan kunci yang dibuat di workspace yang Anda inginkan.

