Perbedaan

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

--- cuan77:bot_tele_poin [2026/01/31 13:47] – fakhrun
+++ cuan77:bot_tele_poin [2026/01/31 13:55] (sekarang) – fakhrun
@@ Baris 1: / Baris 1: @@
-====== BOT TELEGRAM – MODE 3 (SIMPEL AKSES) ======
+====== Panduan Penggunaan Skrip Bot Telegram (MODE 1 / MODE 2 / MODE 3) ======
-Mode 3 adalah mode bot Telegram paling sederhana tanpa sistem akses, tanpa registrasi, dan tanpa validasi user.
+Dokumen ini menjelaskan secara praktis bagaimana menyiapkan dan memakai skrip bot Telegram yang sudah obfuscated.
-Pengguna cukup mengirim **kode kupon** dan bot akan langsung mengirim QR + Barcode secara otomatis.
+Dokumen **tidak** mengandung nama fungsi atau potongan kode internal — hanya panduan konfigurasi dan operasi.
 ----
-===== 1. Pemilihan Mode =====
+===== 1. Ringkasan Mode =====
-Pada saat aplikasi dijalankan, akan muncul menu berikut:
+* **Mode 1 — KODE AKSES**
+  Akses berdasarkan kode yang diberikan kepada user. Cocok untuk distribusi terbatas.
-<code>
+* **Mode 2 — ID AKSES**
-[1] KODE AKSES
+  Akses berdasarkan daftar ID Telegram. Cocok untuk kontrol internal.
-[2] ID AKSES
-[3] SIMPEL AKSES
-</code>
-Untuk menggunakan **BOT KUPON MODE 3**, pilih:
+* **Mode 3 — SIMPEL (BYPASS)**
+  Tanpa validasi; user cukup mengirim teks (kode kupon) dan bot akan menukarkan jika cocok.
-<code>
-SELECT MENU : 3
-</code>
-Mode ini akan menjalankan fungsi:
-<code>
-mode3_bypass_akses()
-</code>
 ----
-===== 2. Karakteristik Mode 3 =====
+===== 2. Struktur Folder & File yang Harus Disiapkan =====
-^ Fitur ^ Keterangan ^
+Minimal struktur yang direkomendasikan:
-| Registrasi user | Tidak diperlukan |
-| Kode akses | Tidak ada |
-| Validasi ID | Tidak ada |
-| Akses user | Semua user bebas |
-| Cara pakai kupon | Ketik kode kupon langsung |
-| Jika kode salah | Bot tidak membalas (silent) |
-| Keamanan | Cocok untuk stealth / auto-redeem |
-----
+  * `bottelegramtoken.txt`
+    - Satu token bot per baris.
-===== 3. Struktur Folder Wajib =====
+  * `bot_config/`
+    - `admin_id.txt` (ID admin)
+    - `list_user.txt` (otomatis terisi; daftar user yang berinteraksi)
+    - `nowa_owner.txt` (opsional — nomor WA owner)
+    - `kode_akses.txt` (MODE 1 — daftar kode akses)
+    - `id_akses.txt` (MODE 2 — daftar ID Telegram)
-Agar Mode 3 berjalan normal, **folder dan file berikut WAJIB ada**:
+  * `poinku/`
+    - File per-nomor yang berisi data akun yang digunakan untuk generate QR. (Format baris contoh lihat bagian 5)
-<code>
+  * `bot_kupon/`
-project/
+    - Digunakan untuk mode command (mis. per-file kumpulan kupon berdasarkan kampanye)
-├── bot_kupon_mode3/
-├── poinku/
-├── bot_config/
-│   ├── admin_id.txt
-│   ├── list_user.txt
-│   └── nowa_owner.txt
-├── bottelegramtoken.txt
-└── main.py
-</code>
-----
+  * `bot_kupon_mode3/`
+    - WAJIB untuk MODE 3 — berisi daftar kupon yang dapat ditukarkan melalui plain text
-===== 4. Folder bot_kupon_mode3 =====
+Catatan: beberapa file bersifat opsional tergantung mode yang dipakai.
-Folder ini berisi **database kupon MODE 3**.
-Bot akan membaca seluruh file di folder ini dan mencari kode kupon yang cocok.
-==== Format Data Kupon ====
-Setiap baris **WAJIB menggunakan format berikut**:
-<code>
-NOMOR_POINKU:KODE_KUPON:EXP
-</code>
-==== Contoh Benar ====
-<code>
-628123456789:ABC123:2026-12-31
-628111222333:DEF456:2026-06-30
-628999888777:GIFT999
-</code>
-==== Catatan ====
-  * EXP boleh dikosongkan
-  * Pemisah WAJIB menggunakan tanda titik dua (:)
-  * Urutan data tidak boleh berubah
 ----
