Perbedaan

Ini menunjukkan perbedaan antara versi yang terpilih dengan versi yang sedang aktif.

--- cuan77:bot_poin [2026/04/24 09:04] – dibuat fakhrun
+++ cuan77:bot_poin [2026/04/24 11:54] (sekarang) – fakhrun
@@ Baris 1: / Baris 1: @@
-====== 🤖 Panduan Lengkap Penggunaan Bot Telegram ======
+====== BOT POINKU ======
-Selamat datang! Halaman ini adalah panduan lengkap untuk menggunakan bot Telegram ini. Tidak perlu khawatir jika Anda bukan orang teknis — panduan ini ditulis dengan bahasa sehari-hari dan disertai contoh nyata.
+===== Perbedaan Mode =====
----
+^ Mode ^ Cara Akses ^ Keunggulan ^
+| **Mode 1** | Pakai password tiap command | Simpel, tidak perlu daftar |
-===== 🗺️ Gambaran Umum: Apa Itu Bot Ini? =====
+| **Mode 2** | ID Telegram didaftarkan admin | Ada sistem member + expired |
+| **Mode 3** | Bebas, siapapun bisa pakai | Ada bypass kode kupon langsung |
-Bot ini adalah **asisten otomatis di Telegram** yang bisa menghasilkan **QR Code dan Barcode** untuk keperluan poin/member/kupon. Bayangkan seperti mesin kasir otomatis — Anda minta, bot langsung kirimkan gambar QR-nya ke chat Anda.
-Bot ini memiliki **3 mode operasional** yang berbeda. Masing-masing mode punya cara kerja dan tingkat keamanan yang berbeda. Admin yang menjalankan bot akan memilih salah satu mode saat menyalakan bot.
-^ Mode ^ Nama ^ Cocok Untuk ^ Tingkat Keamanan ^
-| **Mode 1** | Kode Akses (Password) | Komunitas kecil terpercaya | 🔒 Sedang |
-| **Mode 2** | ID Akses (Berbasis Akun) | Komunitas dengan sistem member | 🔒🔒 Tinggi |
-| **Mode 3** | Bypass (Bebas + Kode Kupon) | Event terbuka / publik | 🔓 Rendah |
 ---
-===== ✅ Perintah Umum (Berlaku di Semua Mode) =====
+===== ⚙️ Mode 1 — Akses Password =====
-Perintah-perintah ini bisa digunakan di semua mode:
+^ Command ^ Fungsi ^
+| ''/start'' | Buka menu utama |
-^ Perintah ^ Fungsi ^
+| ''/help'' | Lihat daftar perintah |
-| ''/start'' | Membuka menu utama dan menyapa bot |
+| ''/scan [password]'' | Generate QR Code baru |
-| ''/help'' | Menampilkan daftar perintah yang tersedia |
+| ''/scan ulang [password]'' | Ulangi QR Code sebelumnya |
-| ''/qris'' | Bot mengirimkan gambar QRIS untuk pembayaran |
+| ''/scn [nomor] [password]'' | Generate QR untuk nomor tertentu |
-| ''/kupon [nama_file] [kode_kupon]'' | Menukar kupon dengan QR Code |
+| ''/potong [nomor] [password]'' | Generate QR + potong poin nomor tertentu |
+| ''/kupon [nama_file] [kode]'' | Tukar kode kupon jadi QR |
----
-===== 📌 MODE 1 — Akses dengan Password =====
-==== 💡 Apa Itu Mode 1? ====
-Mode 1 adalah mode di mana **setiap pengguna harus tahu password** untuk bisa meminta QR Code. Seperti pintu yang butuh kunci — kalau tidak tahu passwordnya, tidak bisa masuk.
-**Kapan pakai Mode 1?**
-  * Komunitas kecil di mana semua anggota dipercaya
-  * Password dibagikan secara manual oleh admin (via chat atau grup tertutup)
-  * Tidak perlu proses pendaftaran yang rumit
-==== 📋 Daftar Perintah Mode 1 ====
-^ Perintah ^ Fungsi ^
-| ''/scan [password]'' | Minta QR Code baru (butuh password) |
-| ''/scan ulang [password]'' | Ulangi QR Code yang sama seperti terakhir |
-| ''/scn [nomor] [password]'' | Minta QR untuk nomor poin tertentu |
-| ''/potong [nomor] [password]'' | Minta QR potong poin untuk nomor tertentu |
-| ''/kupon [nama_file] [kode]'' | Tukar kupon dengan QR Code |
 | ''/qris'' | Tampilkan gambar QRIS |
