راهنمای کامل · نسخه 4.0

هر آنچه برای درک و استفاده نیاز دارید

از دانلود برنامه تا اجرای زنجیره‌ها، کمپین‌های پیام مستقیم و تحلیل‌ها. نوشته شده برای مبتدیان کامل — با مراحل دقیق و مثال‌های واقعی.

شروع کار
کار
تبلیغات و کمپین‌ها
تحلیل‌ها و سیستم
راهنما

شروع سریع

از صفر تا اولین ارسال خود در کمتر از ۱۰ دقیقه.

قبل از شروع به چه چیزی نیاز دارید

یک حساب تلگرام (یا چند حساب)، یک کامپیوتر با ویندوز ۱۰+ یا مک ۱۱+، و حدود ۱۰ دقیقه وقت آزاد.

1 برنامه را دانلود کنید

نصب‌کننده را از صفحه دانلود دریافت کنید:

  • ویندوز: .exe قابل حمل — بدون نیاز به نصب
  • مک: .dmg — برنامه را به Applications بکشید
2 لایسنس خود را فعال کنید

در اولین اجرا پنجره فعال‌سازی را خواهید دید. کلید خود را جای‌گذاری کنید و روی فعال‌سازی کلیک کنید. اگر هنوز کلیدی ندارید — یک نسخه آزمایشی رایگان ۳ روزه دریافت کنید.

3 اعتبارنامه API تلگرام را دریافت کنید

به my.telegram.org وارد شوید، یک برنامه ایجاد کنید و api_id و api_hash خود را کپی کنید. راهنمای کامل — در تب API تلگرام.

4 اولین حساب خود را اضافه کنید

به حساب‌ها → افزودن حساب بروید، نام، API ID، API Hash (شماره تلفن برای QR اختیاری است) را پر کنید. سپس روی مجاز کردن کلیک کنید و کد QR را با گوشی خود اسکن کنید.

5 گیرندگان را بارگیری کنید

گیرندگان → بازخوانی لیست را باز کنید تا گروه‌ها، کانال‌ها و مخاطبین تلگرام خود را بارگیری کنید. یا از یک فایل وارد کنید.

6 اولین تبلیغ خود را ایجاد کنید

تبلیغات → تبلیغ جدید را باز کنید، پیام خود را بنویسید، گیرندگان را انتخاب کنید، زمان‌بندی را تنظیم کنید — و روی شروع کلیک کنید.

شما تمام کردید!

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

دانلود و نصب

این برنامه در ویندوز قابل حمل و در مک با کشیدن و رها کردن است. بدون وابستگی، بدون نیاز به دسترسی مدیر.

ویندوز

1 فایل EXE را دانلود کنید

TelegramAutoPoster.exe (~۸۰ مگابایت) را در یک پوشه اختصاصی، به عنوان مثال C:\TelegramAutoPoster\ ذخیره کنید. در اولین اجرا، برنامه یک زیرپوشه data/ با تمام تنظیمات، نشست‌ها و گزارش‌ها در آنجا ایجاد می‌کند.

2 با SmartScreen مقابله کنید

ویندوز ممکن است یک پنجره آبی نشان دهد: "Windows protected your PC". این برای هر برنامه بدون امضای دیجیتال طبیعی است.

  1. روی More info کلیک کنید
  2. روی Run anyway کلیک کنید
چرا این اتفاق می‌افتد؟

ویندوز هر برنامه‌ای را که گواهی امضای کد پولی ندارد (معمولاً بیش از ۱۰۰ دلار در سال) علامت‌گذاری می‌کند. این برنامه کاملاً امن است — می‌توانید آن را در VirusTotal بررسی کنید.

مک

1 فایل DMG را دانلود کنید

TelegramAutoPoster.dmg را باز کنید و برنامه را به پوشه Applications خود بکشید.

2 اولین اجرا

روی آیکون برنامه کلیک راست کنید → Open → در پنجره امنیتی Open را تأیید کنید. یا به System Settings → Privacy & Security → Open Anyway بروید.

داده‌ها کجا زندگی می‌کنند

پلتفرممسیر
ویندوز<folder with EXE>/data/
مک~/Library/Application Support/TG AutoPoster Pro/
نکته: یک میانبر دسکتاپ ایجاد کنید

روی EXE کلیک راست کنید → Send to → Desktop (create shortcut). در مک برنامه را به Dock بکشید.

راه‌اندازی API تلگرام

هر کلاینت تلگرام به api_id و api_hash نیاز دارد — اعتبارنامه‌های رسمی و رایگان از تلگرام. دریافت آن‌ها حدود ۳ دقیقه طول می‌کشد.

API ID و API Hash چیستند؟

آن‌ها اساساً یک "ورود توسعه‌دهنده" برای تلگرام هستند. هر برنامه شخص ثالث جفت خود را دارد. جفت شما فقط به حساب شما متصل می‌شود و امن است.

1 my.telegram.org را باز کنید

در مرورگر خود به https://my.telegram.org بروید.

2 با شماره تلفن خود وارد شوید

شماره را با فرمت بین‌المللی و با شروع + وارد کنید — به عنوان مثال +12025550100. تلگرام یک کد تأیید به برنامه یا از طریق پیامک ارسال می‌کند.

3 API Development Tools را باز کنید

در داشبورد روی API development tools کلیک کنید.

4 یک برنامه ایجاد کنید

فرم را پر کنید — مقادیر اصلاً مهم نیستند، تلگرام آن‌ها را فقط برای سوابق خود ذخیره می‌کند. پلتفرم Desktop را انتخاب کنید و روی Create application کلیک کنید.

5 اعتبارنامه‌های خود را کپی کنید

دو مقدار خواهید دید:

  • App api_id — یک عدد مانند 1234567
  • App api_hash — یک رشته ۳۲ کاراکتری مانند abcdef1234567890abcdef1234567890
این‌ها را خصوصی نگه دارید

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

آیا می‌توانم از همان اعتبارنامه‌ها برای چندین حساب استفاده کنم؟

بله. اعتبارنامه‌های API متعلق به یک برنامه هستند، نه یک کاربر خاص تلگرام. با همان api_id/api_hash هر تعداد حساب که می‌خواهید اضافه کنید — هر کدام نشست خود را خواهد داشت.

اگر api_id / api_hash خود را گم کردم چه؟

دوباره وارد my.telegram.org شوید و API development tools را باز کنید. برنامه موجود شما هنوز آنجاست — می‌توانید هر زمان مقادیر را کپی کنید.

تلگرام می‌گوید "too many attempts" — چه کار کنم؟

۲۴ ساعت صبر کنید. این اتفاق اگر چندین برنامه ایجاد کرده باشید یا خیلی اوقات وارد/خارج شده باشید رخ می‌دهد. این محدودیت به طور خودکار بازنشانی می‌شود.

فعال‌سازی و طرح‌ها

سه طرح، یک پنجره فعال‌سازی. هر زمان با وارد کردن کلید جدید تغییر دهید.

طرح‌ها در یک نگاه

طرححساب‌هاموارد اضافی کلیدی
Standard — ۵ دلار در ماه۱کمپین‌های پیام مستقیم، زنجیره‌ها، چرخش، تحلیل‌ها، بررسی نشست
Enterprise — ۱۰ دلار در ماهنامحدود+ پاسخ خودکار، شروع/توقف انبوه، استوری‌ها، مانیتور سلامت، پشتیبان‌گیری
Supporter — ۱۹.۹۹ دلار در ماهنامحدود+ پشتیبانی با اولویت، اعتبارات برنامه، دسترسی زودهنگام به بتای ابری
نسخه آزمایشی رایگان چه چیزی را شامل می‌شود؟

تمام ویژگی‌های سطح استاندارد برای ۳ روز کامل. چند حسابی، پاسخ خودکار، کمپین‌های استوری و عملیات انبوه مخصوص Enterprise هستند و در نسخه آزمایشی گنجانده نشده‌اند.

فعال‌سازی یک کلید

1 روی دکمه فعال‌سازی کلیک کنید

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

2 کلید را جای‌گذاری کنید

کلیدها شبیه XXXX-XXXX-XXXX-XXXX هستند. آن را جای‌گذاری کنید و Enter را فشار دهید یا روی فعال‌سازی کلیک کنید.

3 برنامه به طور خودکار راه‌اندازی مجدد می‌شود

در صورت فعال‌سازی موفق، وضعیت لایسنس فوراً به‌روزرسانی می‌شود و برنامه دوباره بارگیری می‌شود.

دوره مهلت آفلاین

برنامه هر ۶ ساعت لایسنس را بررسی می‌کند. اگر مشکل شبکه وجود داشته باشد، تا ۳۰ روز از وضعیت کش شده (تا آخرین تاریخ پایان تأیید شده) به کار خود ادامه می‌دهد. یک نشان آفلاین خاکستری روی کارت لایسنس خواهید دید، اما هیچ عملکردی از دست نمی‌رود.

کجا وضعیت را ببینیم

  • کارت نوار کناری — نام طرح، روزهای باقی‌مانده، تاریخ پایان
  • تنظیمات → لایسنس — همان اطلاعات در صفحه تنظیمات
  • بنر بالا — اگر لایسنس وجود نداشته باشد یا منقضی شده باشد قابل مشاهده است

حساب‌ها

صفحه حساب‌ها پایگاه اصلی شماست. هر چیز دیگری — گیرندگان، تبلیغات، کمپین‌ها — متعلق به حساب انتخاب شده فعلی است.

شبکه حساب

هر حساب یک کارت است که نشان می‌دهد:

  • نام و نشان اولیه
  • وضعیت — مجاز (سبز) یا غیرمجاز (خاکستری)
  • اطلاعات کاربر — نام نمایشی و @username تلگرام
  • تلفن، پروکسی، و وضعیت نشست فعلی

حسابی که در حال حاضر با آن کار می‌کنید با یک حاشیه بنفش و نشان CURRENT در گوشه بالا سمت چپ مشخص شده است.

نوار ابزار

دکمهچه کاری انجام می‌دهد
بازخوانیلیست حساب‌ها را از پایگاه داده محلی دوباره می‌خواند.
بررسی نشست‌هایک بررسی سلامت نشست را در همه حساب‌ها اجرا می‌کند (به بخش اختصاصی زیر مراجعه کنید).
افزودن حسابویرایشگر را برای یک حساب جدید باز می‌کند. اگر به محدودیت طرح خود رسیده‌اید غیرفعال است.
شمارنده (مثلاً 2 / 5)تعداد حساب‌های موجود در طرح فعلی. هنگام نزدیک شدن به محدودیت نارنجی می‌شود.

اقدامات کارت

