آنالیتیکس
آنالیتیکس TelegramOS واقعاً چه چیزی را می‌سنجد: رخدادهای پیام ارسالی و دریافتی برای هر اکانت، رفتار سوییچ حریم خصوصی هر کاربر، بینش‌های AI، خروجی‌ها و مدت نگهداری.
آنالیتیکس از یک جریان رخداد ساخته می‌شود: هر پیامی که اکانت‌های شما می‌فرستند و هر پیام گفتگویی که دریافت می‌کنند، به‌صورت یک ردیف account_events در ClickHouse نوشته می‌شود. صفحه‌ی آنالیتیکس، کارت‌های داشبورد و شمارنده‌های هر اکانت همگی همان جدول را می‌خوانند. آنالیتیکس به پلنی با قابلیت analytics نیاز دارد (همه‌ی پلن‌های پولی و دوره‌ی آزمایشی).
چه چیزی ردیابی می‌شود
| رخداد | صادرکننده | متادیتای استفاده‌شده |
|---|---|---|
message_sent | Worker، در هر ارسال خروجی | نوع طرف مقابل (user، bot، group، channel)؛ kind = reply یا forward |
message_received | شنونده‌ی پیام، برای چت‌های خصوصی و پیام‌های گروهی که به اکانت پاسخ می‌دهند یا آن را منشن می‌کنند | نوع طرف مقابل، is_reply، is_mention، media_type |
group_join | Worker، وقتی یک تسک عضویت موفق می‌شود | به‌عنوان «گروه‌های عضوشده» شمرده می‌شود |
error | Worker، در خطاها | ردیف‌های حاوی flood به‌عنوان flood wait شمرده می‌شوند |
پاسخ‌های پروب سلامت SpamBot تلگرام از همه‌ی شمارش‌ها کنار گذاشته می‌شوند. هیچ‌چیزی درباره‌ی زمان پاسخ، طول گفتگو، استفاده از دستورهای بات یا ری‌اکشن‌ها ثبت نمی‌شود؛ فیلد reactions_given در API همیشه 0 است.
داشبورد
یک بازه‌ی 7، 14، 30 یا 90 روزه انتخاب کنید. هر بلوک بازه را با بازه‌ی بلافاصله قبل از آن مقایسه می‌کند.
- کارت‌های اصلی: پیام‌های ارسالی، پیام‌های دریافتی، اکانت‌های فعال (اکانت‌هایی با حداقل یک رخداد) و نسبت پاسخ (دریافتی تقسیم بر ارسالی)، هر کدام با درصد تغییر.
- حجم پیام: ارسالی و دریافتی روزانه.
- پیام‌ها به کجا می‌روند: ارسالی و دریافتی بر اساس نوع طرف مقابل.
- ترکیب خروجی: ارسال‌های معمولی، reply و forward.
- مدیای ورودی: پیام‌های دریافتی بر اساس نوع مدیا.
- فعالیت بر اساس ساعت: 24 بازه‌ی UTC.
- خط زمانی اسپم و سلامت اکانت: برای هر اکانت یا سراسر ناوگان، تا 180 روز. پیام‌ها و flood waitها از ClickHouse می‌آیند؛ امتیاز سلامت همان اسنپ‌شات ساعتی در
account_health_logاست (بعد از 90 روز پاک می‌شود) و وضعیت اسپم همان حکم روزانه‌ی SpamBot است. خط‌های سلامت و اسپم از زمانی شروع می‌شوند که لاگ‌گیری برای آن اکانت آغاز شده باشد. - اکانت‌های برتر: ده اکانت پرکار در بازه.
- بینش‌های AI: دکمه‌ای که یک خلاصه‌ی نوشتاری درخواست می‌کند (پایین‌تر را ببینید).
Export CSV گزارش روی صفحه (مجموع‌ها، تغییرات، ترکیب، توزیع طرف مقابل، مدیا، فعالیت ساعتی، اکانت‌های برتر) را در مرورگر در یک فایل می‌نویسد. خروجی زمان‌بندی‌شده و خروجی رخدادهای خام وجود ندارد.
صفحه‌ی اکانت‌ها شمارش ارسالی و دریافتی امروز و گروه‌های عضوشده را برای هر اکانت نشان می‌دهد که از همان جدول خوانده و 60 ثانیه کش می‌شوند.
سوییچ حریم خصوصی
Settings > Privacy > Message analytics یک پرچم برای هر کاربر است (analytics_enabled، به‌طور پیش‌فرض روشن).
| وضعیت | اثر |
|---|---|
| روشن | همه‌ی endpointهای بالا داده برمی‌گردانند |
| خاموش | /analytics/summary صفر با analytics_enabled: false برمی‌گرداند، /analytics/report فقط analytics_enabled: false برمی‌گرداند، /analytics/daily، /analytics/velocity، /analytics/anomalies و خط‌های زمانی خالی برمی‌گردانند، و /analytics/ai/summary یک خلاصه‌ی خالی با یک یادداشت برمی‌گرداند. صفحه پیام «Analytics is disabled for your account.» را نشان می‌دهد |
خاموش‌کردن سوییچ خواندن را متوقف می‌کند، نه نوشتن را: رخدادها همچنان دریافت می‌شوند، هیچ‌چیزی ناشناس یا حذف نمی‌شود، و روشن‌کردن دوباره‌ی آن تاریخچه‌ی کامل را نشان می‌دهد. اگر پرچم به دلیل خطای پایگاه داده قابل خواندن نباشد، آنالیتیکس چنان رفتار می‌کند که گویی خاموش است.
برای تیم‌ها، سوییچ مالک بر داده‌ی مالک حاکم است: عضوی با analytics:read آنالیتیکس یک تیم را فقط تا زمانی می‌بیند که مالک آن تیم سوییچ را روشن داشته باشد.
بینش‌های AI
قابلیت‌های AI با یک پرچم سراسری در سطح deployment به نام AI_ENABLED کنترل می‌شوند.
- خاموش: Generate insights یک خلاصه‌ی آماری برمی‌گرداند که از همان سیگنال‌های هفته‌به‌هفته محاسبه شده است (روند، اکانت‌های پرت، یک بررسی ناهنجاری حجم). هیچ مدلی فراخوانی نمی‌شود.
- روشن: سیگنال‌ها به مدل پیکربندی‌شده فرستاده می‌شوند و پاسخ نمایش داده می‌شود. اگر فراخوانی شکست بخورد، به‌جای آن خلاصه‌ی آماری برگردانده می‌شود.
وقتی مدل روشن است، اقدامات AI از یک سهمیه‌ی ماهانه‌ی مخصوص هر پلن کم می‌شوند (Free 10، Starter 500، Growth 5,000، Agency نامحدود؛ قابل پیکربندی در سطح deployment). سایر endpointهای AI (خلاصه‌ی گفتگو، پیشنهاد پاسخ، احساسات، ریسک ارسال، تنوع قالب، خلاصه‌ی روزانه) درخواستی هستند و از همان سهمیه کم می‌شوند. هیچ پیام ورودی توسط مدل تحلیل نمی‌شود مگر اینکه خودتان آن را راه‌اندازی کنید.
مدت نگهداری
| داده | مدت نگهداری |
|---|---|
account_events (همه‌ی رخدادهای پیام و خطا) | 2 سال، سپس با TTL ClickHouse حذف می‌شود |
| رخدادهای ناهنجاری | 90 روز |
| اسنپ‌شات‌های سلامت اکانت (Postgres) | 90 روز |
| رخدادهای سایت بازاریابی (ناشناس) | 12 ماه |
محدودیت‌های API
- بازه‌ی تاریخ درخواستی حداکثر می‌تواند 366 روز باشد.
- دانه‌بندی ساعتی در
/analytics/dailyبه یک بازه‌ی 7 روزه محدود است. - خط‌های زمانی 1 تا 180 روز می‌پذیرند؛ ناهنجاری‌ها 1 تا 30 روز؛ velocity 1 تا 168 ساعت.