-| ''/bc [pesan]'' | (Khusus Admin) Kirim pesan ke semua pengguna |
+| ''/bc [pesan]'' | *(Admin)* Broadcast pesan ke semua user |
-==== 🚶 Cara Menggunakan Mode 1 ====
-**Langkah 1:** Pastikan Anda sudah tahu password dari admin.
-**Langkah 2:** Buka chat dengan bot di Telegram.
-**Langkah 3:** Ketik perintah berikut untuk meminta QR Code baru:
-<code>
-/scan passwordkamu
-</code>
-**Langkah 4:** Bot akan membalas dengan gambar QR Code. Gambar ini **akan otomatis terhapus setelah 2 menit**, jadi segera gunakan!
-**Langkah 5:** Jika QR Code tadi gagal di-scan dan ingin mengulang tanpa "menghabiskan" slot berikutnya:
-<code>
-/scan ulang passwordkamu
-</code>
-==== 💬 Contoh Percakapan Mode 1 ====
-<code>
-Pengguna: /scan rahasia123
-Bot:       [Mengirim gambar QR Code]
-           ✅ QR Code berhasil dibuat!
-           (Gambar akan hilang otomatis dalam 2 menit)
-</code>
-<code>
-Pengguna: /scan salahpass
-Bot:       ❌ Password salah atau Anda belum terdaftar.
-</code>
-<code>
-Pengguna: /scan ulang rahasia123
-Bot:       [Mengirim ulang gambar QR Code yang sama]
-</code>
-==== ⚠️ Perhatian Mode 1 ====
-  * Jangan bagikan password ke orang yang tidak berhak
-  * Jika password salah, bot akan menolak dan TIDAK memberikan QR Code
-  * QR Code otomatis hilang dalam **2 menit** — segera screenshot atau gunakan langsung
 ---
-===== 📌 MODE 2 — Akses Berbasis ID Telegram (Sistem Member) =====
+===== ⚙️ Mode 2 — Akses ID Member =====
-==== 💡 Apa Itu Mode 2? ====
+^ Command ^ Fungsi ^
+| ''/start'' | Buka menu utama |
-Mode 2 adalah mode paling canggih. Di sini, **bot mengenali Anda dari akun Telegram Anda** — tidak perlu password setiap kali. Seperti kartu member sebuah toko: sekali didaftarkan, tinggal tunjukkan kartu dan langsung dilayani.
+| ''/help'' | Lihat daftar perintah |
+| ''/regist'' | Daftar ke admin untuk mendapat akses |
-Mode 2 juga punya sistem **masa berlaku member** — admin bisa mengatur sampai tanggal berapa akses Anda aktif, dan sistem akan otomatis menonaktifkan akses yang sudah habis.
+| ''/scan'' | Generate QR Code baru |
+| ''/ulangi'' | Ulangi QR Code sebelumnya |
-**Kapan pakai Mode 2?**
+| ''/scn [nomor]'' | Generate QR untuk nomor tertentu |
-  * Komunitas dengan anggota yang lebih banyak dan terorganisir
+| ''/potong [nomor]'' | Generate QR + potong poin nomor tertentu |
-  * Anda ingin sistem member yang bisa expired/kadaluarsa
+| ''/kupon [nama_file] [kode]'' | Tukar kode kupon jadi QR |
-  * Lebih aman karena akses terikat pada akun Telegram, bukan password yang bisa bocor
-==== 📋 Daftar Perintah Mode 2 ====
-^ Perintah ^ Fungsi ^
-| ''/regist'' | Mendaftarkan diri ke admin untuk mendapatkan akses |
-| ''/scan'' | Minta QR Code baru (otomatis, tidak perlu password) |
-| ''/ulangi'' | Ulangi QR Code terakhir yang dibuat |
-| ''/scn [nomor]'' | Minta QR untuk nomor poin tertentu |
-| ''/potong [nomor]'' | Minta QR potong poin untuk nomor tertentu |
-| ''/kupon [nama_file] [kode]'' | Tukar kupon dengan QR Code |
 | ''/qris'' | Tampilkan gambar QRIS |
