رفتن به محتوای اصلی

اتوماسیون

خودکارسازی کار تلگرام در TelegramOS: تسک‌ها، کمپین‌ها و فلوها با زمان‌بندی داخلی و حفاظ‌های ضدبن.

اتوماسیون هسته‌ی پلتفرم است. می‌توانید پیام‌ها را زمان‌بندی کنید، کمپین‌های چندمرحله‌ای بسازید و قواعد پاسخ خودکار تنظیم کنید. همه با زمان‌بندی ضدبن که از اکانت‌هایتان محافظت می‌کند.

سه عنصر پایه

عنصر پایهدامنهماندگاری
تسکاقدام یک‌باره روی یک هدف واحدیک بار اجرا می‌شود، سپس آرشیو می‌شود
کمپینتوالی چندمرحله‌ای روی چند هدفتا تکمیل همه‌ی مراحل یا لغو توسط شما باقی می‌ماند
فلوقاعده‌ی تکرارشونده یا رویدادمحورتا زمانی که متوقف یا حذف شود، نامحدود اجرا می‌شود

انواع تسک

نوعتوضیح
send_dmارسال پیام مستقیم به یک کاربر
send_groupارسال پیام به یک گروه یا کانال
join_groupعضویت در یک گروه تلگرام با لینک دعوت
leave_groupترک یک گروه تلگرام
reactواکنش به یک پیام با ایموجی
forwardفوروارد یک پیام از یک چت به چت دیگر
schedule_broadcastزمان‌بندی یک broadcast برای چند گیرنده

برنامه‌ی گرم‌کردن

هر اکانت جدید در وضعیت warming شروع می‌کند و می‌تواند بلافاصله با یک بودجه‌ی ساعتی کوچک ارسال کند. بودجه با گذشت روزها از شروع گرم‌کردن (warm-up) پله‌پله بالا می‌رود و بعد از روز 5، اکانت به‌طور خودکار به active ارتقا می‌یابد:

مرحلهروزهابودجه‌ی ساعتی
starter03
light18
moderate2-315
pre-active4-525
activeبعد از روز 530

اکانت‌های اجاره‌ای پیشرفت گرم‌کردنی را که در استخر (pool) داشته‌اند نگه می‌دارند: اکانتی که آنجا از قبل active بوده، active تحویل داده می‌شود و اکانتی که هنوز در حال گرم‌شدن است از همان‌جا ادامه می‌دهد.

رد کردن و پس‌رفت. POST /api/accounts/{id}/skip-warmup گرم‌کردن را با عقب‌بردن ساعتش زودتر تمام می‌کند: برای اکانت‌های شخصی هر زمان، برای اکانت‌های اجاره‌ای بعد از 3 روز. اکانت warming که به flood wait بخورد یک مرحله عقب می‌رود (ساعتش حدود 1.5 روز جلوتر می‌رود).

حفاظ‌های ضدبن

زمان‌بندی انسان‌گونه

هر اقدام پیش از اجرا یک تأخیر تصادفی و انسان‌گونه صبر می‌کند: ارسال 3-8 ثانیه، پاسخ 2-6 ثانیه، فوروارد 4-10 ثانیه، پاسخ خودکار 2-8 ثانیه، عضویت 5-15 ثانیه. تا وقتی اکانت active نیست، این تأخیر 2.5 برابر طولانی‌تر است.

کمپین‌ها هدف‌هایشان را هم پلکانی می‌کنند: فاصله‌ی بین یک هدف و هدف بعدی به‌صورت تصادفی از بازه‌ی 15-90 ثانیه انتخاب می‌شود. سپس هر چرخه‌ی کمپین بعد از interval_minutes خودش تکرار می‌شود، با یک جابه‌جایی ثابت به ازای هر اکانت. پیام انبوه (Mass DM) به‌طور پیش‌فرض بین پیام‌ها 45-120 ثانیه صبر می‌کند.

سقف سراسری 10 در ثانیه

پلتفرم در مجموع همه‌ی اکانت‌ها حداکثر 10 پیام در ثانیه ارسال می‌کند. این سقف روی همه‌ی انواع تسک (پیام مستقیم، گروه، broadcast) اعمال می‌شود.

تشخیص flood wait

وقتی تلگرام خطای FLOOD_WAIT برمی‌گرداند، runtime:

  1. مدت انتظار را از پاسخ خطا ثبت می‌کند.
  2. یک گیت flood wait روی اکانت می‌گذارد. وضعیت اکانت تغییر نمی‌کند. گیت برای اکانت‌های active به اندازه‌ی مدت انتظار به‌علاوه‌ی 1-5 ثانیه، برای اکانت‌های warming مدت انتظار × 2.5 به‌علاوه‌ی 30-90 ثانیه، و برای اکانت‌های آزمایشی مدت انتظار × 3 به‌علاوه‌ی 20-60 ثانیه طول می‌کشد، و هرگز کمتر از 60 ثانیه نیست.
  3. تسک ناموفق را به جای حذف، با زمان شروع دیرتر به صف برمی‌گرداند. سایر تسک‌های در صف اکانت پشت گیت منتظر می‌مانند.
  4. کمپین را برای مدتی از ساختن تسک جدید برای آن هدف باز می‌دارد.
  5. اکانت warming را یک مرحله‌ی گرم‌کردن عقب می‌برد.

مثال: تلگرام 420 ثانیه درخواست می‌کند. اکانت active حدود 421-425 ثانیه و اکانت warming حدود 1080-1140 ثانیه پشت گیت می‌ماند.

هر flood wait در 7 روز گذشته 15 امتیاز سلامت کم می‌کند، با سقف 45.

