انتقل إلى المحتوى
WbizTool

API حسابات WhatsApp

API عرض أرقام WhatsApp المتصلة

احصل على أرقام WhatsApp في مساحة العمل الخاصة بك التي يمكنها الإرسال الآن، أو التي تنتظر رسائلها متصفحها. استخدمه لتتيح للمستخدمين اختيار الرقم الذي يرسلون منه، أو لمعرفة معرّف whatsapp_client لاستدعاءات API الأخرى.

POSThttps://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"
  }'

استبدل 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 نقطة النهاية هذه نيابةً عنك.

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
}
الحقلالنوعالوصف
statusinteger‏1 عند النجاح، و0 إذا فشل الطلب.
messagestring‏okay عند النجاح، وإلا نص الخطأ.
whatsapp_clientsarrayأرقامك المتصلة وأرقام الإضافة التي تنتظر متصفحها. تكون فارغة إذا لم يوجد أيٌّ منها. تظهر عند النجاح فقط.
whatsapp_clients[].whatsapp_client_idintegerمعرّف الرقم. مرّره كقيمة whatsapp_client في استدعاءات API الأخرى.
whatsapp_clients[].idintegerالقيمة نفسها الموجودة في whatsapp_client_id.
whatsapp_clients[].whatsapp_client_numberstringرقم الهاتف كما حُفظ عند إضافة الرقم.
whatsapp_clients[].platformstring‏whatsapp لرقم WhatsApp، وtelegram لـ حساب Telegram. أرسل من أيّ منهما بمعرّفه كـ whatsapp_client.
whatsapp_clients[].is_connectedboolean‏true للرقم المتصل، وfalse لرقم إضافة ينتظر متصفحه.
whatsapp_clients[].statusstring‏connected: الرقم يرسل الآن. ‏waiting_for_browser: رقم إضافة Chrome متصفحه مغلق؛ الرسائل المرسلة منه تنتظر وتُرسَل عندما يعود المتصفح، أو تنتهي صلاحيتها بعد 48 ساعة.

لا تُرتَّب القائمة بأي ترتيب مضمون. رتّبها حسب whatsapp_client_id إذا كان الترتيب مهمًا.

الأخطاء#

الرسالةHTTPطريقة الإصلاح
Auth Error200أرسل client_id وapi_key كليهما في جسم طلب POST، بصيغة JSON صالحة أو كحقول نموذج.
Invalid Client Id403أرسل client_id كعدد صحيح، مثل 12345.
Auth Error: invalid api key400تأكد من أن المفتاح موجود، ولم يُحذف، وينتمي إلى client_id هذا.

الطلب الذي ليس POST يُرجع كائنًا فارغًا {}. وعند حدوث مشكلة غير متوقعة في الخادم، يُرجع HTTP 500 مع جسم بصيغة HTML، لذا تحقّق من أن الاستجابة بصيغة JSON قبل قراءة status.

نصائح#

  • قائمة فارغة: تعني "whatsapp_clients": [] أنه لا يوجد رقم متصل في مساحة العمل هذه، ولا رقم إضافة ينتظر متصفحه. اربط رقمًا من إعدادات WhatsApp أو باستخدام ربط رقم.
  • عدة مساحات عمل: مفتاح API هو الذي يحدّد مساحة العمل التي تُعرض. استخدم مفتاحًا أُنشئ في مساحة العمل التي تريدها.
  • رقم واحد فقط: للتحقق من رقم واحد، استخدم حالة الاتصال.