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

API حسابات WhatsApp

API حالة اتصال WhatsApp

تحقّق مما إذا كان أحد أرقام WhatsApp الخاصة بك متصلًا وجاهزًا لإرسال الرسائل. استخدمه قبل حملة، أو أثناء انتظار اكتمال ربط رقم متصل حديثًا. استخدم نقطة النهاية هذه بدلًا من /api/v1/whatsapp/status/<id>/ التي لا تعمل.

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

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

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 }
الحقلالنوعالوصف
statusinteger‏1 إذا كان الرقم متصلًا. و0 إذا لم يكن متصلًا أو إذا فشل الطلب.
messagestring‏Connected أو Disconnected أو نص الخطأ.

الرقم الذي حذفته من إعدادات WhatsApp يُرجع أيضًا Disconnected.

الأخطاء#

الرسالةHTTPطريقة الإصلاح
Auth Error200أرسل client_id وapi_key وقيمة رقمية لـ whatsapp_client في جسم طلب POST، بصيغة JSON صالحة أو كحقول نموذج.
Invalid Client Id403أرسل client_id كعدد صحيح، مثل 12345.
Auth Error: invalid api key400تأكد من أن المفتاح موجود، ولم يُحذف، وينتمي إلى client_id هذا.
Auth Error 2200معرّف whatsapp_client هذا غير موجود في مساحة العمل الخاصة بمفتاح API هذا.
Demo Account can not access apis200استخدم حسابًا عاديًا.

نصائح#

  • قبل الإرسال: إذا كان الرقم الذي ترسل منه غير متصل، فستنتظر رسائله في قائمة الانتظار حتى يعود الاتصال أو تنتهي صلاحيتها، لذا تحقّق من الحالة قبل عمليات الإرسال الكبيرة. تُحذف الرسائل غير المرسلة على رقم غير متصل بعد 90 يومًا.
  • بعد ربط رقم: استعلم من نقطة النهاية هذه كل بضع ثوانٍ حتى تُرجع Connected. قد يصل webhook ‏connected قبل أن تُرجع نقطة النهاية هذه Connected ببضع ثوانٍ، لذا واصل الاستعلام لمدة تصل إلى دقيقة بعد وصول الحدث. راجع ربط رقم.
  • كل الأرقام دفعة واحدة: للحصول على حالة كل الأرقام في استدعاء واحد، استخدم عرض الحسابات.