تیم‌ها
فضای کاری TelegramOS خود را با چهار نقش رتبه‌بندی‌شده، بازنویسی دسترسی برای هر عضو و یک لاگ ممیزی فقط‌افزودنی با هم‌تیمی‌ها به اشتراک بگذارید.
تیم یک فضای کاری مشترک است. اعضا روی اکانت‌ها، اینباکس، اتوماسیون، بات‌ها و آنالیتیکس مالک تیم، در حد آنچه نقش‌شان اجازه می‌دهد، کار می‌کنند؛ بدون آنکه لاگین مالک به اشتراک گذاشته شود. تیم‌ها از مسیر Settings > Team مدیریت می‌شوند.
ساخت تیم و دعوت اعضا به پلنی با قابلیت team نیاز دارد (Growth و Agency؛ دوره‌ی آزمایشی 7 روزه هم آن را شامل می‌شود). اعضا می‌توانند روی هر پلنی باشند، از جمله Free. فهرست‌کردن اعضا، تغییر نقش و خروج از تیم هیچ‌وقت به پلن وابسته نیست.
نقش‌ها
نقش‌ها رتبه‌بندی شده‌اند: viewer < operator < admin < owner. هر نقش یک مجموعه‌ی دسترسی پیش‌فرض ثابت دارد.
| نقش | دسترسی‌های پیش‌فرض |
|---|---|
| Owner | همه‌چیز، از جمله team:settings:write و billing:manage |
| Admin | اکانت‌ها read/write/delete، تسک‌ها read/run/write/delete، اینباکس read/reply، آنالیتیکس، بات‌ها read/write، اعضا read/invite/remove/update، خواندن لاگ ممیزی، خواندن صورت‌حساب |
| Operator | اکانت‌ها read، تسک‌ها read/run، اینباکس read/reply، آنالیتیکس read، بات‌ها read، اعضا read |
| Viewer | اکانت‌ها read، تسک‌ها read، اینباکس read، آنالیتیکس read، بات‌ها read، اعضا read |
قواعد رتبه
- کاربری که owner نیست فقط می‌تواند نقش‌هایی را اختصاص دهد که به‌طور قطعی پایین‌تر از نقش خودش هستند، و فقط می‌تواند اعضای پایین‌تر از رتبه‌ی خودش را تغییر دهد یا حذف کند. بنابراین adminها operatorها و viewerها را مدیریت می‌کنند، نه adminهای دیگر را.
- Owner می‌تواند هر نقشی را اختصاص دهد، از جمله
owner. انتقال مالکیت دقیقاً همین است: یک عضو را به owner ارتقا دهید. مالک قبلی نقش owner را تا زمانی که کسی آن را تغییر دهد نگه می‌دارد، پس یک تیم می‌تواند بیش از یک owner داشته باشد. - آخرین owner باقی‌مانده را نمی‌توان تنزل داد.
- Owner را نمی‌توان حذف کرد و نمی‌تواند تیم را ترک کند. هر عضو دیگری می‌تواند از Settings > Team خارج شود.
- نام تیم از Settings > Team > Manage (آیکون مداد کنار نام) قابل تغییر است. تغییر نام به
team:settings:writeو نقش owner یا admin نیاز دارد: owner این کلید را به‌طور پیش‌فرض دارد و admin باید آن را به‌صورت override دریافت کند. نام باید بین ۱ تا ۱۰۰ نویسه باشد. تیم قابل حذف نیست و توضیحات آن قابل ویرایش نیست. - تغییرات تیم به 30 بار در دقیقه برای هر کاربر محدود شده‌اند.
بازنویسی دسترسی برای هر عضو
هر عضو یک نقشه از کلید دسترسی به true/false با خود دارد. بازنویسی بر پیش‌فرض نقش اولویت دارد، پس می‌توانید به یک viewer دسترسی inbox:reply بدهید یا accounts:delete را از یک admin بگیرید. Settings > Team > Manage را باز کنید، یک عضو را گسترش دهید و از کلیدهای تغییر وضعیت استفاده کنید.
فقط دسترسی‌هایی را می‌توانید اعطا کنید که خودتان دارید. مجموعه‌ی کامل کلیدها:
| گروه | کلیدها |
|---|---|
| اکانت‌ها | accounts:read، accounts:write، accounts:delete |
| تسک‌ها | tasks:read، tasks:run، tasks:write، tasks:delete |
| اینباکس | inbox:read، inbox:reply |
| آنالیتیکس | analytics:read |
| بات‌ها | bots:read، bots:write |
| تیم | team:members:read، team:members:invite، team:members:remove، team:members:update، team:settings:write |
| ممیزی | audit:logs:read |
| صورت‌حساب | billing:read، billing:manage |
دعوت اعضا
- Settings > Team > Manage > Invite member.
- ایمیل هم‌تیمی را وارد کنید و یک نقش انتخاب کنید (viewer، operator یا admin).
- ایمیل باید متعلق به یک کاربر موجود TelegramOS باشد. اگر نباشد، درخواست با پیام «No user with that email. They must sign up first.» رد می‌شود.
- عضو فوراً اضافه می‌شود و یک اعلان درون‌برنامه‌ای دریافت می‌کند. ایمیل دعوت، حالت در انتظار، چیزی برای پذیرفتن و چیزی که منقضی شود وجود ندارد.
دعوت‌کردن خودتان یا کسی که از قبل عضو است با خطا رد می‌شود.
اعضا چه می‌بینند
عضویت در تیم دامنه‌ی منابعی را که یک عضو می‌تواند روی آن‌ها عمل کند گسترش می‌دهد. اکانت‌ها، گفتگوها، قواعد پاسخ خودکار، بات‌ها، آنالیتیکس و نماهای صورت‌حساب هر تیمی که عضو آن هستید، کنار مواردِ خودتان نمایش داده می‌شوند و بر اساس دسترسی‌ای که هر endpoint لازم دارد فیلتر می‌شوند. سوییچر فضای کاری وجود ندارد؛ همیشه یک فهرست ادغام‌شده می‌بینید.
- آنالیتیکس یک تیم فقط تا زمانی قابل مشاهده است که مالک آن تیم آنالیتیکس پیام را فعال داشته باشد (ببینید آنالیتیکس).
- نماهای صورت‌حساب به
billing:readنیاز دارند؛ به‌طور پیش‌فرض فقط owner دسترسیbilling:manageرا دارد. - اکانت‌ها و کیف پول خودتان هیچ‌وقت برای تیم‌هایی که عضوشان هستید قابل مشاهده نیست.
لاگ ممیزی
Team-service برای team.create، team.rename (با نام قدیم و جدید)، team.member.invite، team.member.update (با نقش قدیم و جدید)، team.member.remove و team.member.leave یک ردیف فقط‌افزودنی در audit_logs می‌نویسد. هر ردیف شناسه‌ی کاربری و ایمیل عامل، تیم، منبع، متادیتای ساخت‌یافته، IP کلاینت، user agent و یک برچسب زمانی UTC را ذخیره می‌کند.
- آن را با
GET /audit/logs?team_id=…بخوانید (بهaudit:logs:readنیاز دارد که به‌طور پیش‌فرض ownerها و adminها آن را دارند). بدونteam_idاقدامات خودتان را می‌گیرید. فیلترها:action،resource_type،limit(حداکثر 200)،offset. - صفحه‌ی ممیزی در داشبورد و خروجی CSV وجود ندارد.
- ردیف‌ها هیچ‌وقت حذف یا به‌روزرسانی نمی‌شوند: یک trigger پایگاه داده
UPDATE،DELETEوTRUNCATEرا رد می‌کند. سطح‌بندی مدت نگهداری وجود ندارد. - سرویس‌های دیگر (اکانت‌ها، پروکسی‌ها، کمپین‌ها) لاگ‌های خودشان را نگه می‌دارند و در این جدول نمی‌نویسند.