WhatsApp hesapları API'si
WhatsApp bağlantı durumu API'si
WhatsApp numaralarınızdan birinin bağlı ve mesaj göndermeye hazır olup olmadığını kontrol edin. Bir kampanyadan önce veya yeni bağlanan bir numaranın bağlantısının tamamlanmasını beklerken kullanın. Çalışmayan /api/v1/whatsapp/status/<id>/ yerine bu endpoint'i kullanın.
https://wbiztool.com/api/v1/whatsapp-client/status/Gövde: JSON veya form alanları
Hızlı örnek#
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');
}12345, YOUR_API_KEY ve 678 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#
client_idintegerzorunluAyarlar → API anahtarları sayfasındaki API Client ID'niz.
api_keystringzorunluAynı sayfadaki API anahtarınız.
whatsapp_clientintegerzorunluKontrol edilecek WhatsApp numarasının ID'si; WhatsApp ayarları sayfasından, Hesapları listeleme endpoint'inden veya Numara bağlama tarafından döndürülen
whatsapp_client_iddeğerinden alınır.
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.get_whatsapp_client_status(678)
print(result)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 getWhatsAppClientStatus() 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#
Kimlik bilgileriniz geçerli olduğunda istek, şu gövdelerden biriyle HTTP 200 döndürür.
Numara bağlı:
{ "message": "Connected", "status": 1 }
Numara bağlı değil:
{ "message": "Disconnected", "status": 0 }
| Alan | Tür | Açıklama |
|---|---|---|
status | integer | Numara bağlıysa 1. Numara bağlı değilse veya istek başarısız olduysa 0. |
message | string | Connected, Disconnected veya hata mesajı. |
WhatsApp ayarlarından sildiğiniz bir numara da Disconnected döndürür.
Hatalar#
| Mesaj | HTTP | Nasıl düzeltilir |
|---|---|---|
Auth Error | 200 | client_id, api_key ve sayısal bir whatsapp_client değerini 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. |
Auth Error 2 | 200 | Bu whatsapp_client ID'si bu API anahtarının çalışma alanında değil. |
Demo Account can not access apis | 200 | Normal bir hesap kullanın. |
İpuçları#
- Göndermeden önce: gönderim yaptığınız numaranın bağlantısı kesikse, mesajları numara yeniden bağlanana veya süreleri dolana kadar kuyrukta bekler; bu yüzden büyük gönderimlerden önce durumu kontrol edin. Bağlantısı kesik bir numaradaki gönderilmemiş mesajlar 90 gün sonra silinir.
- Bir numara bağladıktan sonra:
Connecteddöndürene kadar bu endpoint'i birkaç saniyede bir sorgulayın.connectedwebhook'u, bu endpointConnecteddöndürmeden birkaç saniye önce gelebilir; bu yüzden olaydan sonra bir dakikaya kadar sorgulamaya devam edin. Bkz. Numara bağlama. - Tüm numaralar bir arada: tek bir çağrıyla her numaranın durumunu almak için Hesapları listeleme endpoint'ini kullanın.
