API حسابات WhatsApp
API عرض أرقام WhatsApp المتصلة
احصل على أرقام WhatsApp في مساحة العمل الخاصة بك التي يمكنها الإرسال الآن، أو التي تنتظر رسائلها متصفحها. استخدمه لتتيح للمستخدمين اختيار الرقم الذي يرسلون منه، أو لمعرفة معرّف whatsapp_client لاستدعاءات API الأخرى.
https://wbiztool.com/api/v1/whatsapp-client/list/النص (Body): JSON أو حقول نموذج
تُرجَع الأرقام المتصلة، إضافةً إلى أرقام إضافة Chrome التي متصفحها مغلق (status بقيمة waiting_for_browser): يمكنك الإرسال منها، وتنتظر رسائلها حتى يعود المتصفح. لرؤية الأرقام غير المتصلة أيضًا، استخدم عرض الحسابات. وتُدرَج حسابات Telegram المتصلة أيضًا، مع platform بقيمة telegram.
مثال سريع#
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 وYOUR_API_KEY بقيمك الخاصة. راجع المصادقة لمعرفة مكان العثور عليها.
معاملات الطلب#
Authorizationheaderموصى به
Bearer YOUR_API_KEY: مفتاح API الخاص بك من Settings → API keys (الإعدادات ← مفاتيح API). مع الترويسة، يمكن حذفclient_idوapi_keyمن الجسم؛ وإذا أُرسل المفتاح في الترويسة والجسم معًا، يُستخدم مفتاح الترويسة إذا كان صالحًا. راجع إرسال المفتاح في ترويسة.client_idintegerبدون ترويسة Authorizationمعرّف العميل في API (API Client ID) من Settings → API keys. اختياري مع الترويسة؛ وإذا أرسلته، فيجب أن يكون لمساحة عمل المفتاح.
api_keystringبدون ترويسة Authorizationمفتاح API الخاص بك من الصفحة نفسها، عندما لا ترسله في الترويسة. تخص القائمة مساحة العمل التي أُنشئ فيها هذا المفتاح.
استخدام مكتبات العملاء الرسمية#
تستدعي مكتبة Python نقطة النهاية هذه نيابةً عنك.
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 الاستثناء requests.exceptions.HTTPError عندما يُرجع API رمز HTTP 400 أو 403، لذا ضع الاستدعاء داخل try/except.
تستدعي الدالة getWhatsAppClients() في مكتبة Node.js عنوانًا غير موجود، فتفشل بالخطأ 404. استخدم fetch كما في المثال السريع.
الاستجابة#
يُرجع الطلب الناجح HTTP 200:
{
"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
}
| الحقل | النوع | الوصف |
|---|---|---|
status | integer | 1 عند النجاح، و0 إذا فشل الطلب. |
message | string | okay عند النجاح، وإلا نص الخطأ. |
whatsapp_clients | array | أرقامك المتصلة وأرقام الإضافة التي تنتظر متصفحها. تكون فارغة إذا لم يوجد أيٌّ منها. تظهر عند النجاح فقط. |
whatsapp_clients[].whatsapp_client_id | integer | معرّف الرقم. مرّره كقيمة whatsapp_client في استدعاءات API الأخرى. |
whatsapp_clients[].id | integer | القيمة نفسها الموجودة في whatsapp_client_id. |
whatsapp_clients[].whatsapp_client_number | string | رقم الهاتف كما حُفظ عند إضافة الرقم. |
whatsapp_clients[].platform | string | whatsapp لرقم WhatsApp، وtelegram لـ حساب Telegram. أرسل من أيّ منهما بمعرّفه كـ whatsapp_client. |
whatsapp_clients[].is_connected | boolean | true للرقم المتصل، وfalse لرقم إضافة ينتظر متصفحه. |
whatsapp_clients[].status | string | connected: الرقم يرسل الآن. waiting_for_browser: رقم إضافة Chrome متصفحه مغلق؛ الرسائل المرسلة منه تنتظر وتُرسَل عندما يعود المتصفح، أو تنتهي صلاحيتها بعد 48 ساعة. |
لا تُرتَّب القائمة بأي ترتيب مضمون. رتّبها حسب whatsapp_client_id إذا كان الترتيب مهمًا.
الأخطاء#
| الرسالة | HTTP | طريقة الإصلاح |
|---|---|---|
Auth Error | 200 | أرسل client_id وapi_key كليهما في جسم طلب POST، بصيغة JSON صالحة أو كحقول نموذج. |
Invalid Client Id | 403 | أرسل client_id كعدد صحيح، مثل 12345. |
Auth Error: invalid api key | 400 | تأكد من أن المفتاح موجود، ولم يُحذف، وينتمي إلى client_id هذا. |
الطلب الذي ليس POST يُرجع كائنًا فارغًا {}. وعند حدوث مشكلة غير متوقعة في الخادم، يُرجع HTTP 500 مع جسم بصيغة HTML، لذا تحقّق من أن الاستجابة بصيغة JSON قبل قراءة status.
نصائح#
- قائمة فارغة: تعني
"whatsapp_clients": []أنه لا يوجد رقم متصل في مساحة العمل هذه، ولا رقم إضافة ينتظر متصفحه. اربط رقمًا من إعدادات WhatsApp أو باستخدام ربط رقم. - عدة مساحات عمل: مفتاح API هو الذي يحدّد مساحة العمل التي تُعرض. استخدم مفتاحًا أُنشئ في مساحة العمل التي تريدها.
- رقم واحد فقط: للتحقق من رقم واحد، استخدم حالة الاتصال.

