API حسابات WhatsApp
API حالة اتصال WhatsApp
تحقّق مما إذا كان أحد أرقام WhatsApp الخاصة بك متصلًا وجاهزًا لإرسال الرسائل. استخدمه قبل حملة، أو أثناء انتظار اكتمال ربط رقم متصل حديثًا. استخدم نقطة النهاية هذه بدلًا من /api/v1/whatsapp/status/<id>/ التي لا تعمل.
https://wbiztool.com/api/v1/whatsapp-client/status/النص (Body): 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 (API Client ID) من Settings → API keys (الإعدادات ← مفاتيح API).
api_keystringمطلوبمفتاح API الخاص بك من الصفحة نفسها.
whatsapp_clientintegerمطلوبمعرّف رقم WhatsApp المراد التحقق منه، من إعدادات 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)تُطلق مكتبة Python الاستثناء requests.exceptions.HTTPError عندما يُرجع API رمز HTTP 400 أو 403، لذا ضع الاستدعاء داخل try/except.
تستدعي الدالة getWhatsAppClientStatus() في مكتبة Node.js عنوانًا غير موجود، فتفشل بالخطأ 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 هذا غير موجود في مساحة العمل الخاصة بمفتاح API هذا. |
Demo Account can not access apis | 200 | استخدم حسابًا عاديًا. |
نصائح#
- قبل الإرسال: إذا كان الرقم الذي ترسل منه غير متصل، فستنتظر رسائله في قائمة الانتظار حتى يعود الاتصال أو تنتهي صلاحيتها، لذا تحقّق من الحالة قبل عمليات الإرسال الكبيرة. تُحذف الرسائل غير المرسلة على رقم غير متصل بعد 90 يومًا.
- بعد ربط رقم: استعلم من نقطة النهاية هذه كل بضع ثوانٍ حتى تُرجع
Connected. قد يصل webhook connectedقبل أن تُرجع نقطة النهاية هذهConnectedببضع ثوانٍ، لذا واصل الاستعلام لمدة تصل إلى دقيقة بعد وصول الحدث. راجع ربط رقم. - كل الأرقام دفعة واحدة: للحصول على حالة كل الأرقام في استدعاء واحد، استخدم عرض الحسابات.