اقدامتوضیحات
انتخاب به عنوان فعلیکل رابط کاربری را به این حساب تغییر می‌دهد. فقط در کارت‌های غیر فعلی قابل مشاهده است.
سلامت (آیکون سپر)پنجره سلامت حساب را باز می‌کند — به بخش اختصاصی زیر مراجعه کنید.
مجاز کردن / احراز هویت مجددجریان ورود QR/SMS را برای این حساب شروع می‌کند.
ویرایشنام، اعتبارنامه API، تلفن یا پروکسی را تغییر دهید. ویرایش اعتبارنامه‌ها نیاز به احراز هویت مجدد دارد.
حذف (آیکون سطل زباله)حساب و فایل نشست آن را برای همیشه حذف می‌کند. تبلیغات، گیرندگان و کمپین‌های این حساب نیز از پایگاه داده حذف می‌شوند.
غیرمجاز کردن ≠ حذف

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

افزودن یک حساب جدید

1 روی "افزودن حساب" کلیک کنید

پر کنید:

  • نام — هر برچسبی مانند "اصلی" یا "کار"
  • API ID، API Hash — از my.telegram.org
  • تلفن — اگر قصد دارید از طریق QR وارد شوید اختیاری است
  • پروکسی — پروکسی اختیاری برای هر حساب
2 ذخیره و مجاز کردن

روی ذخیره کلیک کنید. یک پنجره تأیید ظاهر می‌شود که پیشنهاد می‌دهد فوراً مجاز کنید — روی مجاز کردن کلیک کنید.

پروکسی برای هر حساب

برای چندین حساب، از یک پروکسی متفاوت برای هر کدام استفاده کنید. این یکی از قوی‌ترین سیگنال‌ها به تلگرام است که حساب‌های شما نامرتبط هستند و خطر مسدود شدن را به شدت کاهش می‌دهد.

احراز هویت QR / پیامک

دو روش. QR سریع‌تر است و به فیلد تلفن نیاز ندارد — پیامک یک جایگزین است.

انتخاب یک روش

روی مجاز کردن روی هر حسابی کلیک کنید. یک پنجره با دو گزینه باز می‌شود:

  • کد QR — توصیه می‌شود. فقط به API ID + API Hash نیاز دارد.
  • کد پیامک — به یک شماره تلفن در تنظیمات حساب نیاز دارد.

اگر تلفن خالی باشد، گزینه پیامک با یک راهنما غیرفعال است.

ورود با QR

1 یک پنجره QR باز می‌شود

روی گوشی خود، تلگرام را باز کنید → Settings → Devices → Scan QR.

2 کد QR را اسکن کنید

دوربین را به کد روی صفحه خود بگیرید. پنجره به طور خودکار بسته می‌شود.

3 درخواست دو مرحله‌ای (در صورت فعال بودن)

اگر 2FA را فعال کرده‌اید، در مرحله بعد یک درخواست رمز عبور ظاهر می‌شود. رمز عبور ابری خود را تایپ کنید.

زمان انقضای QR

کد QR به مدت ۱۸۰ ثانیه معتبر است. اگر منقضی شد، لغو کنید و دوباره امتحان کنید — یک کد جدید تولید می‌شود.

ورود با پیامک

1 "کد پیامک" را انتخاب کنید و روی شروع کلیک کنید

تلگرام یک کد به برنامه شما (یا از طریق پیامک) ارسال می‌کند. پنجره‌ای ظاهر می‌شود که کد را می‌خواهد.

2 کد را وارد کنید

کد ۵ رقمی را تایپ کنید و Enter را فشار دهید. اگر 2FA فعال باشد، بلافاصله یک درخواست رمز عبور دریافت خواهید کرد.

QR اسکن نمی‌شود — چه کار کنم؟

مطمئن شوید که گوشی شما به اینترنت دسترسی دارد و تلگرام به‌روز است. اگر پروکسی تنظیم شده است — آن را با تست پروکسی در تنظیمات تأیید کنید. گاهی اوقات تلگرام موقتاً تولید QR را محدود می‌کند؛ ۵ دقیقه صبر کنید و دوباره امتحان کنید.

نشست کجا ذخیره می‌شود؟

در data/sessions/session_<account_id>.session در کنار EXE. این فایلی است که شما را وارد سیستم نگه می‌دارد — تا زمانی که تلگرام نشست را لغو نکند، نیازی به اسکن مجدد نیست.

نشست روی گوشی من لغو شد — چه اتفاقی می‌افتد؟

بررسی بعدی نشست این حساب را به عنوان مرده (🔴) علامت‌گذاری می‌کند. فقط دوباره روی مجاز کردن کلیک کنید — یا از صف احراز هویت مجدد خودکار که در بخش بررسی سلامت نشست توضیح داده شده استفاده کنید.

بررسی سلامت نشست v4.0

برنامه نشست‌های تلگرام شما را بدون اینکه مجبور باشید از آن‌ها نگهداری کنید زنده نگه می‌دارد.

چرا این مهم است

نشست‌های تلگرام می‌توانند هر لحظه بمیرند — اگر کسی از دستگاه دیگری وارد شود، نشست‌ها را بازنشانی کند یا حساب مسدود شود. قبلاً در اواسط کمپین متوجه می‌شدید. اکنون برنامه همه چیز را از قبل بررسی می‌کند — در زمان راه‌اندازی و طبق یک برنامه زمان‌بندی شده قابل تنظیم.

نحوه کار

در زمان راه‌اندازی برنامه و در بازه تنظیم شده، برنامه از هر حساب عبور می‌کند و تأیید می‌کند که نشست زنده است. این یک عملیات سریع است — یک درخواست به ازای هر حساب. بدون QR یا پیامک، نشست‌ها از data/sessions/ بارگیری می‌شوند.

بررسی‌ها در یک استخر رشته پس‌زمینه اجرا می‌شوند (حداکثر ۳ حساب به صورت موازی)، بنابراین رابط کاربری پاسخگو می‌ماند.

نشانگرهای وضعیت

در صفحه حساب‌ها، هر کارت یک نقطه رنگی در کنار نام خود دریافت می‌کند:

  • 🟢 مجاز — نشست زنده، آماده کار
  • 🔴 غیرمجاز — نشست مرده، نیاز به احراز هویت مجدد با QR دارد
  • 🟠 غیرقابل دسترس — مشکل شبکه (بدون اینترنت، پروکسی مرده). نشست احتمالاً زنده است — ما فقط نتوانستیم تأیید کنیم
  • ⚪ پیکربندی نشده — حساب هیچ اعتبارنامه API ندارد
  • 🟣 در حال بررسی — بررسی در حال انجام است

فعال‌سازی و پیکربندی

به تنظیمات → بررسی سلامت نشست بروید:

گزینهتوضیحات
بررسی در زمان راه‌اندازیهر بار که برنامه اجرا می‌شود یک بررسی انجام دهید. به طور پیش‌فرض فعال است.
فاصله بررسی خودکاربررسی دوره‌ای در دقیقه. 0 = غیرفعال. پیشنهاد می‌شود: 60 یا 120.
احراز هویت مجدد خودکار نشست‌های مردهوقتی نشست‌های مرده پیدا شدند، بلافاصله صف احراز هویت مجدد QR را بدون پرسیدن باز کنید.

بررسی دستی

در نوار ابزار صفحه حساب‌ها روی بررسی نشست‌ها کلیک کنید. پیشرفت از طریق نشانگرهای نقطه‌ای قابل مشاهده است؛ دکمه checking… X/Y را نشان می‌دهد.

صف احراز هویت مجدد

وقتی نشست‌های مرده پیدا شدند، برنامه پیشنهاد می‌دهد آن‌ها را یکی یکی دوباره مجاز کنید:

  1. یک درخواست ظاهر می‌شود: "N نشست مرده پیدا شد. همه را همین حالا دوباره مجاز کنیم؟"
  2. روی بله کلیک کنید — پنجره ورود QR برای اولین حساب مرده باز می‌شود
  3. کد QR را با گوشی خود اسکن کنید. وقتی آن حساب مجاز شد، QR بعدی به طور خودکار باز می‌شود
  4. این فرآیند تا خالی شدن صف ادامه می‌یابد
  5. یک خلاصه توست نشان می‌دهد: احراز هویت مجدد به پایان رسید: N موفق، M ناموفق
نکته: احراز هویت مجدد خودکار را فعال کنید

اگر حساب‌های زیادی دارید، احراز هویت مجدد خودکار نشست‌های مرده را روشن کنید. در زمان راه‌اندازی فقط یک صف از پنجره‌های QR خواهید دید — گوشی خود را بردارید و آن‌ها را یکجا اسکن کنید.

آیا هر بار باید QR را اسکن کنم؟

خیر. نشست‌ها در فایل‌ها ذخیره می‌شوند و ماه‌ها زنده می‌مانند. QR فقط زمانی درخواست می‌شود که نشست واقعاً مرده باشد. در استفاده روزمره همه چیز بی‌صدا بازیابی می‌شود.

"غیرقابل دسترس" (🟠) به چه معناست؟

نشست مرده نیست — یک مشکل شبکه است. برنامه در این موارد مجوز را بازنشانی نمی‌کند تا از خروج‌های نادرست جلوگیری کند. بعداً بررسی را دوباره امتحان کنید.

اگر بررسی غیرفعال باشد چه؟

برنامه همچنان کار می‌کند — نشست‌ها به صورت تنبل در اولین استفاده بررسی می‌شوند. اما شما از قبل نمی‌دانید که آیا نشستی مرده است یا خیر؛ وقتی سعی می‌کنید پیامی ارسال کنید متوجه می‌شوید.

مانیتور سلامت حساب v4.0

یک نشانگر ریسک برای هر حساب، بر اساس فعالیت ارسال واقعی از ۲۴ ساعت گذشته.

باز کردن آن

روی هر کارت حسابی، روی آیکون سپر کلیک کنید. یک پنجره با داده‌های سلامت آن حساب باز می‌شود.

چه چیزی خواهید دید

بنر ریسک
سبز / زرد / قرمز، با یک توصیه کوتاه.
ارسال شده (۲۴ ساعت)
چند ارسال موفق در روز گذشته.
خطاها (۲۴ ساعت)
خطاها و FloodWaitها با هم.
Floods (۱ ساعت)
خطاهای FloodWait در یک ساعت گذشته.
PEER_FLOOD (همه زمان‌ها)
تعداد کل هشدار سخت ضد اسپم تلگرام. هر مقدار > ۰ نشانگر ریسک را قرمز می‌کند.
نمودار فعالیت ۷ روزه
میله‌ها = ارسال شده، خط = خطاها. یک احساس فوری از روندها می‌دهد.
خطاهای اخیر
۵ رویداد خطای آخر با هدف و نوع خطا.

سطوح ریسک

سطحمحرک‌ها
🟢 سالمفعالیت کم، بدون floods، بدون تاریخچه PEER_FLOOD
🟡 بالا>۲۰ ارسال، یا هر flood، یا ≥۱۰ خطا در ۲۴ ساعت
🔴 بحرانیهر PEER_FLOOD، یا >۱۰۰ ارسال، یا ≥۳ floods در ۲۴ ساعت

توصیه‌ها

