Dokumentasi
Pusat Pembelajaran

Kuasai Telegram Bot App dengan panduan, tutorial, dan dokumentasi yang lengkap

Tautan Cepat

Perlindungan Flood dan Raid

Pengantar

Perlindungan flood dan raid melindungi grup dari dua masalah yang saling berkaitan: satu anggota mengirim pesan lebih cepat daripada yang bisa dibaca siapa pun, dan gelombang akun yang masuk secara terkoordinasi sekaligus untuk membanjiri chat. Keduanya ditangani secara otomatis, tetapi hanya setelah admin mengaktifkannya. Setiap fitur yang dijelaskan di sini nonaktif secara default dan tidak akan mengambil tindakan apa pun sampai diaktifkan untuk grup, jadi menambahkan bot tidak akan pernah mengubah perilaku chat Anda sampai Anda memutuskan demikian.

Kedua sistem ini bekerja pada titik yang berbeda. Anti-flood memantau tiap anggota saat mereka mengirim pesan. Anti-raid memantau laju anggota baru bergabung. Bersama dengan kontrol manual /panic dan pemeriksaan penyalahguna yang sudah dikenal saat bergabung, fitur-fitur ini memberi admin cara untuk menjaga grup tetap terbaca selama lonjakan spam dan menutup pintu saat terjadi serangan terkoordinasi.

Anti-flood: kecepatan pesan

Anti-flood membatasi berapa banyak pesan yang dapat dikirim oleh satu anggota non-admin dalam jendela waktu singkat. Fitur ini dikendalikan oleh tiga pengaturan di dasbor grup:

  • set_antiflood_enabled — tombol aktif/nonaktif. Nonaktif secara default.
  • set_antiflood_msgs — batas pesan. Default 8.
  • set_antiflood_secs — panjang jendela dalam detik. Default 5.

Dengan pengaturan default, anggota yang mengirim lebih dari 8 pesan dalam jendela 5 detik akan melewati batas. Bot menghitung pesan tiap anggota dalam jendela bergulir singkat; ketika jumlahnya melewati batas, pesan-pesan yang membentuk lonjakan tersebut dihapus dan penindakan dimulai.

Penindakan meningkat secara bertahap. Pertama kali seorang anggota melakukan flood, bot menerapkan mute sementara selama 5 menit. Jika anggota yang sama melakukan flood lagi tidak lama setelahnya, bot akan mem-banned mereka. Artinya, kesalahan satu kali hanya berakibat mute singkat, sedangkan anggota yang terus melakukan flood akan dikeluarkan.

Dua aturan menjaga ini tetap adil dan aman:

  • Admin dikecualikan. Pemeriksaan kecepatan hanya berjalan untuk anggota non-admin, jadi moderator dan admin tidak akan pernah di-mute atau di-ban oleh anti-flood.
  • Gagal secara terbuka. Penghitung berjalan pada penyimpanan dalam memori yang cepat. Jika penyimpanan tersebut mengembalikan error sementara, bot membiarkan pesan lewat alih-alih menghukumnya. Masalah infrastruktur sementara tidak akan pernah menyebabkan mute atau ban yang tidak adil.

Anti-flood berjalan pada jalur cepat per pesan, sehingga bereaksi saat pesan masuk, sebelum pemeriksaan konten yang lebih berat. Karena ambang batas dan jendelanya dapat dikonfigurasi, Anda bisa menyesuaikannya dengan ritme normal grup Anda — chat yang ramai mungkin membutuhkan batas pesan lebih tinggi, sementara channel pengumuman yang sepi mungkin membutuhkan aturan yang lebih ketat.

Anti-raid: penguncian saat lonjakan anggota bergabung

Anti-raid memantau seberapa cepat anggota baru bergabung. Fitur ini dikendalikan oleh empat pengaturan:

  • set_antiraid_enabled — tombol aktif/nonaktif. Nonaktif secara default.
  • set_antiraid_joins — batas bergabung. Default 10.
  • set_antiraid_secs — jendela dalam detik. Default 30.
  • set_antiraid_lockdown_secs — durasi penguncian. Default 600 detik (10 menit).

Dengan pengaturan default, lebih dari 10 anggota yang bergabung dalam 30 detik akan memicu penguncian. Saat itu terjadi, bot mengunci seluruh grup dengan menghapus izin chat default, sehingga anggota tidak bisa lagi mengirim pesan. Penguncian tetap berlaku selama periode penguncian lalu dilepas secara otomatis, mengembalikan izin normal grup.

Penguncian ini adalah jeda, bukan pembersihan. Ini menghentikan banjir akun baru agar tidak bisa mengirim pesan saat lonjakan berlangsung, memberi admin waktu untuk melihat apa yang sedang terjadi. Ketika timer berakhir, grup terbuka kembali dengan sendirinya. Seperti anti-flood, penghitung anggota bergabung gagal secara terbuka — error sementara saat menghitung anggota yang bergabung tidak akan pernah memicu penguncian secara keliru.