-===== 5. Folder poinku =====
+===== 3. Format Data File Penting =====
-Folder ini berisi **akun Poinku yang digunakan untuk generate QR**.
+(Contoh baris — **HANYA** format data, bukan kode)
-==== Nama File ====
+  * **Format file kupon (bot_kupon atau bot_kupon_mode3)**
+    Setiap baris:
+    ```
+    NOMOR_POINKU:KODE_KUPON:EXP
+    ```
+    - `NOMOR_POINKU` = identifier akun (harus ada file terkait di folder `poinku/`)
+    - `KODE_KUPON` = string kupon yang dikirim user
+    - `EXP` = tanggal kadaluarsa (opsional)
-<code>
+  * **Format file akun (poinku/<nomor>.txt)**
-poinku/628123456789.txt
+    Baris pertama harus berisi data akun yang diperlukan untuk generate QR:
-</code>
+    ```
+    NOMOR:PIN:DEVICE_ID:ACCESS_TOKEN:...
+    ```
+    - `PIN` digunakan untuk operasi pemotongan/aktivasi bila ada fitur seperti itu
+    - `DEVICE_ID` dan `ACCESS_TOKEN` harus valid untuk proses pembuatan QR
-==== Format Isi File ====
+  * **Format kode akses (MODE 1 — bot_config/kode_akses.txt)**
+    Satu kode per baris.
-Baris pertama akan dibaca bot:
+  * **Format ID akses (MODE 2 — bot_config/id_akses.txt)**
+    Satu ID per baris (angka ID Telegram).
-<code>
-nomor:pin:device_id:access_token
-</code>
-==== Contoh ====
-<code>
-628123456789:1234:DEVICEID123:TOKENABCXYZ
-</code>
-Jika device_id atau access_token salah, QR tidak akan bisa dibuat.
 ----
-===== 6. Cara Pakai Kupon (USER) =====
+===== 4. Perintah / Cara Interaksi (User & Admin) =====
-==== Mode Tanpa Command (Utama) ====
+  * Perintah umum (tersedia di semua mode tergantung konfigurasi):
+    - `/start` — sambutan
+    - `/help` — panduan singkat
+    - `/scan` — generate QR otomatis dari daftar akun (jika diaktifkan)
+    - `/ulangi` — kirim ulang QR terakhir untuk user tersebut
+    - `/scn <nomor>` — generate QR untuk nomor spesifik (memerlukan file `poinku/<nomor>.txt`)
+    - `/potong <nomor>` — generate + jalankan aktivasi/pemotongan poin (memerlukan `PIN`)
+    - `/qris` — kirim gambar QRIS (jika file tersedia)
-User cukup mengirim **kode kupon langsung ke bot**:
+  * Mode 1 (KODE AKSES):
+    - Awal: user diminta memasukkan kode akses.
+    - Setelah validasi kode: user dapat memakai perintah di atas.
+    - Jika kode tidak valid: akses ditolak.
-<code>
+  * Mode 2 (ID AKSES):
-ABC123
+    - Admin menambahkan Telegram ID user ke `bot_config/id_akses.txt`.
-</code>
+    - Hanya ID dalam daftar yang dapat memakai perintah.
-Jika kode valid:
+  * Mode 3 (SIMPEL / BYPASS):
-  * Bot mengirim QR
+    - User cukup mengirim **kode kupon sebagai teks biasa** (tanpa slash /).
-  * Bot mengirim Barcode
+    - Jika kode cocok pada entri di `bot_kupon_mode3`, bot mengirim QR + Barcode.
-  * Pesan otomatis dihapus setelah ±120 detik
+    - Jika tidak cocok: bot **diam** (tidak membalas).
-Jika kode tidak valid:
-  * Bot tidak membalas apa pun
 ----