-| ''/bc [pesan]'' | (Khusus Admin) Kirim pesan ke semua pengguna |
+| ''/bc [pesan]'' | *(Admin)* Broadcast pesan ke semua user |
-| ''/add_member [id:tanggal]'' | (Khusus Admin) Tambahkan atau perpanjang member |
+| ''/add_member [id:DD-MM-YYYY]'' | *(Admin)* Tambah/perpanjang member |
-==== 🚶 Cara Menggunakan Mode 2 (Sebagai Pengguna Baru) ====
-**Langkah 1:** Buka chat dengan bot dan ketik:
-<code>
-/start
-</code>
-**Langkah 2:** Daftarkan diri Anda dengan ketik:
-<code>
-/regist
-</code>
-Bot akan mengirimkan notifikasi ke admin bahwa Anda ingin mendaftar. Admin kemudian akan memproses permintaan Anda.
-**Langkah 3:** Tunggu konfirmasi dari admin. Biasanya admin akan menghubungi Anda via WhatsApp atau Telegram untuk memberitahu bahwa akses sudah aktif.
-**Langkah 4:** Setelah akses aktif, Anda sudah bisa langsung minta QR Code tanpa perlu password:
-<code>
-/scan
-</code>
-**Langkah 5:** Jika ingin mengulang QR Code terakhir:
-<code>
-/ulangi
-</code>
-==== 🚶 Cara Menambahkan Member (Khusus Admin) ====
-**Format perintah:**
-<code>
-/add_member [ID_Telegram]:[Tanggal_Expired]
-</code>
-**Contoh nyata:**
+**Contoh add_member:**
 <code>
 /add_member 123456789:31-12-2025
 </code>
-Artinya: Pengguna dengan ID ''123456789'' diberikan akses hingga tanggal **31 Desember 2025**.
-> 💡 **Tips:** Tanggal harus dalam format DD-MM-YYYY (hari-bulan-tahun). Contoh: 31-12-2025
-==== 💬 Contoh Percakapan Mode 2 ====
-<code>
-Pengguna: /regist
-Bot:       ✅ Permintaan pendaftaran Anda sudah dikirim ke admin!
-           Silakan hubungi admin via WhatsApp: 6281234567890
-           ID Telegram Anda: 987654321
-           Username: @namaanda
-</code>
-<code>
-(Setelah admin mendaftarkan)
-Pengguna: /scan
-Bot:       [Mengirim gambar QR Code]
-</code>
-<code>
-Pengguna: /scan
-Bot:       ❌ Maaf, Anda belum terdaftar. Silakan gunakan /regist untuk mendaftar.
-</code>
-==== ⚠️ Perhatian Mode 2 ====
-  * Akses **tidak bisa dipindah** ke akun Telegram lain — terikat pada akun Anda
-  * Akses yang sudah **expired akan dihapus otomatis setiap 12 jam**
-  * Jika akses habis, hubungi admin untuk perpanjangan
-  * Admin bisa menggunakan ''/add_member'' untuk memperbarui tanggal kadaluarsa
 ---