در پنجره روی توصیه‌ها کلیک کنید تا یک چک‌لیست بر اساس داده‌های فعلی دریافت کنید. به عنوان مثال:

  • اگر PEER_FLOOD > ۰ — این حساب را ۲۴–۴۸ ساعت متوقف کنید
  • اگر floods مکرر هستند — تأخیرهای بین پیام‌ها را افزایش دهید
  • اگر ارسال شده > ۱۰۰/۲۴ ساعت — حجم روزانه را کاهش دهید
  • حساب‌های سبز یک "شما خوب هستید، به کار خود ادامه دهید" دریافت می‌کنند

گیرندگان

گروه‌ها، کانال‌ها و مخاطبین موجود برای حساب فعلی، در سه ستون چیده شده‌اند.

معمولاً گیرندگان را به صورت دستی اضافه نمی‌کنید

برنامه دیالوگ‌های واقعی تلگرام شما را می‌خواند و فقط چت‌هایی را نشان می‌دهد که در آن‌ها می‌توانید پست کنید — به عنوان ادمین در کانال‌ها، یا به عنوان عضو در گروه‌ها. فقط یک حساب را مجاز کنید و روی بازخوانی لیست کلیک کنید.

نوار ابزار

اقدامتوضیحات
بازخوانی لیستهمه گروه‌ها، کانال‌ها و مخاطبین را از تلگرام واکشی کنید. بسته به تعداد چت‌ها ۵ تا ۳۰ ثانیه طول می‌کشد.
فیلتر گروهفقط گیرندگان یک گروه نام‌گذاری شده خاص را نشان دهید. به بخش گروه‌های گیرنده مراجعه کنید.
مدیریت گروه‌هاایجاد، تغییر نام و حذف گروه‌های نام‌گذاری شده.
ورود CSVگیرندگان را از یک فایل به صورت انبوه بارگیری کنید. از CSV، XLSX و JSON با یک پنجره پیش‌نمایش پشتیبانی می‌کند.
خروجی CSVلیست فعلی را در یک فایل CSV با UTF-8 BOM (سازگار با اکسل) ذخیره کنید.
پاک کردن همههمه گیرندگان این حساب را حذف کنید. غیرقابل برگشت — اگر مطمئن نیستید ابتدا صادر کنید.

سه ستون

  • گروه‌ها — چت‌ها و سوپرگروه‌هایی که حق پست دارید
  • کانال‌ها — کانال‌های پخشی که شما ادمین آن‌ها هستید
  • مخاطبین — کاربرانی که می‌توانید به آن‌ها پیام مستقیم دهید

کار با موارد

  • چک‌باکس — انتخاب گیرندگان فردی
  • چک‌باکس در سرصفحه — انتخاب / لغو انتخاب همه در این ستون
  • دکمه حذف در هاور — حذف گیرنده منفرد از لیست محلی (روی تلگرام تأثیری ندارد)
  • افزودن + — افزودن دستی یک گیرنده منفرد (با تایپ نام دقیق)
  • حذف انتخاب شده‌ها — حذف همه گیرندگان علامت‌گذاری شده

نوار اقدامات انتخاب

وقتی حداقل یک مورد انتخاب شده باشد، یک نوار اقدامات بنفش بالای ستون‌ها ظاهر می‌شود با:

  • افزودن به گروه — انتخاب را به یک گروه نام‌گذاری شده منتقل کنید
  • حذف از گروه — فقط زمانی قابل مشاهده است که فیلتر گروه فعال باشد
  • حذف — گیرندگان انتخاب شده را کاملاً حذف کنید
  • پاک کردن انتخاب — همه را از حالت انتخاب خارج کنید
لیست من بعد از بازخوانی خالی است

یعنی برنامه هیچ چتی که در آن حق پست داشته باشید پیدا نکرد. بررسی کنید که: (۱) حساب عضو برخی گروه‌ها باشد، (۲) در آن گروه‌ها اجازه ارسال پیام داشته باشید، (۳) برای کانال‌ها، حق ادمین با post_messages داشته باشید.

آیا می‌توانم لیست‌های گیرنده متفاوتی برای هر حساب داشته باشم؟

بله. هر حساب لیست خود را دارد که به طور جداگانه ذخیره می‌شود. تغییر حساب به طور خودکار لیست صحیح را بارگیری می‌کند.

گروه‌های گیرنده v4.0

مجموعه‌های نام‌گذاری شده از گیرندگان — مانند "اصلی"، "VIP"، "تست" — برای انتخاب با یک کلیک در تبلیغات.

گروه گیرنده چیست؟

این یک مجموعه ذخیره شده از گیرندگان (گروه‌ها + کانال‌ها + مخاطبین) است که می‌توانید با یک کلیک در ویرایشگر تبلیغات انتخاب کنید. چند به چند: همان گیرنده می‌تواند به طور همزمان به چندین گروه تعلق داشته باشد.

ایجاد یک گروه

1 روی "مدیریت گروه‌ها" کلیک کنید

نوار ابزار در صفحه گیرندگان، نزدیک فیلتر گروه.

2 روی "گروه جدید" کلیک کنید

یک نام تایپ کنید — مثلاً "کانال‌های اصلی" — و ذخیره کنید.

3 گیرندگان را اضافه کنید

یا:

  • گیرندگان را در ستون‌ها علامت‌گذاری کنید، سپس در نوار اقدامات روی افزودن به گروه کلیک کنید، یا
  • هنگام واردات، ستون گروه را تعریف کنید — به بخش ورود اطلاعات مراجعه کنید

مدیریت گروه‌ها

در پنجره مدیریت گروه‌ها می‌توانید:

  • تغییر نام یک گروه — آیکون مداد
  • حذف یک گروه — آیکون سطل زباله. خود گیرندگان در لیست شما باقی می‌مانند؛ فقط عضویت در گروه حذف می‌شود.
  • تعداد اعضا را در کنار هر گروه ببینید

فیلتر کردن نمای گیرندگان

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

  • همه گیرندگان — همه چیز را نشان دهید
  • بدون گروه — فقط گیرندگانی که در هیچ گروهی نیستند
  • هر نام گروه خاص

انتخاب یک گروه در ویرایشگر تبلیغات

هر تبلیغی را باز کنید → تب گیرندگان. بالای سه ستون یک ردیف از چیپ‌های گروه خواهید دید:

  • ○ نام — ۱۲ — چیزی انتخاب نشده است (۱۲ موجود)
  • ◐ نام — ۵/۱۲ — تا حدی انتخاب شده است
  • ✓ نام — ۱۲ — کاملاً انتخاب شده است (سبز)

برای تغییر وضعیت کل گروه روی یک چیپ کلیک کنید. برای لغو انتخاب همه در آن گروه دوباره کلیک کنید.

گروه‌های خالی

اگر اعضای یک گروه در لیست گیرندگان فعلی شما نباشند (مثلاً با بازخوانی لیست حذف شده باشند)، چیپ خاکستری و غیرفعال می‌شود.

ورود CSV / اکسل / JSON v4.0

لیست‌های گیرنده را به صورت انبوه از صفحات گسترده، دامپ‌های JSON یا یک CSV صادر شده از برنامه دیگر بارگیری کنید.

فرمت‌های پشتیبانی شده

  • CSV — تشخیص خودکار جداکننده (;، , یا tab)
  • اکسل — .xlsx و .xlsm با یک پنجره نگاشت ستون تعاملی
  • JSON — یا یک لیست از اشیاء یا یک دیکشنری با کلیدهای group/channel/contact

فرمت CSV

دو یا سه ستون: type، name، و group اختیاری.

type;name;group
group;Marketing chat;Main
channel;@my_channel;Main
contact;John Smith;
group;Test chat;Test

نوع مترادف‌ها را در انگلیسی و روسی می‌پذیرد:

  • group، groups، группа، группы
  • channel، channels، канал، каналы
  • contact، contacts، контакт، контакты، user، users

فرمت JSON

دو شکل پذیرفته شده:

[
  { "type": "group",   "name": "Marketing chat", "group": "Main" },
  { "type": "channel", "name": "@my_channel",   "group": "Main" }
]

یا گروه‌بندی شده بر اساس نوع:

{
  "group":   ["Marketing chat", "Test chat"],
  "channel": ["@my_channel"],
  "contact": ["John Smith"]
}

نگاشت ستون اکسل

وقتی یک فایل .xlsx را وارد می‌کنید، یک پنجره نگاشت ظاهر می‌شود:

  • ستون نوع — کدام ستون شامل group/channel/contact است
  • ستون نام — کدام ستون نام واقعی گیرنده را دارد
  • ستون گروه — گروه نام‌گذاری شده اختیاری برای اختصاص دادن هر گیرنده

برنامه بر اساس نام‌های سرصفحه ("type"، "name"، "group"، و معادل‌های روسی آن‌ها) حدس می‌زند. یک پیش‌نمایش زنده ۴ ردیف اول را همانطور که تجزیه می‌شوند نشان می‌دهد.

پیش‌نمایش ورود اطلاعات

پس از تجزیه، یک خلاصه خواهید دید:

  • جدید — چند ردیف جدید اضافه می‌شود
  • تکراری‌ها — چند مورد قبلاً در لیست شما وجود دارد
  • خطاها — مشکلات تجزیه، با شماره خط
  • گروه‌های شناسایی شده — نام‌های گروه یافت شده در فایل

ادغام در مقابل جایگزینی

  • ادغام — گیرندگان جدید را اضافه می‌کند، از موارد تکراری صرف‌نظر می‌کند، موارد موجود را دست‌نخورده باقی می‌گذارد
  • جایگزینی — لیست فعلی را پاک می‌کند و فقط از آنچه در فایل است استفاده می‌کند (یک پنجره تأیید اضافی ظاهر می‌شود)

صادرات به CSV

در نوار ابزار روی خروجی CSV کلیک کنید. فایل با موارد زیر ذخیره می‌شود:

  • رمزگذاری UTF-8 BOM — اکسل متن غیر ASCII را به درستی باز می‌کند
  • جداکننده نقطه ویرگول
  • ستون گروه اختیاری که همه گروه‌های گیرنده‌ای که مورد به آن‌ها تعلق دارد را فهرست می‌کند

نام فایل پیش‌فرض: recipients_AccountName_20261016_143052.csv.

اکسل کاراکترهای نامفهوم نشان می‌دهد

فایل به عنوان UTF-8 ذخیره نشده است. از برنامه دوباره صادر کنید (همیشه UTF-8 BOM می‌نویسد) یا در Notepad گزینه "Save As → encoding UTF-8" را انتخاب کنید.

فایل‌های بزرگ (بیش از ۱۰,۰۰۰ ردیف)؟

تجزیه سریع است — چند میلی‌ثانیه در هر ۱۰۰۰ ردیف. پنجره پیش‌نمایش ممکن است برای فایل‌های بسیار بزرگ یک ثانیه طول بکشد، اما به خوبی کار می‌کند.

نمای کلی تبلیغات

