تلگرام

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

راه‌اندازی بات

1. در تلگرام با @BotFather صحبت کنید، /newbot را بفرستید و توکنی را که می‌دهد کپی کنید.
2. آن را در توکن بات بچسبانید. برای پنل یک بات جداگانه استفاده کنید: وقتی چتی در حال جفت شدن است پنل پیام‌های بات را می‌خواند، و برنامه‌ی دیگری که همان بات را بخواند زودتر آن‌ها را برمی‌دارد.
3. اگر این سرور نمی‌تواند به api.telegram.org برسد (در بعضی کشورها مسدود است)، یکی از این‌ها را پر کنید:
   • پراکسی: socks5://host:port یا http://host:port. نام کاربری و گذرواژه درون آدرس می‌آیند: socks5://user:pass@host:port.
   • آدرس Bot API: یک سرور Telegram Bot API که خودتان جایی اجرا می‌کنید که به تلگرام دسترسی دارد، به‌جای پراکسی.
4. سرویس روشن را روشن کنید، ذخیره کنید و آزمایش را بزنید. آزمایش از مقدار ذخیره‌شده استفاده می‌کند، پس اول ذخیره کنید.

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

جفت کردن یک چت

1. جفت کردن چت.
2. حسابی را انتخاب کنید که چت اعلان‌هایش را می‌گیرد.
3. زبان اعلان‌هایش را انتخاب کنید.
4. رویدادهایش را انتخاب کنید: هرچه این حساب اجازهٔ دیدنش را دارد (که رویدادهایی را که نسخه‌های بعدی اضافه می‌کنند هم شامل می‌شود)، یا تیکش را بردارید و انتخاب کنید. رویدادی که حساب نمی‌تواند ببیند خاکستری است؛ چتش هرگز آن را دریافت نمی‌کند.
5. گرفتن کد.

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

• یک لینک و یک QR کد: آن را در تلگرامِ حسابی که باید اعلان‌ها را بگیرد باز کنید و Start را بزنید؛
• خود کد، برای اینکه دستی به بات بفرستید؛
• برای یک گروه، افزودن بات به گروه که اجازه می‌دهد گروه را انتخاب کنید و کد را آنجا می‌فرستد، یا خط /start@yourbot CODE برای فرستادن در گروهی که بات از قبل در آن است.

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

WARNING

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

هر حساب چت خودش را جفت می‌کند

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

چه چیزی می‌رسد

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

رویداد	کی
user.quota_warning، user.expiring	حسابی به سقف ترافیک یا تاریخش نزدیک است
user.disabled	حسابی به خاطر ترافیک یا تاریخ خاموش شده
node.disconnected، node.connected	نودی پاسخ دادن را متوقف یا شروع کرده
node.disk_high، node.memory_high	دیسک یا حافظه‌ی یک نود از آستانه‌اش گذشته
panel.backup_failed، panel.backup_upload_failed	یک پشتیبان یا بارگذاری‌اش شکست خورده
admin.login_new_ip	حسابی از یک آدرس تازه وارد شده

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

فهرست چت‌ها

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

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

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

فرمان‌ها

در یک چت جفت‌شده:

فرمان	پاسخ
/status	یک خلاصه: حساب‌ها بر اساس وضعیت و آنلاین‌های فعلی (نماینده فقط مال خودش) و برای مدیران اصلی و اپراتورها، نودها
/user name	یک حساب: ترافیک، انقضا، آنلاین بودن (نماینده فقط مال خودش)
/node name	یک نود (مدیران اصلی و اپراتورها)

در گروه، نام بات را اضافه کنید: /user@yourbot name. فرمان‌ها فقط می‌خوانند؛ هیچ چیزی در چت نمی‌تواند پنل را تغییر دهد. به چتی که با نماینده‌ای جفت شده که حسابش منقضی شده، همین گفته می‌شود.

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

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

مرتبط

• مقصدهای بکاپ: هر پشتیبان را با همین بات به یک چت بفرستید.
• ایمیل: همین اعلان‌ها با ایمیل.
• وب‌هوک‌ها و رویدادها: آستانه‌های پشت هشدارهای نود و حساب.
• فهرست رویدادها: همه‌ی رویدادها.