صندوق الوارد
صندوق الوارد الموحّد في TelegramOS: كل محادثة من جميع حسابات Telegram الخاصة بك في طابور واحد، مع الإسناد والردود.
يجمع صندوق الوارد محادثات الرسائل المباشرة والمجموعات والقنوات والبوتات عبر كل حساب في مساحة العمل الخاصة بك في تدفق واحد فوري.
مفاهيم صندوق الوارد الموحّد
يحتفظ كل حساب باتصال MTProto الخاص به عبر بروكسيه الخاص. المحادثات الخاصة والمجموعات الأساسية والمجموعات الفائقة تُستوعب دائماً. أما منشورات قنوات البث فتُستوعب فقط إذا كانت القناة ضمن مجموعاتك المتابَعة (اختياري؛ تُحدَّث القائمة كل 5 دقائق).
تُزال الرسائل المكررة حسب الحساب ومعرّف المحادثة ومعرّف رسالة Telegram.
| الميزة | الوصف |
|---|---|
| التحديثات الفورية | يدفع اتصال Socket.IO الرسائل الجديدة فور وصولها. لا استطلاع دوري. |
| فلتر لكل حساب | فلترة صندوق الوارد لعرض رسائل حساب واحد فقط. |
| فلتر لكل محادثة | الفلترة إلى محادثة أو مجموعة أو قناة محددة. |
| عدادات غير المقروء | عدادات غير المقروء لكل حساب ولكل محادثة. |
| البحث | بحث نصي كامل عبر جميع الرسائل (تُفهرس عند الاستيعاب). |
| الرد | الرد على أي رسالة مباشرة أو رسالة مجموعة من صندوق الوارد. |
الملكية والوسوم والحالة
لكل محادثة مالك وقائمة وسوم وحالة. كل عضو في مساحة العمل يملك صلاحية قراءة صندوق الوارد يرى الثلاثة.
| الحقل | طريقة العمل |
|---|---|
| المالك | خيار Assign to me في ترويسة المحادثة يسجّلها باسمك وUnassign يحرّرها. الاستلام يضع قفلاً لمدة 300 ثانية؛ الزميل الذي يحاول استلام المحادثة خلال هذه المدة يحصل على «Locked by another agent». لوحة التحكم تسند المحادثة فقط إلى الشخص الذي ينقر؛ PATCH /api/conversations/{id} يقبل أي assignee_id. |
| الوسوم | تسميات نصية حرة حتى 40 حرفاً. أضفها أو احذفها من ترويسة المحادثة، وأضف وسماً إلى عدة محادثات بالتحديد الجماعي، وفلتر القائمة حسب الوسوم (يجب أن تحمل المحادثة كل الوسوم المحددة). |
| الحالة | open أو pending أو resolved. اضبطها من ترويسة المحادثة، أو حُلّ المحادثات وأعد فتحها جماعياً. في القائمة تبويب لكل حالة. الحل يسجّل وقت الحل وإعادة الفتح تمسحه. |
التحديثات الفورية
يبث صندوق الوارد الرسائل الجديدة عبر Socket.IO 4 على المسار /ws على مضيف الموقع (wss://telegramos.net/ws). صادق باستخدام JWT الجلسة الخاص بك في المصافحة (auth.token)، أو كوكي access_token، أو مفتاح API. يحتاج مفتاح API المحدود بالنطاق إلى read وinbox.
تصل الأحداث كرسائل Socket.IO مسمّاة بدلاً من مغلف واحد: system.connected عندما يكون المقبس جاهزاً، ثم inbox.message لرسالة جديدة، وnotification.new، وaccount.power_changed، وبقية الأحداث. اشترك في تدفق حساب واحد بـ subscribe:account؛ يرفض الخادم الحسابات التي لا تملكها مساحة العمل الخاصة بك.
تُدفع الأحداث مباشرة عبر Redis pub/sub ولا يُعاد تشغيلها. العميل الذي كان غير متصل يفوّتها. للحاق بما فات، استخدم Webhooks (inbox.new_message وinbox.message_failed وinbox.read؛ موقّعة ويُعاد إرسالها) أو اجلب الرسائل الأحدث بـ GET /api/conversations/{id}/messages?after_msg_id=….
التعامل مع التعديل والحذف
عند تعديل رسالة على Telegram، يُستبدل النص المخزّن. لا يُحتفظ بسجل التعديلات.
عمليات الحذف لا تُنشَر. الرسالة المحذوفة على Telegram تبقى في صندوق الوارد.
المرفقات
الملفات التي ترفعها عبر صندوق الوارد تُخزَّن في تخزين كائنات متوافق مع S3 (MinIO).
| الخاصية | القيمة |
|---|---|
| خلفية التخزين | MinIO (متوافق مع S3) |
| الحد الأقصى لحجم الرفع | 20 MB لكل ملف |
| التنزيل | يُبث عبر API. لا روابط موقّعة مسبقاً. |
| الوسائط الواردة | لا تُنزَّل تلقائياً. تُجلب عند الطلب. |
تخزين الرسائل
يُخزَّن نص الرسائل كنص عادي في قاعدة البيانات. وهو غير مشفّر أثناء التخزين.
محادثة رمز الدخول للإيجارات
تحمل الرسائل من محادثة خدمة Telegram (معرّف النظير 777000) رموز الدخول ورموز استعادة التحقق بخطوتين وتأكيدات الجلسات. تُخزَّن مثل أي رسالة أخرى، لكنها تُخفى للحسابات المستأجرة وقت الاستعلام: لا يعيدها صندوق الوارد. 777000 موجود في قائمة النظراء المخفيين افتراضياً.
لماذا هذا مهم: محادثة 777000 هي حيث يرسل Telegram رموز الدخول لمرة واحدة. لو استطاع حامل الإيجار رؤيتها، لأمكنه المصادقة بصفته مالك رقم الهاتف الأساسي من عميل Telegram آخر، ما يكسر نموذج عزل الإيجار. إخفاء هذه الرسائل حدٌّ أساسي للخصوصية والأمان.
الاحتفاظ بصندوق الوارد
يُحتفظ بالرسائل في صندوق الوارد الموحّد طوال عمر الحساب المرتبط بها. عند تحرير حساب (انتهاء الاشتراك + فترة السماح)، تُحذف كل رسائل ذلك الحساب نهائياً. لا توجد فترة احتفاظ منفصلة خاصة بصندوق الوارد.