صفحه تبلیغات تمام پیام‌های زمان‌بندی شده شما را برای حساب فعلی فهرست می‌کند و کنترل زنده‌ای بر هر یک ارائه می‌دهد.

چیدمان

تقسیم دو پنلی:

  • چپ — لیست تبلیغات با نشانگر در حال اجرا/متوقف/متوقف شده
  • راست — جزئیات تبلیغ انتخاب شده

نشانگرها در لیست

  • ▶ — در حال اجرا
  • ⏸ — متوقف شده
  • ⏹ — متوقف شده (کامل)

اقدامات نوار ابزار

دکمهچه کاری انجام می‌دهد
بازخوانیلیست تبلیغات را دوباره بارگیری کنید.
تبلیغ جدیدویرایشگر تبلیغات را برای یک کمپین جدید باز کنید.
شروع همه / توقف همهعملیات انبوه برای حساب فعلی.
شروع همه (همه حساب‌ها) — فقط Enterpriseشروع هر تبلیغی از هر حساب مجاز.
توقف همه (همه حساب‌ها) — فقط Enterpriseتوقف اضطراری در همه حساب‌ها.

پنل جزئیات

خلاصه محتوای تبلیغ انتخاب شده، فاصله، پنجره زمانی، تعداد گیرندگان، تأخیرها و — در حین اجرا — یک نوار پیشرفت زنده را نشان می‌دهد.

دکمه‌های کنترل:

  • شروع — شروع ارسال
  • مکث / ادامه — توقف موقت بدون از دست دادن وضعیت
  • توقف — لغو کامل (چرخه در حال اجرا فوراً قطع می‌شود)
  • ویرایش، تکثیر، حذف
بازخوانی زنده

صفحه وضعیت تبلیغ در حال اجرا را هر ۱.۸ ثانیه نظرسنجی می‌کند. پیشرفت، نشانگرها و دکمه‌ها همگی بدون هیچ بازخوانی دستی با بک‌اند همگام می‌مانند.

ایجاد یک تبلیغ جدید

روی تبلیغ جدید کلیک کنید تا ویرایشگر باز شود. ویرایشگر چهار تب دارد:

  1. محتوا — متن، رسانه، چرخش، زنجیره‌ها
  2. گیرندگان — گروه‌ها، کانال‌ها، مخاطبین، موضوعات انجمن
  3. زمان‌بندی — فاصله، پنجره زمانی، روزها، تأخیرها، توقف خودکار
  4. پیشرفته — محدودیت ارسال، قالب‌ها

هر تب در بخش اختصاصی خود در زیر پوشش داده شده است.

ویرایشگر تبلیغات — محتوا

پیام را بسازید. سه حالت: پیام منفرد، چرخش محتوا، و زنجیره‌های پیام.

حالت ۱ — پیام منفرد

حالت پیش‌فرض. متن پیام را پر کنید و به صورت اختیاری رسانه را پیوست کنید. متغیرها پشتیبانی می‌شوند (به زیر مراجعه کنید).

حالت ۲ — چرخش محتوا

استفاده از چرخش را فعال کنید تا چندین نسخه تعریف کنید (به بخش چرخش اختصاصی مراجعه کنید).

حالت ۳ — زنجیره‌های پیام

زنجیره‌های پیام را فعال کنید تا به سناریوهای چند مرحله‌ای بروید (به بخش زنجیره اختصاصی مراجعه کنید).

فیلد پیام

از متن چند خطی، قالب‌بندی HTML و متغیرهای پویا پشتیبانی می‌کند:

متغیرنتیجه
{date}تاریخ فعلی (YYYY-MM-DD)
{time}زمان فعلی (HH:MM)
{datetime}تاریخ و زمان
{day}روز هفته
{month}نام ماه
{random:1000}عدد صحیح تصادفی ۰–۱۰۰۰
{random:1-100}عدد صحیح تصادفی در محدوده
{random:red|green|blue}انتخاب تصادفی
{date:%H:%M}فرمت سفارشی strftime

در کمپین‌های مشترکین (DM)، این متغیرهای کاربر نیز موجود هستند:

  • {name} — نام کامل
  • {first_name}، {last_name} — بخش‌هایی از نام
  • {username} — @username در صورت وجود
شمارنده کاراکتر

در زیر textarea برنامه تعداد کاراکترهای فعلی را نشان می‌دهد تا ببینید چقدر به محدودیت ۴۰۹۶ کاراکتری تلگرام نزدیک هستید.

رسانه

روی افزودن فایل‌ها کلیک کنید تا عکس، ویدیو یا اسناد را پیوست کنید. فایل‌های متعدد (تا ۱۰) به عنوان یک آلبوم تلگرام ارسال می‌شوند.

  • فایل‌ها با نام پایه و یک دکمه حذف در هاور فهرست می‌شوند
  • هر نوع فایلی که تلگرام می‌پذیرد: JPG، PNG، MP4، MOV، ZIP، PDF و غیره
  • رسانه برای هر پیام آپلود می‌شود — بدون مشکلات محدودیت نرخ فراتر از تأخیر ارسال استاندارد

فوروارد از پیام‌های ذخیره شده

به جای نوشتن متن، می‌توانید یک پیام ذخیره شده موجود (یا یک آلبوم کامل) را فوروارد کنید:

1 "فوروارد از پیام‌های ذخیره شده" را فعال کنید

فیلد پیام معمولی و لیست رسانه پنهان می‌شوند.

2 روی "انتخاب از ذخیره شده‌ها" کلیک کنید

یک انتخابگر با پیام‌های ذخیره شده شما باز می‌شود. از جستجو برای فیلتر بر اساس متن یا نوع رسانه (عکس/ویدیو/سند/متن) استفاده کنید.

3 روی یک پیام کلیک کنید

شناسه آن در فیلد قرار می‌گیرد. وقتی تبلیغ اجرا می‌شود، برنامه آلبوم کامل (اگر آلبوم باشد) را حل کرده و همانطور که هست فوروارد می‌کند.

محتوای فوروارد شده شخصی‌سازی نمی‌شود

متغیرهایی مانند {name} در پیام‌های فوروارد شده کار نمی‌کنند — پیام کلمه به کلمه کپی می‌شود. از این حالت برای اطلاعیه‌های پخشی استفاده کنید، نه برای ارتباط شخصی.

پیش‌نمایش و ارسال آزمایشی

در پایین ویرایشگر:

  • پیش‌نمایش — پیام را همانطور که در تلگرام به نظر می‌رسد نشان می‌دهد (با جایگزینی متغیرهای تاریخ/زمان)
  • ارسال آزمایشی — پیام را یک بار به اولین گیرنده انتخاب شده ارسال می‌کند. قبل از راه‌اندازی یک کمپین طولانی از این استفاده کنید.

چرخش محتوا v4.0

چندین نسخه متنی و رسانه‌ای تعریف کنید. هر گیرنده یک نسخه متفاوت دریافت می‌کند — که به طور چشمگیری تشخیص الگوهای اسپم را کاهش می‌دهد.

چرا از چرخش استفاده کنیم؟

سیستم‌های ضد اسپم تلگرام پیام‌های یکسانی را که مکرراً ارسال می‌شوند علامت‌گذاری می‌کنند. وقتی همان محتوا به صدها گیرنده می‌رود، حساب می‌تواند محدود شود. با چرخش، هر پیام ترکیب منحصر به فردی از متن + رسانه است.

فعال‌سازی چرخش

1 در تب محتوا "استفاده از چرخش" را علامت بزنید

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

2 نسخه اول از پیش پر شده است

هر آنچه در فیلد پیام منفرد بود به متن و رسانه نسخه شماره ۱ تبدیل می‌شود.

3 نسخه‌ها را اضافه کنید

روی افزودن نسخه کلیک کنید. یک متن متفاوت و/یا رسانه متفاوت پر کنید.

قانون جفت شدن

متن + رسانه همیشه با هم هستند

متن نسخه شماره ۳ همیشه با رسانه نسخه شماره ۳ ارسال می‌شود. این نسخه‌ها را منسجم نگه می‌دارد — بدون ترکیب‌های ناهماهنگ تصویر-متن.

حالت‌های چرخش

حالترفتار
تصادفیبرای هر گیرنده، یک نسخه تصادفی انتخاب می‌شود. برای ارسال با حداکثر عدم الگو توصیه می‌شود.
چرخهنسخه‌ها به ترتیب استفاده می‌شوند: ۱، ۲، ۳، ۱، ۲، ۳…

رسانه برای هر نسخه

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

استفاده از چرخش در داخل زنجیره‌ها

چرخش در داخل زنجیره‌ها نیز کار می‌کند — هر مرحله می‌تواند کلید استفاده از چرخش خود را داشته باشد. مرحله ۱ ممکن است ۳ نسخه متنی را به صورت تصادفی ارسال کند، مرحله ۲ ممکن است چرخشی نداشته باشد، مرحله ۳ ممکن است ۵ تصویر مختلف را به صورت چرخه‌ای طی کند. شمارنده هر مرحله مستقل است.

توصیه شده: ۳–۵ نسخه

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

زنجیره‌های پیام v4.0

یک تبلیغ را به یک مکالمه چند مرحله‌ای تبدیل کنید — ۲ تا ۵ پیام که یکی پس از دیگری با مکث‌های قابل تنظیم ارسال می‌شوند.

فعال‌سازی زنجیره‌ها

1 در تب محتوا "زنجیره‌های پیام" را علامت بزنید

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

2 انتقال محتوای موجود (اختیاری)

اگر پیامی در حالت منفرد نوشته بودید، برنامه به طور خودکار آن را به مرحله اول تبدیل می‌کند.

هر مرحله دارای

  • متن — بدنه پیام جداگانه
  • رسانه — پیوست‌های جداگانه (عکس، ویدیو، اسناد)
  • چرخش اختیاری — کلید برای هر مرحله برای تعریف چندین نسخه در آن مرحله
  • تأخیر بعد از — چند ثانیه صبر کنید تا مرحله بعدی ارسال شود (فقط بین مراحل نشان داده می‌شود، نه بعد از آخرین مرحله)

مدیریت مراحل

  • افزودن مرحله — یک مرحله خالی جدید در انتها اضافه کنید
  • فلش‌های ↑ / ↓ — ترتیب مراحل را تغییر دهید (در اولین/آخرین غیرفعال است)
  • X — یک مرحله را حذف کنید (حداقل یک مرحله باید باقی بماند)

چرخش در هر مرحله

در داخل هر مرحله، استفاده از چرخش را فعال کنید تا چندین نسخه متنی + رسانه‌ای برای آن مرحله تعریف کنید. حالت چرخش (تصادفی/چرخه) برای هر مرحله جداگانه است.

نحوه تعامل تأخیر و فاصله

تأخیر بعد از بین مراحل برای همان گیرنده فعال می‌شود. تأخیر بین پیام‌ها خود تبلیغ بین گیرندگان فعال می‌شود. بنابراین یک زنجیره ۳ مرحله‌ای برای ۱۰ گیرنده ≈ (۳ ارسال + ۲ مکث داخلی) × ۱۰ + ۹ تأخیر بین گیرندگان.

