WhatsApp hesapları API'si
Bağlı WhatsApp numaralarını listeleme API'si
Çalışma alanınızda şu anda gönderim yapabilen veya mesajları tarayıcısını bekleyen WhatsApp numaralarını alın. Kullanıcıların gönderim yapacakları numarayı seçmesini sağlamak veya diğer API çağrıları için whatsapp_client ID'sini bulmak için kullanın.
https://wbiztool.com/api/v1/whatsapp-client/list/Gövde: JSON veya form alanları
Bağlı numaralar ve tarayıcısı kapalı olan Chrome uzantısı numaraları (status waiting_for_browser) döndürülür: bu numaralardan gönderebilirsiniz ve mesajları tarayıcı geri gelene kadar bekler. Bağlantısı kesik numaraları da görmek için Hesapları listeleme endpoint'ini kullanın. Bağlı Telegram hesapları da platform değeri telegram olarak listelenir.
Hızlı örnek#
curl -X POST https://wbiztool.com/api/v1/whatsapp-client/list/ \
-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-client/list/",
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 number in result["whatsapp_clients"]:
print(number["whatsapp_client_id"], number["whatsapp_client_number"])
else:
print("Failed:", result.get("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/list/", {
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 number of result.whatsapp_clients) {
console.log(number.whatsapp_client_id, number.whatsapp_client_number);
}
} else {
console.error("Failed:", result.message);
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp-client/list/');
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 $number) {
echo $number['whatsapp_client_id'] . ' ' . $number['whatsapp_client_number'] . PHP_EOL;
}
} else {
echo 'Failed: ' . ($result['message'] ?? 'no response');
}12345 ve YOUR_API_KEY değerlerini kendi değerlerinizle değiştirin. Bunları nerede bulacağınız için Kimlik doğrulama bölümüne bakın.
İstek parametreleri#
AuthorizationheaderÖnerilirBearer YOUR_API_KEY: Ayarlar → API anahtarları sayfasındaki API anahtarınız. Bu başlıklaclient_idveapi_keygövdeden çıkarılabilir; ikisi birden gönderilirse başlıktaki geçerli anahtar kullanılır. Bkz. Anahtarı başlıkta gönderin.client_idintegerAuthorization başlığı olmadanAyarlar → API anahtarları sayfasındaki API Client ID'niz. Başlıkla isteğe bağlıdır; gönderirseniz anahtarın çalışma alanına ait olmalıdır.
api_keystringAuthorization başlığı olmadanAynı sayfadaki API anahtarınız; başlıkta göndermediğinizde. Liste, bu anahtarın oluşturulduğu çalışma alanı içindir.
Resmi istemcileri kullanma#
Python istemcisi bu endpoint'i sizin için çağırır.
from wbiztool_client import WbizToolClient
client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)
result = client.list_whatsapp_clients()
for number in result.get("whatsapp_clients", []):
print(number["whatsapp_client_id"], number["whatsapp_client_number"])Python istemcisi, API HTTP 400 veya 403 döndürdüğünde requests.exceptions.HTTPError fırlatır; bu yüzden çağrıyı try/except içine alın.
Node.js istemcisinin getWhatsAppClients() yöntemi var olmayan bir adresi çağırır ve 404 ile başarısız olur. Hızlı örnek bölümündeki gibi fetch kullanın.
Yanıt#
Başarılı bir istek HTTP 200 döndürür:
{
"message": "okay",
"whatsapp_clients": [
{
"id": 678,
"whatsapp_client_id": 678,
"whatsapp_client_number": "919876543210",
"platform": "whatsapp",
"is_connected": true,
"status": "connected"
},
{
"id": 702,
"whatsapp_client_id": 702,
"whatsapp_client_number": "919812345670",
"platform": "telegram",
"is_connected": true,
"status": "connected"
},
{
"id": 731,
"whatsapp_client_id": 731,
"whatsapp_client_number": "919898989898",
"platform": "whatsapp",
"is_connected": false,
"status": "waiting_for_browser"
}
],
"status": 1
}
| Alan | Tür | Açıklama |
|---|---|---|
status | integer | Başarıda 1, istek başarısız olduysa 0. |
message | string | Başarıda okay, aksi halde hata mesajı. |
whatsapp_clients | dizi | Bağlı numaralarınız ve tarayıcısını bekleyen uzantı numaralarınız. Hiçbiri yoksa boştur. Yalnızca başarıda bulunur. |
whatsapp_clients[].whatsapp_client_id | integer | Numaranın ID'si. Diğer API çağrılarında whatsapp_client olarak iletin. |
whatsapp_clients[].id | integer | whatsapp_client_id ile aynı değer. |
whatsapp_clients[].whatsapp_client_number | string | Numara eklendiğinde kaydedildiği haliyle telefon numarası. |
whatsapp_clients[].platform | string | Bir WhatsApp numarası için whatsapp, bir Telegram hesabı için telegram. İkisinden de ID'sini whatsapp_client olarak ileterek gönderin. |
whatsapp_clients[].is_connected | boolean | Bağlı bir numara için true, tarayıcısını bekleyen bir uzantı numarası için false. |
whatsapp_clients[].status | string | connected: numara şimdi gönderir. waiting_for_browser: tarayıcısı kapalı bir Chrome uzantısı numarası; ondan gönderilen mesajlar bekler ve tarayıcı geri geldiğinde gider ya da 48 saat sonra süreleri dolar. |
Listenin sırası garanti edilmez. Sıra önemliyse whatsapp_client_id değerine göre sıralayın.
Hatalar#
| Mesaj | HTTP | Nasıl düzeltilir |
|---|---|---|
Auth Error | 200 | client_id ve api_key değerlerinin ikisini de bir POST gövdesinde, geçerli JSON veya form alanları olarak gönderin. |
Invalid Client Id | 403 | client_id değerini 12345 gibi bir tam sayı olarak gönderin. |
Auth Error: invalid api key | 400 | Anahtarın mevcut olduğunu, silinmediğini ve bu client_id değerine ait olduğunu kontrol edin. |
POST olmayan bir istek boş bir nesne {} döndürür. Beklenmeyen bir sunucu sorunu HTML gövdesiyle HTTP 500 döndürür; bu yüzden status değerini okumadan önce yanıtın JSON olduğunu kontrol edin.
İpuçları#
- Boş liste:
"whatsapp_clients": []bu çalışma alanında bağlı numara olmadığı ve tarayıcısını bekleyen bir uzantı numarası da bulunmadığı anlamına gelir. WhatsApp ayarları sayfasından veya Numara bağlama ile bir numara bağlayın. - Birden fazla çalışma alanı: hangi çalışma alanının listeleneceğini API anahtarı belirler. İstediğiniz çalışma alanında oluşturulmuş bir anahtar kullanın.
- Yalnızca bir numara: tek bir numarayı kontrol etmek için Bağlantı durumu endpoint'ini kullanın.

