الجلسات (Instances)

الجلسات (Instances) هي الطريقة الرئيسية لإدارة اتصالات WhatsApp في Omdaa API. كل جلسة تمثل اتصال WhatsApp واحد ويمكنك إنشاء عدة جلسات لإدارة أرقام متعددة.

إنشاء جلسة جديدة

لإنشاء جلسة جديدة، استخدم endpoint إنشاء الجلسة. ستحصل على instanceName فريد يمكنك استخدامه في جميع الطلبات اللاحقة.

"function">curl "keyword">-X POST https://omdaa.com/api/v1/instances/create \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "keyword">-H "Content"keyword">-Type: application/json" \
  "keyword">-d '{
  "instanceName": "my"keyword">-instance",
  "deviceName": "My Device"
}'

المعاملات المطلوبة

المعاملالنوعالوصف
instanceNamestringاسم فريد للجلسة
deviceNamestringاسم الجهاز (اختياري)

الحصول على QR Code

بعد إنشاء الجلسة، ستحتاج إلى مسح رمز QR لربط رقم WhatsApp الخاص بك. يمكنك الحصول على QR Code باستخدام endpoint التالي:

"function">curl "keyword">-X GET "https://omdaa.com/api/v1/instances/my class="keyword">-instance/qrcode" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

ملاحظات مهمة:

  • QR Code صالح لمدة 60 ثانية فقط
  • إذا انتهت صلاحية QR Code، يمكنك طلب واحد جديد
  • بعد مسح QR Code بنجاح، ستكون الجلسة متصلة تلقائياً

التحقق من حالة الاتصال

يمكنك التحقق من حالة اتصال الجلسة في أي وقت:

"function">curl "keyword">-X GET "https://omdaa.com/api/v1/instances/my class="keyword">-instance/connectionState" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

حالات الاتصال

open
الجلسة متصلة وجاهزة
close
الجلسة غير متصلة
connecting
الجلسة في حالة اتصال

الحصول على جميع الجلسات

للحصول على قائمة بجميع الجلسات الخاصة بك:

"function">curl "keyword">-X GET "https://omdaa.com/api/v1/instances" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

💡 نصيحة

يمكنك إنشاء عدة جلسات لإدارة أرقام WhatsApp متعددة. كل جلسة مستقلة تماماً ويمكن استخدامها لإرسال واستقبال الرسائل بشكل منفصل.