پیش‌نمایش جدول زمانی

روی پیش‌نمایش کلیک کنید تا کل زنجیره را به عنوان یک جدول زمانی شماره‌گذاری شده با حباب‌های محتوا در هر مرحله و نشانگرهای مکث بین آن‌ها ببینید.

مثال دنیای واقعی — توالی گرم‌کردن

برای کمپین‌های مشترکین، یک زنجیره ۳ مرحله‌ای به این صورت کار می‌کند:

مرحلهمحتواتأخیر بعد از
۱"سلام {first_name}! متوجه شدم به بازاریابی علاقه دارید — یک سوال سریع؟"۴۵ ثانیه
۲"ما یک جامعه خصوصی کوچک داریم که در آن موارد واقعی را به اشتراک می‌گذاریم."۶۰ ثانیه
۳"لینک را می‌خواهید؟ رایگان است."—
آیا می‌توانم بیش از ۵ پیام را زنجیره کنم؟

بله — هیچ محدودیت سختی وجود ندارد، اما ۲–۵ مرحله نقطه شیرین است. زنجیره‌های طولانی‌تر شروع به احساس اسپم می‌کنند.

آیا اگر یک مرحله شکست بخورد، مراحل متوقف می‌شوند؟

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

زمان‌بندی

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

حالت‌های زمان‌بندی

فاصله
تبلیغ یک بار اجرا می‌شود، سپس N دقیقه صبر می‌کند، دوباره اجرا می‌شود و به همین ترتیب. ساده و قابل پیش‌بینی. توصیه شده: ۱۸۰+ دقیقه.
زمان‌های ثابت
تبلیغ در زمان‌های دقیق روز (مثلاً ۰۹:۰۰ و ۱۸:۰۰) اجرا می‌شود. عالی برای اطلاعیه‌های روزانه.

حالت فاصله

فاصله را در دقیقه تنظیم کنید. حداقل توصیه شده: ۱۸۰ برای کانال‌ها، ۶۰ حد مطلق. کمتر از آن تلگرام شروع به پاسخ با FloodWait می‌کند.

حالت زمان‌های ثابت

یک یا چند زمان از روز (HH:MM) اضافه کنید. برنامه زمان‌بندی شده بعدی را محاسبه می‌کند — اگر یک روز همه زمان‌هایش گذشته باشد، اولین زمان روز بعد استفاده می‌شود.

فیلتر روزهای هفته ابتدا اعمال می‌شود

اگر یک زمان در روزی قرار می‌گیرد که علامت آن را برنداشته‌اید، برنامه به طور خودکار به روز معتبر بعدی می‌رود.

پنجره زمانی

ارسال را به ساعات خاص محدود کنید — مثلاً فقط در ساعات کاری. پنجره‌های شبانه نیز کار می‌کنند (۲۲:۰۰ → ۰۶:۰۰).

بازنویسی پنجره زمانی جهانی

اگر پنجره زمانی جهانی را در تنظیمات فعال کنید، تنظیمات هر تبلیغ را نادیده می‌گیرد. یک راهنمای بنفش در ویرایشگر تبلیغ ظاهر می‌شود — پنجره هر تبلیغ غیرفعال است.

روزهای هفته

هفت چک‌باکس: دوشنبه تا یکشنبه. فقط روزهای علامت‌گذاری شده اجازه ارسال دارند. اگر برنامه در حال اجرا باشد اما روز فعلی علامت‌گذاری نشده باشد، "روز اشتباه" را ثبت می‌کند و صبر می‌کند.

تأخیر بین پیام‌ها

یک محدوده تصادفی در ثانیه. برای هر گیرنده، تأخیر به طور یکنواخت بین حداقل و حداکثر کشیده می‌شود.

سناریوتوصیه شده
کانال‌های کوچک (< ۲۰ گیرنده)۱۰–۳۰ ثانیه
لیست‌های متوسط (۲۰–۱۰۰)۳۰–۱۲۰ ثانیه
لیست‌های بزرگ (۱۰۰+)۶۰–۳۰۰ ثانیه

محافظت از توقف خودکار

قانونرفتار
توقف پس از N خطای متوالیاگر N خطا پشت سر هم اتفاق بیفتد (شمارنده در هر ارسال موفق بازنشانی می‌شود)، کمپین متوقف می‌شود. توصیه شده: ۵–۱۰.
توقف پس از N FloodWait / ساعتاگر N FloodWait در یک ساعت چرخشی رخ دهد، کمپین متوقف می‌شود. توصیه شده: ۳–۵.
PEER_FLOOD (همیشه روشن)توقف فوری — قابل غیرفعال کردن نیست. سخت‌ترین سیگنال ضد اسپم تلگرام.
۰ = غیرفعال

به طور پیش‌فرض، هر دو قانون توقف خودکار ۰ هستند. آن‌ها را برای کمپین‌های تولیدی تنظیم کنید — هیچ دلیل خوبی برای عدم انجام این کار وجود ندارد.

وقتی توقف خودکار فعال می‌شود چه اتفاقی می‌افتد

  1. کمپین فوراً متوقف می‌شود
  2. یک ورودی گزارش ظاهر می‌شود: "توقف خودکار: ۵ خطای متوالی. تبلیغ 'X' متوقف شد."
  3. اگر اعلان‌های تلگرام فعال باشند، یک گزارش در پیام‌های ذخیره شده دریافت می‌کنید
  4. تبلیغ در لیست شما باقی می‌ماند — مشکل را برطرف کرده و دوباره راه‌اندازی کنید

موضوعات انجمن

اگر یک گروه انتخاب شده یک انجمن تلگرام (با موضوعات) باشد، می‌توانید به موضوعات خاص — یا به چت اصلی — ارسال کنید.

گروه انجمن چیست؟

یک سوپرگروه که در آن ادمین "Topics" را فعال کرده است — پیام‌ها به رشته‌های جداگانه سازماندهی می‌شوند. گروه‌های معمولی موضوعات ندارند.

پیکربندی موضوعات

1 گروه‌ها را در تب گیرندگان اضافه کنید

هر گروه انجمنی که انتخاب می‌کنید یک دکمه موضوعات را نشان می‌دهد.

2 روی "پیکربندی موضوعات" کلیک کنید

یک پنجره با درختی از گروه‌ها و موضوعات آن‌ها باز می‌شود. موضوعات در صورت تقاضا از تلگرام بارگیری می‌شوند (پس از بارگیری اول کش می‌شوند).

3 موضوعات مورد نظر خود را علامت بزنید

هر گروه لیست چک‌باکس خود را دارد. چت اصلی به عنوان اولین مورد ظاهر می‌شود.

4 ذخیره کنید

انتخاب شما برای هر تبلیغ و هر گروه ذخیره می‌شود.

هنگام ارسال چه اتفاقی می‌افتد

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

شمارش گیرندگان

تعداد "کل گیرندگان" در جزئیات تبلیغ شامل تقسیم موضوعات می‌شود. یک گروه واحد با ۳ موضوع انتخاب شده به عنوان ۳ گیرنده شمرده می‌شود.

چت اصلی

همیشه موجود است. اگر فقط چت اصلی را علامت بزنید — بدون موضوعات — پیام فقط به فید عمومی می‌رود.

کمپین‌های مشترکین (DM)

شرکت‌کنندگان را از هر گروه یا کانالی جمع‌آوری کنید، سپس پیام‌های مستقیم شخصی‌سازی شده برای آن‌ها ارسال کنید.

ابتدا این را بخوانید

پیام‌های مستقیم انبوه تهاجمی‌ترین شکل اتوماسیون تلگرام هستند. تلگرام برای این کار سریع‌تر از هر چیز دیگری مسدود می‌کند. همیشه با محدودیت‌های کوچک شروع کنید (۵–۱۰ پیام در روز) و هرگز توقف خودکار را غیرفعال نکنید. برای اولین تست‌ها از یک حساب اختصاصی و غیر مهم استفاده کنید.

نحوه کار

  1. شما یک منبع را مشخص می‌کنید — یک گروه یا کانال که به آن دسترسی دارید
  2. برنامه لیست شرکت‌کنندگان را واکشی می‌کند (با فیلترها)
  3. یک پیام مستقیم شخصی‌سازی شده به هر شرکت‌کننده ارسال می‌کند
  4. پیشرفت ردیابی می‌شود — همان کاربر هرگز دو بار پیام دریافت نمی‌کند

ایجاد یک کمپین

1 منبع را تنظیم کنید

یکی از:

  • @username — اگر گروه نام کاربری عمومی دارد
  • t.me/... — لینک دعوت کامل
  • نام دقیق دیالوگ — اگر گروه خصوصی است
2 پیام را بنویسید

از متغیرهای کاربر پشتیبانی می‌کند: {name}، {first_name}، {last_name}، {username}.

3 فیلترها را پیکربندی کنید
  • حذف ربات‌ها — به طور پیش‌فرض روشن، بسیار توصیه می‌شود
  • حذف کاربران بدون نام کاربری — به طور پیش‌فرض خاموش
  • فقط فعال برای N روز — فیلتر بر اساس تاریخ آخرین بازدید، ۰ = بدون فیلتر
4 سرعت و محدودیت‌ها را تنظیم کنید
  • تأخیر بین پیام‌ها — حداقل و حداکثر ثانیه. توصیه شده: ۳۰–۶۰ دقیقه، تا ۳۰۰ برای ایمنی
  • محدودیت روزانه در هر پاس — چند پیام در یک اجرا ارسال شود. با ۵–۱۰ شروع کنید
  • محدودیت واکشی — چند شرکت‌کننده در یک زمان بارگیری شود
5 فاصله را تنظیم کنید

هر چند وقت یک بار کمپین یک پاس اجرا می‌کند. برای کمپین‌های DM، ۱۴۴۰ دقیقه (یک بار در روز) ایمن‌ترین است.

پیش‌نمایش شرکت‌کنندگان

روی پیش‌نمایش در هر کمپینی کلیک کنید. پنجره‌ای با لیست کاربرانی که هدف قرار می‌گیرند باز می‌شود و نام، @username و شناسه کاربر را نشان می‌دهد. قبل از راه‌اندازی تأیید کنید که فیلترها همانطور که انتظار دارید کار می‌کنند.

اجرای کمپین

روی شروع کلیک کنید. اولین پاس فوراً اجرا می‌شود. آمار زنده در پنل اطلاعات ظاهر می‌شود و هر ثانیه به‌روزرسانی می‌شود:

  • ارسال شده — پیام‌های تحویل داده شده
  • رد شده — کاربران بدون نام کاربری، محافظت شده توسط حریم خصوصی، غیرفعال شده، ربات‌ها
  • ناموفق — خطاها (معمولاً حریم خصوصی یا flood)
  • ردیابی شده — کل کاربران متمایزی که قبلاً پیام دریافت کرده‌اند