-===== 7. Command yang Tersedia =====
+===== 5. Alur Kerja (Flow) Tanpa Menyingkap Kode =====
-==== Command User ====
+. Bot menerima pesan dari user.
+. Pesan diperiksa apakah berbentuk perintah (diawali `/`) atau teks biasa.
-^ Command ^ Fungsi ^
+. Cabang alur:
-| /start | Menampilkan pesan selamat datang |
+   * **Perintah** → diproses sesuai fungsi perintah (scan, scn, potong, dsb).
-| /help | Menampilkan bantuan |
+   * **Teks biasa** → bila Mode 3 aktif, dianggap kupon; bila Mode 1/2 aktif, biasanya tidak diproses (kecuali ada implementasi khusus).
-| /scan | Generate QR otomatis |
+. Jika kupon/nomor ditemukan:
-| /ulangi | Kirim ulang QR terakhir |
+   * Aplikasi membaca data akun dari file terkait di folder `poinku/`.
-| /scn <nomor> | Generate QR berdasarkan nomor |
+   * Aplikasi memanggil layanan internal yang menghasilkan data untuk QR (encoded data).
-| /potong <nomor> | Generate QR + potong poin |
+   * Gambar QR dan barcode dibuat dari data tersebut.
-| /qris | Menampilkan QRIS |
+   * Gambar dikirim ke user; gambar biasanya dihapus otomatis setelah interval tertentu (mis. ~120 detik).
+. Jika ada kegagalan (file tidak ada, data hilang, token invalid):
-==== Command Admin ====
+   * Untuk mode command biasanya ada pesan error/panduan.
+   * Untuk Mode 3 — default silent (tidak memberi petunjuk) untuk menjaga alur stealth.
-^ Command ^ Fungsi ^
-| /bc | Broadcast pesan |
-| Reply + /bc | Broadcast gambar + caption |
 ----
-===== 8. Alur Kerja Bot (Flow) =====
+===== 6. Setup Awal & Checklist Sebelum Menjalankan =====
-  - User mengirim pesan
+. Siapkan token bot di `bottelegramtoken.txt`.
-  - Bot mengecek apakah pesan diawali '/'
+. Pastikan folder `poinku/` berisi file untuk setiap nomor yang akan dipakai, dengan format data sesuai bagian 3.
-  - Jika tidak, dianggap sebagai kode kupon
+. Jika pakai Mode 1: isi `bot_config/kode_akses.txt` dengan kode yang valid.
-  - Bot mencari kode di bot_kupon_mode3
+. Jika pakai Mode 2: isi `bot_config/id_akses.txt` dengan daftar ID Telegram yang diizinkan.
-  - Jika ditemukan:
+. Jika pakai Mode 3: isi `bot_kupon_mode3/` dengan file berisi kupon (format baris sesuai bagian 3).
-    - Ambil nomor
+. Pastikan file `bot_config/admin_id.txt` terisi ID admin untuk operasi broadcast.
-    - Baca akun poinku
+. (Opsional) Siapkan `bot_config/qris.jpg` bila ingin fitur /qris.
-    - Generate QR
-    - Kirim QR & Barcode
-  - Jika tidak ditemukan:
-    - Bot diam
 ----
-===== 9. Keunggulan Mode 3 =====
+===== 7. Troubleshooting Umum (Tanpa Log Internal) =====
-  * Super simpel
+  * **Tidak ada respon saat kirim kupon (Mode 3)**
-  * Tanpa login
+    - Pastikan kupon ada di `bot_kupon_mode3` dan format baris benar.
-  * Cocok untuk:
+    - Pastikan `NOMOR_POINKU` pada baris memiliki file terkait di `poinku/`.
-    - Kupon event
-    - Giveaway
-    - Auto redeem
-    - Sistem stealth
-  * Minim interaksi user
-----
+  * **QR tidak muncul saat command /scn atau /potong**
+    - Periksa file `poinku/<nomor>.txt` — apakah `DEVICE_ID` dan `ACCESS_TOKEN` benar.
+    - Periksa token bot di `bottelegramtoken.txt`.
-===== 10. Catatan Keamanan =====
+  * **Command menolak user (Mode 1/2)**
+    - Mode 1: periksa `kode_akses.txt`.
+    - Mode 2: periksa `id_akses.txt`.
-Disarankan:
+  * **Gagal kirim file/gambar**
-  * Gunakan token Poinku cadangan
+    - Pastikan bot memiliki izin dan session Telegram valid.
-  * Pisahkan akun utama
+    - Cek ketersediaan disk/temp folder bila aplikasi menulis file sementara.
-  * Tambahkan limit pemakaian jika perlu
-  * Backup folder bot_kupon_mode3 secara rutin