WhatsApp अकाउंट API
WhatsApp कनेक्शन स्टेटस API
जांचें कि आपका कोई WhatsApp नंबर कनेक्टेड है और संदेश भेजने के लिए तैयार है या नहीं। इसे किसी कैंपेन से पहले, या किसी नए कनेक्ट किए गए नंबर के लिंक होने का इंतज़ार करते समय इस्तेमाल करें। /api/v1/whatsapp/status/<id>/ की जगह यही एंडपॉइंट इस्तेमाल करें, क्योंकि वह काम नहीं करता।
https://wbiztool.com/api/v1/whatsapp-client/status/बॉडी: JSON या फॉर्म फील्ड
छोटा उदाहरण#
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 और 678 की जगह अपनी वैल्यू डालें। ये कहां मिलेंगी, यह जानने के लिए ऑथेंटिकेशन देखें।
रिक्वेस्ट पैरामीटर#
client_idintegerआवश्यकसेटिंग्स → API Keys से आपका API क्लाइंट ID।
api_keystringआवश्यकउसी पेज से आपकी API की।
whatsapp_clientintegerआवश्यकजांचे जाने वाले WhatsApp नंबर का ID, जो WhatsApp सेटिंग्स, अकाउंट की सूची या नंबर कनेक्ट करें से लौटाए गए
whatsapp_client_idसे मिलता है।
आधिकारिक क्लाइंट का इस्तेमाल#
Python क्लाइंट आपके लिए यह एंडपॉइंट कॉल करता है।
from wbiztool_client import WbizToolClient
client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)
result = client.get_whatsapp_client_status(678)
print(result)जब API HTTP 400 या 403 लौटाता है, तो Python क्लाइंट requests.exceptions.HTTPError रेज़ करता है, इसलिए कॉल को try/except में रखें।
Node.js क्लाइंट का getWhatsAppClientStatus() ऐसे पते को कॉल करता है जो मौजूद नहीं है और 404 के साथ फेल हो जाता है। छोटा उदाहरण की तरह fetch इस्तेमाल करें।
रिस्पॉन्स#
आपके क्रेडेंशियल सही होने पर रिक्वेस्ट HTTP 200 के साथ इनमें से कोई एक बॉडी लौटाती है।
नंबर कनेक्टेड है:
{ "message": "Connected", "status": 1 }
नंबर कनेक्टेड नहीं है:
{ "message": "Disconnected", "status": 0 }
| फील्ड | टाइप | विवरण |
|---|---|---|
status | integer | नंबर कनेक्टेड हो तो 1। नंबर कनेक्टेड न हो या रिक्वेस्ट फेल हो तो 0। |
message | string | Connected, Disconnected, या एरर। |
जो नंबर आपने WhatsApp सेटिंग्स से डिलीट किया है, वह भी Disconnected लौटाता है।
एरर#
| संदेश | HTTP | कैसे ठीक करें |
|---|---|---|
Auth Error | 200 | client_id, api_key और संख्या वाला whatsapp_client को POST बॉडी में, सही JSON या फॉर्म फील्ड के रूप में भेजें। |
Invalid Client Id | 403 | client_id को पूर्ण संख्या के रूप में भेजें, जैसे 12345। |
Auth Error: invalid api key | 400 | जांचें कि की मौजूद है, डिलीट नहीं हुई है और इसी client_id की है। |
Auth Error 2 | 200 | वह whatsapp_client ID इस API की वाले वर्कस्पेस में नहीं है। |
Demo Account can not access apis | 200 | सामान्य अकाउंट इस्तेमाल करें। |
सुझाव#
- भेजने से पहले: जिस नंबर से आप भेजते हैं, अगर वह डिसकनेक्ट है, तो उसके संदेश तब तक कतार में रहते हैं जब तक नंबर दोबारा कनेक्ट न हो जाए या संदेश एक्सपायर न हो जाएं, इसलिए बड़ी संख्या में भेजने से पहले स्टेटस जांच लें। डिसकनेक्ट नंबर पर न भेजे गए संदेश 90 दिन बाद हटा दिए जाते हैं।
- नंबर कनेक्ट करने के बाद: हर कुछ सेकंड में यह एंडपॉइंट कॉल करें, जब तक यह
Connectedन लौटाए।connectedवेबहुक इस एंडपॉइंट केConnectedलौटाने से कुछ सेकंड पहले आ सकता है, इसलिए इवेंट के बाद एक मिनट तक पोल करते रहें। नंबर कनेक्ट करें देखें। - सभी नंबर एक साथ: एक ही कॉल में हर नंबर का स्टेटस पाने के लिए अकाउंट की सूची इस्तेमाल करें।