شرایط رد شدن

کاربران بی‌صدا رد می‌شوند (در رد شده شمارش می‌شوند) زمانی که تلگرام برمی‌گرداند:

  • محدودیت‌های حریم خصوصی — "کاربر پیام‌های غریبه‌ها را نمی‌پذیرد"
  • مخاطب متقابل نیست
  • حساب غیرفعال شده
  • شما توسط کاربر مسدود شده‌اید

بازنشانی پیشرفت

برای پاک کردن لیست "قبلاً ارسال شده" روی بازنشانی کلیک کنید. اگر می‌خواهید همان کمپین را دوباره ارسال کنید از این استفاده کنید — اما فقط پس از تغییر معنادار پیام.

دلایل تکمیل

دلیلمعنی
all_doneهمه شرکت‌کنندگان واکشی شده پردازش شده‌اند
manualشما کمپین را متوقف کردید
peer_floodتلگرام حساب را علامت‌گذاری کرده است — توقف سخت
empty_sourceگروه/کانال منبع هیچ شرکت‌کننده‌ای مطابق با فیلترهای شما ندارد
حجم روزانه ایمن

هیچ عدد جهانی وجود ندارد — این بستگی به سن حساب، فعالیت و خلق و خوی ضد اسپم تلگرام در آن روز دارد. برای اولین هفته با ۵–۱۰ پیام در روز شروع کنید. هرگز بدون دلیل بسیار خوب از ۵۰ تجاوز نکنید.

عضویت در گروه

عضویت انبوه در گروه‌ها و کانال‌ها از یک لیست لینک با تأخیرهای قابل تنظیم.

آماده‌سازی لینک‌ها

لینک‌ها را در textarea جای‌گذاری کنید — یکی در هر خط. فرمت‌های پشتیبانی شده:

  • https://t.me/joinchat/XXXXX — لینک دعوت خصوصی
  • t.me/username — گروه یا کانال عمومی
  • @username — عمومی
  • +invite_hash — دعوت خصوصی

تأخیر بین عضویت‌ها

توصیه شده: ۱۰–۳۰ ثانیه. مقادیر کمتر خیلی سریع منجر به خطاهای FloodWait می‌شوند. پیش‌فرض ۵ ثانیه تهاجمی است — شما حداقل ۱۵ می‌خواهید.

اجرای عضویت

  1. لینک‌ها را جای‌گذاری کنید یا برای وارد کردن یک .txt روی بارگیری از فایل کلیک کنید
  2. تأخیر را تنظیم کنید
  3. روی شروع عضویت کلیک کنید

برنامه لینک‌ها را یکی یکی پردازش می‌کند:

  • نوار پیشرفت موقعیت فعلی را نشان می‌دهد
  • هر تلاش در گزارش رویداد ثبت می‌شود
  • لیست نتایج زنده در زیر با نشانگرهای ✓ / ✗ ظاهر می‌شود
  • توست نهایی نشان می‌دهد: N موفق، M ناموفق

ذخیره لیست شما

لیست لینک شما به طور خودکار در localStorage بین جلسات ذخیره می‌شود. برای صادرات آن به عنوان یک .txt برای پشتیبان‌گیری روی ذخیره در فایل کلیک کنید.

با عضویت انبوه مراقب باشید

عضویت در ۱۰۰+ گروه در یک روز در یک حساب تازه تقریباً همیشه منجر به یک مسدودیت موقت می‌شود. با ۵–۱۰ در روز شروع کنید، در چندین حساب پخش کنید. فقط اگر حساب هیچ نشانه‌ای از استرس نشان نداد افزایش دهید.

اگر برنامه در اواسط عضویت بسته شود چه اتفاقی می‌افتد؟

عضویت متوقف می‌شود. در راه‌اندازی مجدد، لیست لینک حفظ می‌شود، اما وضعیت در حال اجرا نه. باید دوباره روی شروع کلیک کنید — برنامه به طور خودکار چت‌های قبلاً عضو شده را نادیده نمی‌گیرد. اگر مطمئن نیستید، گزارش را بررسی کنید تا ببینید کدام لینک‌ها موفق بوده‌اند.

کمپین‌های استوری

استوری‌های تلگرام را به طور خودکار طبق زمان‌بندی منتشر کنید. نیاز به تلگرام Premium در حساب دارد.

Premium مورد نیاز است

استوری‌ها یک ویژگی تلگرام Premium هستند. اگر حساب شما Premium ندارد، برنامه با یک خطای واضح از شروع کمپین امتناع می‌کند.

ایجاد یک کمپین استوری

1 روی "کمپین استوری جدید" کلیک کنید

پر کنید:

  • نام — برچسب داخلی
  • فایل رسانه — یک عکس یا ویدیو (JPEG/PNG برای عکس، MP4/MOV برای ویدیو)
  • شرح — متن اختیاری روی استوری
  • فاصله — هر چند وقت یک بار منتشر شود. برای استوری‌های روزانه از ۱۴۴۰ دقیقه استفاده کنید

اجرای کمپین

کمپین را انتخاب کنید، روی شروع کلیک کنید. برنامه:

  • بررسی می‌کند که حساب Premium دارد
  • تأیید می‌کند که فایل رسانه وجود دارد
  • اولین استوری را فوراً منتشر می‌کند
  • استوری‌های بعدی را در فاصله مشخص شده زمان‌بندی می‌کند

الزامات رسانه

نوعفرمت‌هامحدودیت‌ها
عکسJPG، PNG، WEBP، GIF، BMPتا ۵ مگابایت
ویدیوMP4، MOV، AVI، MKV، WEBMتا ۶۰ ثانیه، تا ۵ گیگابایت
آیا به Premium در هر حسابی نیاز دارم؟

بله — استوری‌ها برای هر حساب هستند. اگر حساب A دارای Premium باشد و حساب B نباشد، فقط A می‌تواند استوری منتشر کند.

در صورت بروز FloodWait چه اتفاقی می‌افتد؟

برنامه برای مدت زمان لازم مکث می‌کند، رویداد را در گزارش رویداد و آمار ثبت می‌کند، سپس به طور خودکار از سر می‌گیرد.

آیا می‌توانم یک استوری را برای زمان خاصی زمان‌بندی کنم؟

هنوز نه — زمان‌بند فقط برای استوری‌ها فاصله‌ای است. یک گزینه زمان ثابت برای AutoPoster Cloud برنامه‌ریزی شده است.

پاسخ خودکار Enterprise

به طور خودکار به پیام‌های خصوصی دریافتی بر اساس تطبیق کلمات کلیدی پاسخ دهید. فقط طرح Enterprise.

ویژگی مخصوص Enterprise

در طرح Standard یا آزمایشی، بخش پاسخ خودکار یک حالت قفل شده با پیوند ارتقا نشان می‌دهد. ویرایشگر قوانین، آزمایش و هرگونه اجرا نیاز به Enterprise دارد.

چه کاری انجام می‌دهد

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

ایجاد یک قانون

1 روی "قانون جدید" کلیک کنید

پر کنید:

  • نام — برچسب داخلی برای قانون
  • فعال — کلید روشن/خاموش جهانی
  • نوع تطبیق — شامل، برابر، regex یا هر
  • کلمات کلیدی — یکی در هر خط
  • اقدام — پاسخ، رد بی‌صدا یا اطلاع به مالک
  • متن پاسخ — از {first_name}، {username} و غیره پشتیبانی می‌کند
  • تأخیر پاسخ — ثانیه‌هایی که قبل از ارسال صبر می‌شود (انسانی‌تر به نظر می‌رسد)
  • زمان خنک‌شدن — حداقل ثانیه بین پاسخ‌ها به همان کاربر
  • فقط چت‌های خصوصی — کنترل دامنه

انواع تطبیق

نوعرفتار
شاملهر کلمه کلیدی در هر جای پیام ظاهر می‌شود (بدون حساسیت به حروف بزرگ و کوچک)
برابرکل پیام دقیقاً با یک کلمه کلیدی مطابقت دارد
Regexتطبیق regex به سبک پایتون — قدرتمندترین
هرروی هر پیام دریافتی فعال می‌شود. فیلد کلمات کلیدی پنهان است.

اقدامات

اقدامرفتار
پاسخارسال متن پاسخ پیکربندی شده به فرستنده
رد بی‌صدامطابقت با پیام اما هیچ کاری انجام نمی‌دهد (مفید برای ثبت الگوها)
اطلاع به مالکارسال پیام به پیام‌های ذخیره شده شما با نام قانون

آزمایش یک قانون

روی تست در هر قانون پاسخ فعال کلیک کنید. برنامه متن پاسخ را به پیام‌های ذخیره شده خودتان ارسال می‌کند — مفید برای دیدن دقیق نحوه رندر آن با جایگزینی متغیرها.

نحوه فعال شدن قوانین

  • پیام دریافتی تجزیه می‌شود
  • قوانین به ترتیب بررسی می‌شوند؛ اولین تطبیق برنده است
  • بررسی زمان خنک‌شدن انجام می‌شود — همان کاربر نمی‌تواند بیشتر از زمان خنک‌شدن پاسخ خودکار دریافت کند
  • اگر اقدام پاسخ باشد و تأخیر تنظیم شده باشد، برنامه آن تعداد ثانیه صبر می‌کند و سپس ارسال می‌کند
پشتیبانی از گروه‌های انجمن

اگر پیام دریافتی از یک موضوع گروه انجمن باشد، پاسخ به همان موضوع ارسال می‌شود — نه به چت عمومی. این کار خودکار است.

آیا به ربات‌ها پاسخ می‌دهد؟

خیر — پیام‌های ربات نادیده گرفته می‌شوند. پیام‌های خود نیز نادیده گرفته می‌شوند.

آیا زمان‌های خنک‌شدن بین راه‌اندازی‌های مجدد باقی می‌مانند؟

زمان‌های خنک‌شدن فقط در حافظه ذخیره می‌شوند. راه‌اندازی مجدد برنامه آن‌ها را بازنشانی می‌کند. اگر این برای شما مهم است، برنامه را در حال اجرا نگه دارید.

آیا می‌توانم از متغیرها در پاسخ استفاده کنم؟

بله — {first_name}، {last_name}، {username} و {name} همه با اطلاعات فرستنده جایگزین می‌شوند.

آمار v4.0

داشبورد تحلیلی کامل: فعالیت بر اساس روز و ساعت، بهترین اهداف، بهترین خطاها، رویدادهای اخیر با خروجی CSV.

فیلترها

دوره
۲۴ ساعت گذشته / ۷ روز / ۳۰ روز / همه زمان‌ها
حساب
همه حساب‌ها یا یک حساب خاص
کمپین
هر کمپینی که رویدادهایی تولید کرده است

کارت‌های KPI

  • ارسال شده — ارسال‌های موفق (سبز)
  • خطاها — خطاهای سخت (قرمز)
  • Floods — رویدادهای FloodWait (زرد)
  • نرخ — ارسال شده / (ارسال شده + خطاها + floods) به صورت درصد
  • بازدیدها — کل بازدیدها برای پیام‌های کانال ردیابی شده