شکل 3. تأخیر انسانی و فاصلهٔ تصادفی بین هدف‌ها آهنگ هر ارسال را تعیین می‌کند؛ فلاد-ویت بدون تغییر وضعیت، جلوی اکانت دروازه می‌گذارد.

گیت امتیاز سلامت

اجرای اتوماسیون به امتیاز سلامت اکانت وابسته است (بازه‌ها در اکانت‌ها › امتیاز سلامت ترسیم شده‌اند):

  • 80-100: همه‌ی تسک‌ها، کمپین‌ها و فلوها به‌طور عادی اجرا می‌شوند.
  • 50-79: تسک‌های ارسال گروهی (bulk) جدید رد می‌شوند. پیام‌های مستقیم، پاسخ‌ها و پیام‌های گروهی بی‌تأثیر می‌مانند.
  • 25-49: تسک‌های ارسال گروهی و عضویت در گروه رد می‌شوند. پیام‌های مستقیم و پاسخ‌ها بی‌تأثیر.
  • 1-24: خروجی متوقف می‌شود. اتصال‌های موجود باز می‌مانند اما ارسال جدیدی تلاش نمی‌شود.
  • 0: اکانت معلق است. اتوماسیونی برای آن زمان‌بندی نمی‌شود.

قواعد پاسخ خودکار

قواعد پاسخ خودکار به شما اجازه می‌دهند پاسخ‌های خودکار برای پیام‌های مستقیم ورودی تعریف کنید. قواعد به ترتیب ارزیابی می‌شوند و فقط اولین قاعده‌ی منطبق اجرا می‌شود.

نوع تطابقتوضیحمثال
exactمتن پیام دقیقاً برابر با trigger است"Help" پاسخ را فعال می‌کند
containsمتن پیام شامل زیررشته‌ی trigger است"price" در "What is the price?" پاسخ را فعال می‌کند
regexمتن پیام با یک الگوی regex جاوااسکریپت منطبق است`/^(hihello)⁦/i⁩` پاسخ را فعال می‌کند
anyهر پیام مستقیم ورودی پاسخ را فعال می‌کندهمه‌گیر برای حالت خارج از دفتر

هر قاعده‌ی پاسخ خودکار این‌ها را دارد:

  • Trigger: الگوی تطابق (برای نوع any استفاده نمی‌شود)
  • نوع تطابق: یکی از exact، contains، regex، any
  • متن پاسخ: پیامی که برگردانده می‌شود (حداکثر 1000 نویسه)
  • Cooldown: پاسخ‌ها به ازای هر چت فاصله‌گذاری می‌شوند، نه به ازای هر فرستنده: 60 ثانیه برای قواعد ایستا، 12 ثانیه برای قواعد AI/connector. پیام‌هایی که در طول cooldown می‌رسند در پاسخ در انتظار ادغام می‌شوند، نه این‌که حذف شوند
  • فعال: کلید فعال یا غیرفعال‌کردن قاعده

سیاست استفاده‌ی قابل قبول برای اتوماسیون

اتوماسیون باید با شرایط خدمات تلگرام سازگار باشد. به‌طور مشخص:

  • ارسال پیام به افرادی که ابتدا خودشان به شما پیام نداده‌اند توسط پلتفرم محدود می‌شود. هر اکانت سقف ارسال ساعتی و روزانه دارد که برای تماس اول (به‌طور پیش‌فرض ۱۰ پیام در ساعت و ۴۰ پیام در روز) کمتر از پاسخ‌ها (به‌طور پیش‌فرض ۶۰ پیام در ساعت و ۳۰۰ پیام در روز) است. به هر مخاطب فقط یکی از اکانت‌های شما پیام می‌دهد، مگر اینکه این قاعده را برای یک اکانت خاموش کنید. در Mass DM، پیام اول فقط برای کسی ارسال می‌شود که با اکانت فرستنده گروه مشترک دارد، و گیرنده‌ای که با واژه‌ای مانند «stop» یا «لغو» پاسخ دهد به فهرست عدم ارسال شما افزوده می‌شود و در کارهای بعدی Mass DM کنار گذاشته می‌شود. اکانتی که تلگرام محدودش کرده است به حالت فقط‌پاسخ می‌رود و نمی‌تواند گفت‌وگوی تازه‌ای آغاز کند. این سقف‌ها را برای ارسال پیام انبوهی که گیرندگان نخواسته‌اند بالا نبرید یا خاموش نکنید.
  • عضویت در گروه‌ها را به قصد اسپم خودکار نکنید.
  • اسکرپر فقط پیام‌های گروه‌هایی را می‌خواند که لینک آن‌ها را وارد می‌کنید، حداکثر ۲۰۰ لینک در هر کار و ۳۰۰۰ پیام در هر گروه، و اطلاعات تماسی را که در همان پیام‌ها منتشر شده استخراج می‌کند. از سرویس برای گردآوری داده شخصی به هیچ روش دیگری استفاده نکنید. داشتن مبنای قانونی برای گردآوری و استفاده از این داده‌ها بر عهده شماست.
  • شبکه‌ای از اکانت‌ها را برای رفتار هماهنگ غیراصیل اداره نکنید.
  • محتوای غیرقانونی، بدافزار یا فیشینگ ارسال نکنید و از اتوماسیون برای کلاهبرداری، آزار یا جعل هویت هیچ‌کس استفاده نکنید.

نقض این سیاست می‌تواند به تعلیق اکانت و از دست رفتن موجودی اشتراک شما منجر شود.

گزارش مشکل در این صفحه
⁨اتوماسیون⁩ | مستندات TelegramOS