-===== 📌 MODE 3 — Bypass (Akses Bebas + Kode Kupon) =====
+===== ⚙️ Mode 3 — Bypass / Akses Bebas =====
-==== 💡 Apa Itu Mode 3? ====
+^ Command ^ Fungsi ^
+| ''/start'' | Buka menu utama |
-Mode 3 adalah mode **paling terbuka** — **siapapun yang chat dengan bot bisa langsung meminta QR Code** tanpa perlu password atau mendaftar terlebih dahulu. Bayangkan seperti mesin vending otomatis di tempat umum — tinggal tekan tombol, langsung keluar.
+| ''/help'' | Lihat daftar perintah |
+| ''/scan'' | Generate QR Code baru (tanpa password/daftar) |
-Mode 3 juga punya fitur istimewa yang tidak ada di mode lain: **kode kupon bypass**. Pengguna cukup mengetik kode kupon langsung di chat (tanpa perlu command /kupon), dan bot akan otomatis mengirimkan QR Code kupon tersebut.
+| ''/ulangi'' | Ulangi QR Code sebelumnya |
+| ''/scn [nomor]'' | Generate QR untuk nomor tertentu |
-**Kapan pakai Mode 3?**
+| ''/potong [nomor]'' | Generate QR + potong poin nomor tertentu |
-  * Event terbuka atau promosi publik
+| ''/kupon [nama_file] [kode]'' | Tukar kode kupon jadi QR |
-  * Tidak ingin repot dengan pendaftaran atau password
-  * Sistem kupon yang mudah digunakan oleh siapa saja
-==== 📋 Daftar Perintah Mode 3 ====
-^ Perintah ^ Fungsi ^
-| ''/scan'' | Minta QR Code baru (langsung, tanpa password) |
-| ''/ulangi'' | Ulangi QR Code terakhir yang dibuat |
-| ''/scn [nomor]'' | Minta QR untuk nomor poin tertentu |
-| ''/potong [nomor]'' | Minta QR potong poin untuk nomor tertentu |
-| ''/kupon [nama_file] [kode]'' | Tukar kupon dengan QR Code (cara lama) |
 | ''/qris'' | Tampilkan gambar QRIS |
-| ''/bc [pesan]'' | (Khusus Admin) Kirim pesan ke semua pengguna |
+| ''/bc [pesan]'' | *(Admin)* Broadcast pesan ke semua user |
-| ''[kode kupon]'' | ⭐ Ketik langsung kode kupon tanpa command! |
+| ''[kode kupon]'' | ⭐ Ketik kode kupon langsung — bot auto kirim QR! |
-==== 🚶 Cara Menggunakan Mode 3 ====
+> ⚠️ Semua QR Code otomatis terhapus dalam **2 menit** setelah dikirim.
-=== Cara A: Minta QR Code Member ===
-**Langkah 1:** Buka chat dengan bot.
-**Langkah 2:** Langsung ketik:
-<code>
-/scan
-</code>
-**Langkah 3:** Bot langsung membalas dengan gambar QR Code. Tidak perlu password, tidak perlu daftar!
-=== Cara B: Tukar Kode Kupon (Fitur Bypass — Mode 3 Eksklusif!) ===
-Ini adalah fitur paling keren di Mode 3. Anda **cukup ketik kode kupon saja** — bot akan otomatis mengenali dan mengirimkan QR Code kupon Anda.
-**Langkah 1:** Dapatkan kode kupon dari admin atau sumber resmi.
-**Langkah 2:** Buka chat dengan bot, lalu **langsung ketik kode kupon** tersebut (tanpa perintah apapun):
-<code>
-PROMO2025ABC
-</code>
-**Langkah 3:** Bot langsung membalas dengan QR Code dan Barcode kupon Anda!
-==== 💬 Contoh Percakapan Mode 3 ====
-**Contoh 1 — QR Code biasa:**
-<code>
-Pengguna: /scan
-Bot:       [Mengirim gambar QR Code Member]
-           ✅ Sukses! QR akan hilang dalam 2 menit.
-</code>
-**Contoh 2 — Kupon bypass (fitur eksklusif!):**
-<code>
-Pengguna: VOUCHER2025XYZ
-Bot:       [Mengirim gambar QR Code Kupon]
-           [Mengirim Barcode Kupon]
-           EXP: 31-12-2025
-</code>
-**Contoh 3 — Kode kupon salah:**
-<code>
-Pengguna: KODE_SALAH_123
-Bot:       (Diam, tidak membalas — kode tidak dikenali)
-</code>
-==== ⚠️ Perhatian Mode 3 ====
-  * Karena bebas akses, **siapapun** yang tahu username bot bisa menggunakan QR Member
-  * Kode kupon yang salah akan **diabaikan** oleh bot (tidak ada pesan error)
-  * QR Code tetap otomatis terhapus dalam **2 menit**
-  * Hanya admin yang bisa broadcast (''/bc'')
 ---