نمودارها

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

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

بهترین اهداف

۱۰ گیرنده پرکاربردترین با تعداد ارسال، تعداد خطا و — برای کانال‌ها — نشان کل بازدیدها.

بهترین خطاها

۱۰ نوع خطای برتر بر اساس فراوانی. مفید برای درک مسائل سیستماتیک:

  • not_found — گیرنده دیگر وجود ندارد
  • privacy — محدودیت حریم خصوصی کاربر
  • peer_flood — سیگنال توقف سخت از تلگرام
  • flood_wait — محدودیت نرخ خورده شده
  • و موارد دیگر، بسته به خطای خاص برگردانده شده

رویدادهای اخیر

۳۰ رویداد آخر با مهر زمانی، نام کمپین، هدف و قرص وضعیت. فیلتر شده توسط همان دوره/حساب/کمپین به عنوان KPIها.

پیگیری بازدید کانال

برای کانال‌های پخش که حساب شما ادمین است، برنامه به طور خودکار تعداد بازدید را در پس‌زمینه واکشی می‌کند. هر ۱۰ دقیقه برای پیام‌های تا ۷ روزه به‌روزرسانی می‌شود.

خروجی CSV

روی خروجی CSV کلیک کنید تا همه رویدادهای منطبق با فیلترهای فعلی را در یک فایل CSV ذخیره کنید (تا ۱۰۰,۰۰۰ ردیف). ستون‌ها:

timestamp;account_id;campaign_name;campaign_type;target_name;target_kind;status;error_kind;views

نگهداری

آمار به صورت محلی در SQLite ذخیره می‌شوند. رویدادهای قدیمی‌تر از ۹۰ روز به طور خودکار توسط یک کار پس‌زمینه روزانه پاک می‌شوند. در صورت نیاز، نگهداری را در پیکربندی تغییر دهید.

گزارش رویداد

هر اقدامی که برنامه انجام می‌دهد در اینجا ثبت می‌شود. از آن برای نظارت بر کمپین‌ها و تشخیص مشکلات استفاده کنید.

انواع رویداد

  • INFO (آبی) — رویدادهای معمولی: ارسال شروع شد، پیام ارسال شد، کمپین تکمیل شد
  • WARNING (نارنجی) — مسائل بالقوه: فاصله کم، شبکه کند، کاربران رد شده
  • ERROR (قرمز) — خرابی‌های واقعی: موجودیت یافت نشد، بدون مجوز، PEER_FLOOD

فیلترها

فیلتراثر
سطحفقط INFO / WARNING / ERROR / همه را نشان دهید
حسابفیلتر به رویدادهای یک حساب خاص
جستجوجستجوی متن آزاد در بدنه پیام (با تأخیر ۲۰۰ میلی‌ثانیه)
حالت سکوتپنهان کردن پیام‌های معمولی مانند ارسال‌های فردی — فقط موارد مهم را نشان می‌دهد. به طور پیش‌فرض فعال است؛ کلید باقی می‌ماند.

شمارنده‌ها

بالای بدنه گزارش شمارنده‌های زنده می‌بینید:

  • کل — همه رویدادهای قابل مشاهده
  • ارسال شده — ارسال‌های موفق
  • هشدارها — هشدارها
  • خطاها — خطاها

صادرات

  • خروجی TXT — متن ساده، یک رویداد در هر خط
  • خروجی CSV — ساختاریافته با مهر زمانی، سطح، نوع، پرچم سکوت، حساب، پیام. UTF-8 BOM برای اکسل.

کپی همه

همه رویدادهای فیلتر شده را در همان فرمت TXT در کلیپ‌بورد کپی می‌کند. مفید برای جای‌گذاری در یک تیکت پشتیبانی.

پاک کردن

برای پاک کردن بافر قابل مشاهده و لیست در حافظه روی پاک کردن کلیک کنید. گزارش فایل روی دیسک (data/logs/app.log) تحت تأثیر قرار نمی‌گیرد.

نکته برای عیب‌یابی

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

تنظیمات

تمام پیکربندی جهانی در یک صفحه.

عمومی

تنظیمتوضیحات
زبان۲۵ زبان رابط کاربری. تغییر باعث بارگیری مجدد کامل برنامه می‌شود.
تمسیستم / تیره / روشن. فوراً بدون بارگیری مجدد اعمال می‌شود.

پروکسی جهانی

یک پروکسی واحد که توسط همه حساب‌هایی که پروکسی خود را ندارند استفاده می‌شود. فیلدها: نوع (SOCKS5 / SOCKS4 / HTTP)، میزبان، پورت، نام کاربری و رمز عبور اختیاری.

  • ذخیره — در پیکربندی می‌نویسد
  • تست — IP خارجی شما را از طریق این پروکسی با api.ipify.org بررسی می‌کند. نتیجه به صورت توست ظاهر می‌شود.
  • پاک کردن — همه فیلدها را بازنشانی کرده و پروکسی جهانی را حذف می‌کند

پنجره زمانی جهانی

یک پنجره ارسال واحد که برای هر تبلیغ و کمپین در سراسر حساب اعمال می‌شود. وقتی فعال باشد تنظیمات هر تبلیغ را نادیده می‌گیرد.

شروع خودکار

  • شروع خودکار همه تبلیغات پس از مجاز کردن — وقتی یک حساب مجاز می‌شود، هر تبلیغی که دارد فوراً شروع می‌شود

بررسی سلامت نشست

در بخش بررسی سلامت نشست به تفصیل پوشش داده شده است:

  • فعال کردن در زمان راه‌اندازی
  • فاصله بررسی خودکار (دقیقه، ۰ = غیرفعال)
  • احراز هویت مجدد خودکار نشست‌های مرده

اعلان‌های تلگرام

به بخش اختصاصی زیر مراجعه کنید.

لایسنس

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

داده‌ها و گزارش‌ها

  • آمار ذخیره‌سازی — حجم کل داده، شمارنده حساب‌ها، گیرندگان، کمپین‌ها
  • باز کردن پوشه گزارش‌ها — data/logs/ را در مدیر فایل شما باز می‌کند
  • صادرات پشتیبان — پروفایل کامل به ZIP
  • ورود پشتیبان — بازیابی از ZIP با یک پنجره پیش‌نمایش
  • بررسی به‌روزرسانی‌ها — بررسی دستی به‌روزرسانی
  • اشکال‌زدایی — یک دامپ JSON از وضعیت زیرسیستم به‌روزرسانی را نشان می‌دهد (مفید برای پشتیبانی)

منطقه خطر

  • بازنشانی تنظیمات — پروکسی، پنجره زمانی، شروع خودکار، بررسی نشست و تنظیمات اعلان را به حالت پیش‌فرض پاک می‌کند
  • پاک کردن حساب‌ها — هر حساب و نشست آن را حذف می‌کند. ابتدا یک پنجره تأیید.

اعلان‌های تلگرام

گزارش‌های کمپین را مستقیماً در تلگرام دریافت کنید — به پیام‌های ذخیره شده یا هر چتی.

فعال‌سازی

1 "فعال کردن اعلان‌ها" را علامت بزنید

در تنظیمات، زیر کارت اعلان‌های تلگرام.

2 هدف را انتخاب کنید
  • پیام‌های ذخیره شده — امن‌ترین و ساده‌ترین
  • هر چت — یک انتخابگر با تمام دیالوگ‌های شما باز می‌شود، با جستجو
3 رویدادها را انتخاب کنید
  • شروع — به طور پیش‌فرض خاموش
  • تکمیل — به طور پیش‌فرض روشن، شامل آمار
  • توقف — به طور پیش‌فرض روشن، شامل دستی و خودکار
  • خطا — به طور پیش‌فرض روشن، شامل PEER_FLOOD، floods، خطاهای متوالی

تست

روی ارسال اعلان آزمایشی کلیک کنید. از اولین حساب مجاز استفاده می‌کند و یک پیام آزمایشی به هدف انتخاب شده شما ارسال می‌کند. اگر هیچ حساب مجازی وجود نداشته باشد، یک خطای واضح دریافت می‌کنید.

رویدادهای تحویل داده شده

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

✅ ارسال تکمیل شد

📣 کمپین: تبلیغ
📤 ارسال شده: ۴۵
❌ خطاها: ۲

⏱ مدت زمان: ۱۲ دقیقه
🕐 ۱۴:۳۰ — ۱۴:۴۲
اعلان‌ها نمی‌رسند — چه چیزی را بررسی کنیم

(۱) پرچم فعال کردن روشن است، (۲) حداقل یک رویداد علامت‌گذاری شده است، (۳) حساب مجاز است، (۴) اگر یک چت خاص را انتخاب کرده‌اید، حساب شما می‌تواند در آن بنویسد (برخی کانال‌ها به غیر ادمین‌ها اجازه پیام نمی‌دهند).

آیا اعلان‌ها از حساب من ارسال می‌شوند؟

بله. هر اعلان از طریق حساب فعلی ارسال می‌شود. گزارش‌ها در پیام‌های ذخیره شده همان حساب (یا چت انتخاب شده) ظاهر می‌شوند.

پشتیبان‌گیری کامل پروفایل v4.0

یک کلیک برای صادرات همه چیز: پیکربندی، پایگاه داده، نشست‌ها، تبلیغات، کمپین‌ها و آمار به عنوان یک فایل ZIP.

