جلسات واتساب على Omdaa: QR، Monitoring، وإعادة الاتصال
Session هي وحدة التشغيل لأي إرسال عبر Omdaa: بدون جلسة connected تفشل طلبات الإرسال حتى لو كان API Key صالحاً. تُدار من /dashboard/sessions مع صفحة Monitoring للزمن الفعلي.
دورة حياة الجلسة
إنشاء Session → عرض QR → مسح من هاتف واتساب → انتقال إلى connected → إرسال/استقبال. عند انتهاء QR أو logout يظهر disconnected/need-scan. استخدم regenerate QR بدل إنشاء جلسة جديدة بلا داعٍ حتى لا تضيع إعدادات webhook المرتبطة.
Restart مفيد بعد تعليق الاتصال؛ Pause يوقف الاستخدام المؤقت دون حذف البيانات. Diagnostics تساعد على معرفة هل المشكلة شبكة، بروكسي، أو حالة واتساب على الجهاز.
مراقبة الإنتاج
راقب latency وإعادة الاتصال. اضبط تنبيهات داخل الفريق عند سقوط الجلسة (Webhook أحداث session أو مراقبة خارجية). لا تشغّل نفس الرقم على Baileys محلي + Omdaa معاً — تعارض pairing شائع.
Proxy وإعدادات
في الشبكات المقيّدة يمكن ربط Proxy بالجلسة. حدّث presence وإعدادات الجلسة حسب سياسة الدعم (متصل/كتابة). اربط webhook URL على مستوى الجلسة إذا كان لديك عدة أرقام بمنطق مختلف.
أفضل ممارسات للأرقام
رقم أعمال مخصص، 2FA على واتساب، تجنّب ربط عشوائي على أجهزة متعددة. للأرقام الجديدة: خطة warming قبل Bulk. راجع أيضاً مقال WhatsApp API في السلسلة للربط مع REST.
حالات الجلسة التي يجب أن يفهمها فريقك
connecting أثناء مسح QR، connected جاهز للإرسال، disconnected بعدlogout أو سقوط شبكة، وحالات الحاجة لإعادة المسح. لا تعتمد فقط على لون الواجهة — اربط مراقبة برمجية (Webhook أحداث الجلسة أو polling حذر) لغرفة العمليات.
عند تعدد الجلسات (دعم، مبيعات، تنبيهات)، سمِّ الجلسات بأسماء واضحة في اللوحة واحفظ خريطة sessionId → فريق في وثائقك الداخلية. خطأ شائع: إرسال حملات تسويق من جلسة الدعم مما يلوّث جودة الرقم.
استرداد بعد الانقطاع
رتّب الأولويات: هل الهاتف متصل بالإنترنت؟ هل واتساب سجّل خروجاً؟ هل البروكسي سقط؟ جرّب Restart ثم QR جديد. إن تكرّر السقوط كل ساعة راجع استقرار الشبكة أو سياسة إسبات الجهاز. الأجهزة اللوحية المخصّصة للرقم غالباً أثبت من هاتف شخصي يُعاد تشغيله يومياً.
عزل البيئات
جلسة staging منفصلة عن الإنتاج. لا تختبر Bulk على رقم العملاء. مفاتيح API للـ staging بـ scopes أضيق. وثّق من يملك حق حذف الجلسة — الحذف حادث أمني وتشغيلي في آن.
سعة الجلسات والتخطيط
احسب الجلسات المطلوبة = خطوط الدعم + خطوط الحملات + staging. لا تشارك رقم الحملات مع الدعم. راجع الفاتورة/الخطة قبل موسم الذروة. جلسة زائدة غير مستخدمة تُربك المراقبة — احذف أو أوقف بوضوح.
أسئلة شائعة
لماذا الإرسال يفشل رغم الـ Key؟
غالباً الجلسة ليست connected — افتح Sessions/Monitoring.
هل أحتاج جلسة لكل رقم؟
نعم — جلسة لكل رقم واتساب.
ماذا بعد logout من الهاتف؟
أعد مسح QR من اللوحة؛ لا تحذف الجلسة إلا إذا أردت تنظيفاً كاملاً.
هل Monitoring مجاني؟
ضمن أدوات اللوحة على الخطة المجانية وفق الحدود المعروضة.
ابدأ مجاناً: إنشاء حساب · لوحة التحكم · الوثائق