-===== 🆚 Perbandingan Cepat Ketiga Mode =====
+===== 📁 Lokasi Penyimpanan File Kupon =====
-^ Fitur ^ Mode 1 ^ Mode 2 ^ Mode 3 ^
+^ Folder ^ Isi ^ Dipakai di Mode ^
-| Perlu password? | ✅ Ya | ❌ Tidak | ❌ Tidak |
+| ''bot_kupon/'' | File kupon format ''.txt'', dipanggil via ''/kupon [nama_file] [kode]'' | Mode 1, 2, 3 |
-| Perlu daftar dulu? | ❌ Tidak | ✅ Ya | ❌ Tidak |
+| ''bot_kupon_mode3/'' | File kupon khusus bypass — kode diketik langsung di chat | Mode 3 saja |
-| Akses berakhir/expired? | ❌ Tidak | ✅ Bisa diatur | ❌ Tidak |
+| ''bot_config/'' | Konfigurasi bot (password, admin ID, ''qris.jpg'', dll) | Semua mode |
-| Bypass kode kupon langsung? | ❌ Tidak | ❌ Tidak | ✅ Ya! |
+| ''bot_qrmember/'' | Data file member/poin utama (diinput saat bot dijalankan) | Semua mode |
-| Perintah /ulangi? | ✅ Ya (via /scan ulang) | ✅ Ya | ✅ Ya |
-| Siapapun bisa akses? | ❌ Hanya yang tahu password | ❌ Hanya yang terdaftar | ✅ Semua orang |
-| Tingkat keamanan | 🔒 Sedang | 🔒🔒 Tinggi | 🔓 Rendah |
----
+**Format file di ''bot_kupon/'':**
+  * Nama file = parameter ''[nama_file]'' yang diketik di command
+  * Contoh: ''/kupon promo2025 KODE123'' → bot membaca file ''bot_kupon/promo2025.txt''
-===== ❓ Pertanyaan Umum (FAQ) =====
+**Format file di ''bot_kupon_mode3/'':**
+  * Setiap baris berisi ''[nama_file]:[kode_kupon]''
-==== Q: QR Code saya tidak muncul, apa yang terjadi? ====
+  * Contoh isi file: ''promo2025:KODE123''
-A: Coba beberapa hal berikut:
+  * User cukup ketik ''KODE123'' di chat → bot otomatis menemukan file kuponnya
-  - Pastikan koneksi internet Anda stabil
-  - Coba kirim perintah lagi setelah beberapa detik
-  - Jika di Mode 1/2, pastikan password/akses Anda benar
-  - Hubungi admin jika masalah berlanjut
-==== Q: QR Code saya sudah menghilang, bagaimana cara mendapatkan ulang? ====
-A: Gunakan perintah ''/scan ulang'' (Mode 1) atau ''/ulangi'' (Mode 2 & 3). Ini akan mengirim ulang QR Code untuk nomor yang sama tanpa menghabiskan slot baru.
-==== Q: Saya di Mode 2 dapat pesan "belum terdaftar", padahal sudah /regist. ====
-A: Proses pendaftaran memerlukan persetujuan manual dari admin. Hubungi admin untuk memastikan akun Anda sudah ditambahkan ke sistem.
-==== Q: Saya mengetik kode kupon di Mode 3 tapi tidak ada respons. ====
-A: Kemungkinan kode kupon tidak ditemukan dalam database. Pastikan kode yang Anda ketik sudah benar (perhatikan huruf besar/kecil dan spasi). Hubungi admin untuk verifikasi.
-==== Q: Apa itu /potong? ====
-A: ''/potong'' adalah perintah untuk generate QR Code yang sekaligus **memotong/menggunakan poin** dari akun. Berbeda dengan ''/scn'' yang hanya generate QR tanpa memotong poin.
-==== Q: Saya adalah admin. Bagaimana cara broadcast pesan? ====
-A: Gunakan perintah ''/bc'' diikuti pesan Anda. Pisahkan baris dengan tanda ''|''. Contoh:
-<code>
-/bc Halo semuanya!|Promo hari ini 50% off.|Jangan lupa scan QR ya!
-</code>
-Atau, balas (reply) ke sebuah pesan/foto lalu ketik ''/bc'' untuk mem-broadcast pesan tersebut.