چه چیزی گنجانده شده است

  • config.json — تمام تنظیمات، کش کلید لایسنس
  • autoposter.db — حساب‌ها، گیرندگان، تبلیغات، استوری‌ها، مشترکین، قالب‌ها، قوانین پاسخ خودکار، آمار
  • sessions/*.session — فایل‌های نشست تلگرام (اختیاری، به زیر مراجعه کنید)
  • templates/ — هر داده پوشه قالب

چه چیزی حذف شده است

  • logs/ — فایل‌های گزارش
  • exports/ — فایل‌های CSV صادر شده
  • backups/ — نسخه‌های پشتیبان قدیمی
  • فایل‌های موقت SQLite WAL/SHM

صادرات

1 تنظیمات → صادرات پشتیبان

یک پنجره با یک چک‌باکس اختیاری "شامل نشست‌ها" ظاهر می‌شود.

2 انتخاب کنید که آیا نشست‌ها گنجانده شوند
  • علامت‌گذاری شده — بازیابی کامل امکان‌پذیر است، نیازی به احراز هویت مجدد نیست. نشست‌ها حساس هستند — ZIP را ایمن نگه دارید.
  • علامت‌گذاری نشده — اشتراک‌گذاری ایمن. در بازیابی، باید هر حساب را با QR دوباره مجاز کنید.
3 محل ذخیره

نام فایل پیش‌فرض: tgautoposter_backup_20261016_143052.zip. پیشرفت در گزارش رویداد ثبت می‌شود.

واردات

1 تنظیمات → ورود پشتیبان

انتخابگر فایل باز می‌شود. ZIP را انتخاب کنید.

2 پیش‌نمایش مانیفست

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

3 تأیید کنید

برنامه یک نسخه پشتیبان ایمنی خودکار از وضعیت فعلی شما ایجاد می‌کند (data/backups/before_import_*.zip)، سپس ZIP را روی آن بازیابی می‌کند.

4 راه‌اندازی مجدد

یک پنجره تأیید پیشنهاد می‌دهد فوراً برنامه را دوباره بارگیری کنید.

با فایل‌های ZIP پشتیبان مانند رمز عبور رفتار کنید

اگر آرشیو شامل نشست‌ها باشد، هر کسی که ZIP را داشته باشد می‌تواند به حساب‌های تلگرام شما وارد شود. آن را رمزنگاری شده (7-Zip، VeraCrypt) ذخیره کنید یا روی یک رسانه فیزیکی امن نگه دارید.

پشتیبان ایمنی خودکار

قبل از هر واردات، برنامه یک نسخه پشتیبان کامل از پروفایل فعلی شما ایجاد می‌کند. اگر مشکلی پیش آمد، می‌توانید آن را از data/backups/before_import_*.zip بازیابی کنید.

به‌روزرسانی‌ها

برنامه در زمان راه‌اندازی نسخه‌های جدید را بررسی می‌کند و در صورت وجود، پنجره تاریخچه تغییرات را ارائه می‌دهد.

بررسی خودکار

۲.۵ ثانیه پس از راه‌اندازی، یک درخواست کوچک به سرور به‌روزرسانی می‌رود. اگر نسخه جدیدتری وجود داشته باشد، یک پنجره تاریخچه تغییرات با موارد دسته‌بندی شده (ویژگی‌ها، اصلاحات، بهبودها، امنیت) ظاهر می‌شود.

پنجره به‌روزرسانی

  • دانلود — صفحه دانلود را در مرورگر شما باز می‌کند
  • یادآوری بعداً — پنجره بسته می‌شود، در راه‌اندازی بعدی دوباره نشان داده می‌شود
  • رد کردن این نسخه — هرگز این نسخه خاص را دوباره نشان نده (اگر نسخه جدیدتری منتشر شود، پنجره برمی‌گردد)
به‌روزرسانی‌های اجباری

به‌روزرسانی‌های بحرانی (امنیتی یا سازگاری) بدون دکمه‌های "یادآوری بعداً" / "رد کردن" نشان داده می‌شوند — برای ادامه باید آن‌ها را دانلود و نصب کنید.

بررسی دستی

دو راه:

  • آیکون دانلود در نوار بالا
  • تنظیمات → داده‌ها و گزارش‌ها → بررسی به‌روزرسانی‌ها

اطلاعات اشکال‌زدایی

تنظیمات → اشکال‌زدایی یک دامپ JSON با نسخه فعلی شما، پاسخ سرور و اینکه آیا به‌روزرسانی فعال می‌شود یا خیر را نشان می‌دهد. مفید هنگام باز کردن یک تیکت پشتیبانی.

آیا به‌روزرسانی‌ها خودشان نصب می‌شوند؟

هنوز نه. برنامه صفحه دانلود را باز می‌کند — شما نسخه جدید را به صورت دستی نصب می‌کنید. به‌روزرسانی خودکار بی‌صدا برای AutoPoster Cloud برنامه‌ریزی شده است.

آیا هنگام به‌روزرسانی داده‌هایم را از دست می‌دهم؟

خیر. پوشه data/ شما دست‌نخورده باقی می‌ماند. فقط EXE / DMG را جایگزین کنید.

اگر سرور به‌روزرسانی خراب باشد چه؟

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

داده‌ها و پوشه‌ها

همه چیز در یک پوشه ذخیره می‌شود. آن را درک کنید و برنامه را درک می‌کنید.

مکان‌های پوشه

پلتفرممسیر
ویندوز<folder with EXE>/data/
مک~/Library/Application Support/TG AutoPoster Pro/

داخل چه چیزی است

فایل / پوشههدف
config.jsonتمام تنظیمات، کش لایسنس، پیکربندی session_check، اعلان‌ها، پروکسی جهانی
autoposter.dbپایگاه داده SQLite — حساب‌ها، گیرندگان، گروه‌ها، تبلیغات، استوری‌ها، مشترکین، قالب‌ها، قوانین پاسخ خودکار، رویدادهای آماری
sessions/نشست‌های تلگرام رمزنگاری شده، یکی برای هر حساب. هرگز این فایل‌ها را به اشتراک نگذارید.
logs/app.log (چرخشی، ۵ مگابایت × ۳ فایل) و crash.log (فقط در صورت خرابی ایجاد می‌شود)
backups/پشتیبان‌گیری خودکار: عکس‌های فوری config.json و ZIPهای قبل از واردات
exports/پوشه ذخیره پیش‌فرض برای خروجی‌های CSV / TXT / ZIP
.migrated_v4فایل نشانگر — نشان می‌دهد مهاجرت داده‌های قدیمی اجرا شده است

پشتیبان‌گیری خودکار

هر بار که تنظیمات یا یک کمپین را ذخیره می‌کنید، config.json قبلی با یک مهر زمانی در backups/ کپی می‌شود. فقط ۵ مورد اخیر نگه داشته می‌شوند.

بازیابی دستی یک نسخه پشتیبان پیکربندی

  1. برنامه را ببندید
  2. data/backups/ را باز کنید و کپی مورد نظر خود را پیدا کنید
  3. نام آن را به config.json تغییر دهید و آن را با نسخه فعلی جایگزین کنید
  4. برنامه را دوباره راه‌اندازی کنید
قبل از تغییرات بزرگ — پشتیبان‌گیری کنید

قبل از تغییر حساب‌ها، نصب مجدد یا انتقال به یک کامپیوتر جدید — یک ZIP پروفایل کامل صادر کنید یا کل پوشه data/ را به یک مکان امن کپی کنید.

مهاجرت به یک کامپیوتر جدید

  1. کل پوشه data/ (یا معادل مک) را به یک درایو USB کپی کنید
  2. برنامه را در کامپیوتر جدید نصب کنید
  3. یک بار آن را ببندید (تا پوشه خالی data/ را ایجاد کند)
  4. پوشه جدید data/ را با پوشه‌ای از درایو USB جایگزین کنید
  5. راه‌اندازی کنید — همه چیز حفظ می‌شود

رفع مشکلات

پاسخ‌های سریع به رایج‌ترین مسائل.

برنامه در ویندوز اجرا نمی‌شود

به احتمال زیاد Windows Defender / SmartScreen آن را مسدود می‌کند. روی EXE کلیک راست کنید → Properties → در پایین تب General کادر Unblock را علامت بزنید. اگر کمکی نکرد — در Windows Security یک استثنا اضافه کنید. یک بار به عنوان Administrator اجرا کنید.

برنامه در مک اجرا نمی‌شود ("app is damaged")

Terminal را باز کنید و اجرا کنید: xattr -cr /Applications/TelegramAutoPoster.app — این پرچم قرنطینه را پاک می‌کند. سپس دوباره اجرا کنید.

کد QR اسکن نمی‌شود یا کد پیامک هرگز نمی‌رسد

بررسی کنید که گوشی شما به اینترنت دسترسی دارد و تلگرام به‌روز است. اگر پروکسی تنظیم شده است — آن را با دکمه "تست پروکسی" تأیید کنید. گاهی اوقات تلگرام موقتاً کدها را محدود می‌کند؛ ۵ دقیقه صبر کنید و دوباره امتحان کنید.

لیست گیرندگان پس از بازخوانی خالی است

یعنی برنامه هیچ چتی که در آن حق پست داشته باشید پیدا نکرد. بررسی کنید: (۱) حساب عضو برخی گروه‌ها باشد، (۲) در آن گروه‌ها می‌توانید پیام ارسال کنید، (۳) برای کانال‌ها، حق ادمین با post_messages دارید.

خطاهای FloodWait در هر ارسال

تلگرام نرخ حساب را محدود می‌کند. تأخیر بین پیام‌ها را افزایش دهید (تب زمان‌بندی). ۲۴–۴۸ ساعت صبر کنید و با حجم کمتر ادامه دهید. استفاده از چندین حساب برای توزیع بار را در نظر بگیرید.

خطای "Peer flood"

قوی‌ترین هشدار ضد اسپم تلگرام. کمپین به طور خودکار متوقف می‌شود. فوراً آن را دوباره راه‌اندازی نکنید — ۲۴–۴۸ ساعت صبر کنید. اگر تکرار شد، حساب ممکن است برای همیشه محدود شود.

بررسی لایسنس با شکست مواجه می‌شود — "Network error"

اینترنت یا ISP شما سرور ما را مسدود می‌کند. برنامه تا ۳۰ روز دوره مهلت آفلاین دارد — می‌توانید به کار خود ادامه دهید. اگر فراتر از آن تکرار شد، یک پروکسی در تنظیمات → پروکسی جهانی پیکربندی کنید.

وضعیت حساب به طور ناگهانی "غیرمجاز" را نشان می‌دهد

تلگرام نشست را لغو کرد. نادر است، اما اگر از دستگاه‌های زیادی وارد شده باشید، نشست‌ها را در تلگرام بازنشانی کرده باشید یا شخص دیگری به حساب دسترسی پیدا کرده باشد، رخ می‌دهد. فقط دوباره روی "مجاز کردن" کلیک کنید.

اعلان‌ها در تلگرام نمی‌رسند

بررسی کنید: (۱) در تنظیمات فعال شده باشد، (۲) حداقل یک رویداد علامت‌گذاری شده باشد، (۳) چت انتخاب شده یکی باشد که حساب شما می‌تواند در آن بنویسد، (۴) حساب مجاز باشد. اگر همه چیز خوب به نظر می‌رسد — گزارش رویداد را برای خطاها بررسی کنید.

برنامه کند است / با حساب‌های زیاد تأخیر دارد

عملکرد زمانی کاهش می‌یابد که ۳۰+ حساب فعالانه ارسال می‌کنند. امتحان کنید: (۱) بستن بخش‌های استفاده نشده، (۲) اجرای همزمان چندین کمپین با فرکانس بالا، (۳) بررسی استفاده از CPU/RAM در Task Manager.

چگونه ببینم چه چیزی اشتباه پیش رفته — گزارش کامل

گزارش رویداد را باز کنید، حالت سکوت را غیرفعال کنید و مشکل را بازتولید کنید. گزارش را کپی کنید (دکمه کپی همه) و آن را در تلگرام @igor_shelloff برای ما ارسال کنید. یا به عنوان TXT صادر کنید.

از کجا می‌توانم کمک بگیرم؟

در تلگرام با ما تماس بگیرید: @igor_shelloff — معمولاً در چند ساعت پاسخ می‌دهد. شامل: کاری که انجام دادید، چه اتفاقی افتاد، و گزیده گزارش مربوطه.