Kunci manual: /panic dan /unpanic

Admin dapat mengunci grup secara manual kapan saja, bahkan ketika deteksi raid otomatis dimatikan:

  • /panic — langsung mengunci grup selama jendela penguncian yang dikonfigurasi. Anggota tidak dapat mengirim pesan sampai kunci dilepas atau admin membukanya.
  • /unpanic — melepas kunci lebih awal dan mengizinkan anggota mengirim pesan lagi.

Kedua perintah hanya untuk admin; non-admin yang menjalankannya akan ditolak. /panic berguna ketika Anda melihat masalah mulai terjadi dan ingin menutup grup sebelum ambang otomatis tercapai, atau ketika Anda membiarkan deteksi otomatis mati tetapi tetap menginginkan tombol darurat satu perintah.

Mengeluarkan penyalahguna yang dikenal saat bergabung

Pengaturan set_kick_known_abusers (nonaktif secara default) memeriksa setiap anggota baru terhadap sinyal intelijen pengguna bersama milik jaringan. Akun yang sudah ditandai sebagai penyalahguna yang dikenal di tempat lain dalam jaringan membawa penanda global. Ketika pengaturan ini aktif dan akun yang ditandai bergabung, bot langsung mem-banned akun tersebut sebelum sempat mengirim pesan.

Pemeriksaan ini juga gagal secara terbuka: jika pencarian penyalahguna mengalami error, bot memperlakukan anggota yang bergabung sebagai bersih dan mengizinkannya masuk, sehingga masalah pencarian tidak akan pernah mem-banned anggota sah. Ketika penyalahguna yang dikenal di-ban dengan cara ini, peristiwanya dicatat di log moderasi grup jika ada yang dikonfigurasi.

Cara penguncian berkoordinasi dengan mode malam

Anti-raid dan mode malam sama-sama bekerja dengan mengunci izin mengirim grup, jadi keduanya berbagi kunci dasar yang sama. Kedua fitur ini berkoordinasi agar yang satu tidak pernah membuka grup ketika yang lain masih ingin grup tetap tertutup. Jika penguncian raid berakhir saat jendela tenang mode malam masih aktif, grup tetap terkunci untuk mode malam; jika jendela mode malam berakhir saat penguncian raid masih berjalan, grup tetap terkunci untuk raid. Grup baru akan terbuka kembali setelah tidak ada fitur yang perlu menutupnya.

Praktik terbaik

  • Mulailah dengan ambang default dan sesuaikan hanya jika Anda melihat pemicu palsu atau kejadian yang terlewat. Default cocok untuk sebagian besar grup.
  • Ingat /panic sebagai cadangan manual meskipun Anda mengaktifkan deteksi raid otomatis — ini adalah cara tercepat untuk membekukan grup.
  • Aktifkan pemeriksaan penyalahguna yang dikenal untuk grup publik yang bisa diikuti siapa saja; ini menghentikan pelanggar berulang sebelum mereka mengirim pesan.
  • Ingat bahwa admin tidak pernah terpengaruh oleh anti-flood, jadi uji fitur ini dengan akun non-admin jika Anda ingin melihatnya bekerja.

Ringkasan

Perlindungan flood dan raid memberi admin kontrol berlapis: anti-flood menangani satu anggota yang terlalu berisik dengan penghapusan, mute, lalu ban; anti-raid menangani lonjakan anggota bergabung dengan kunci grup berbatas waktu; /panic memberi pengambilalihan manual; dan pemeriksaan penyalahguna yang dikenal menghentikan akun yang ditandai sejak di pintu. Semuanya tetap nonaktif sampai Anda mengaktifkannya, semuanya mengecualikan admin jika relevan, dan pemeriksaan otomatis gagal secara terbuka sehingga error sementara tidak akan pernah menghukum anggota yang tidak bersalah.

Ditulis oleh Telegram Bot App team · Terakhir diperbarui June 2026

Artikel Terkait

Blokir Bot Porno Telegram: Panduan Filter Konten NSFW

Hentikan bot porno dan konten dewasa di grup Telegram Anda. Panduan lengkap untuk pemfilteran NSFW, deteksi konten dewasa, dan melindungi komunitas Anda dari gambar yang tidak pantas.

Analisis Sentimen dan Deteksi Toksisitas

Deteksi otomatis perilaku toksik, kata-kata kasar, hinaan, dan ancaman

Intelijen Spam AI dan Penilaian Risiko Pengguna

Analisis perilaku otomatis dan pencegahan spam cerdas dengan penilaian risiko