الفرق

شارك مساحة عمل TelegramOS مع زملائك باستخدام أربعة أدوار مرتّبة، وتجاوزات صلاحيات لكل عضو، وسجل تدقيق للإضافة فقط.

الفريق هو مساحة عمل مشتركة. يعمل الأعضاء على حسابات مالك الفريق وصندوق الوارد والأتمتة والبوتات والتحليلات بما يسمح به دورهم، دون مشاركة بيانات دخول المالك. تُدار الفرق من الإعدادات > الفريق.

يتطلب إنشاء فريق ودعوة الأعضاء خطة تتضمن قدرة team (Growth وAgency؛ والفترة التجريبية لمدة 7 أيام تتضمنها). يمكن أن يكون الأعضاء على أي خطة، بما فيها Free. أما عرض الأعضاء وتغيير الأدوار ومغادرة الفريق فلا تخضع أبدًا لقيود الخطة.

الأدوار

الأدوار مرتّبة: viewer < operator < admin < owner. ولكل دور مجموعة صلاحيات افتراضية ثابتة.

قواعد الترتيب

• لا يمكن لغير المالك إلا تعيين أدوار أدنى من دوره بشكل صريح، ولا يمكنه تغيير أو إزالة سوى الأعضاء الأدنى منه رتبةً. وبالتالي يدير المشرفون (admins) المشغّلين والمشاهدين، لا المشرفين الآخرين.
• يمكن للمالك تعيين أي دور، بما في ذلك owner. ونقل الملكية هو تحديدًا ذلك: ترقية عضو إلى مالك. يحتفظ المالك السابق بدور المالك حتى يغيّره أحد، لذا يمكن أن يكون للفريق أكثر من مالك واحد.
• لا يمكن تخفيض رتبة آخر مالك متبقٍ.
• لا يمكن إزالة المالك ولا يمكنه مغادرة الفريق. أما كل عضو آخر فيمكنه المغادرة من الإعدادات > الفريق.
• يمكن إعادة تسمية الفريق من Settings > Team > Manage (أيقونة القلم بجانب الاسم). تتطلب إعادة التسمية team:settings:write ودور owner أو admin: يملك owner هذا المفتاح افتراضيًا، أما admin فيحتاج إلى منحه إياه كاستثناء. يتراوح طول الاسم بين 1 و100 حرف. لا يمكن حذف الفريق ولا تعديل وصفه.
• تعديلات الفريق محدودة بمعدل 30 عملية في الدقيقة لكل مستخدم.

تجاوزات لكل عضو

يحمل كل عضو خريطة من مفتاح الصلاحية إلى true/false. التجاوز له الأولوية على الافتراضي الخاص بالدور، لذا يمكنك منح مشاهد (viewer) صلاحية inbox:reply أو سحب accounts:delete من مشرف (admin). افتح الإعدادات > الفريق > إدارة، ووسّع عضوًا واستخدم مفاتيح التبديل.

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

دعوة الأعضاء

1. الإعدادات > الفريق > إدارة > دعوة عضو.
2. أدخل البريد الإلكتروني للزميل واختر دورًا (viewer أو operator أو admin).
3. يجب أن يكون البريد الإلكتروني تابعًا لمستخدم موجود في TelegramOS. وإن لم يكن كذلك، يفشل الطلب برسالة "No user with that email. They must sign up first."
4. يُضاف العضو فورًا ويتلقى إشعارًا داخل التطبيق. لا يوجد بريد دعوة، ولا حالة انتظار، ولا شيء يجب قبوله، ولا شيء تنتهي صلاحيته.

تفشل دعوة نفسك أو دعوة شخص هو عضو بالفعل.

ما يراه الأعضاء

تُوسّع عضوية الفريق الموارد التي يمكن للعضو التصرف فيها. تظهر الحسابات والمحادثات وقواعد الرد الآلي والبوتات والتحليلات وعروض الفوترة لكل فريق تنتمي إليه جنبًا إلى جنب مع مواردك الخاصة، مُرشّحةً بحسب الصلاحية التي تتطلبها كل نقطة نهاية. لا يوجد مبدّل لمساحات العمل؛ ترى دائمًا قائمة واحدة مدمجة.

• تكون تحليلات الفريق مرئية فقط ما دام مالك ذلك الفريق مفعّلًا لتحليلات الرسائل (انظر التحليلات).
• تتطلب عروض الفوترة billing:read؛ والمالك وحده يملك billing:manage افتراضيًا.
• حساباتك ومحفظتك الخاصة لا تكون مرئية أبدًا للفرق التي أنت عضو فيها.

سجل التدقيق

تكتب خدمة الفريق صفًا في audit_logs (للإضافة فقط) عند team.create وteam.rename (مع الاسم القديم والجديد) وteam.member.invite وteam.member.update (مع الدور القديم والجديد) وteam.member.remove وteam.member.leave. يخزّن كل صف معرّف المستخدم الفاعل وبريده الإلكتروني، والفريق، والمورد، وبيانات وصفية منظّمة، وعنوان IP للعميل، ووكيل المستخدم (user agent)، وطابعًا زمنيًا بتوقيت UTC.

• اقرأه عبر GET /audit/logs?team_id=… (يتطلب audit:logs:read، الذي يملكه المالكون والمشرفون افتراضيًا). بدون team_id تحصل على إجراءاتك أنت فقط. عوامل التصفية: action وresource_type وlimit (الحد الأقصى 200) وoffset.
• لا توجد صفحة تدقيق في لوحة التحكم ولا تصدير CSV.
• لا تُحذف الصفوف ولا تُحدَّث أبدًا: يرفض مشغّل (trigger) في قاعدة البيانات عمليات UPDATE وDELETE وTRUNCATE. ولا توجد مستويات لمدة الاحتفاظ.
• تحتفظ الخدمات الأخرى (الحسابات، البروكسيات، الحملات) بسجلاتها الخاصة ولا تكتب في هذا الجدول.