Perbedaan

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

--- cuan77:bot_tele_poin [2026/01/31 13:50] – fakhrun
+++ cuan77:bot_tele_poin [2026/01/31 13:55] (sekarang) – fakhrun
@@ Baris 1: / Baris 1: @@
-====== BOT TELEGRAM – MODE (KODE / ID / SIMPEL) ======
+====== Panduan Penggunaan Skrip Bot Telegram (MODE 1 / MODE 2 / MODE 3) ======
-Panduan ini menjelaskan konfigurasi dan cara pakai bot Telegram pada *tiga mode* yang tersedia di menu: **KODE AKSES**, **ID AKSES**, dan **SIMPEL AKSES (Mode 3)**.
+Dokumen ini menjelaskan secara praktis bagaimana menyiapkan dan memakai skrip bot Telegram yang sudah obfuscated.
-Gunakan dokumen ini sebagai referensi untuk menyiapkan file, format data, serta cara pengguna berinteraksi dengan bot.
+Dokumen **tidak** mengandung nama fungsi atau potongan kode internal — hanya panduan konfigurasi dan operasi.
 ----
-===== 1. Pemilihan Mode =====
+===== 1. Ringkasan Mode =====
-Saat aplikasi dijalankan, tampilkan menu berikut (sesuai `mainview()` di kode):
+* **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>
-Pilih mode dengan memasukkan nomornya:
+* **Mode 3 — SIMPEL (BYPASS)**
-<code>
+  Tanpa validasi; user cukup mengirim teks (kode kupon) dan bot akan menukarkan jika cocok.
-SELECT MENU : 1 | 2 | 3
-</code>
-Pemanggilan fungsi di kode:
+----
-<code>
-if menu == '1':
-    mode_kode_akses()
-elif menu == '2':
-    mode_id_akses()
-elif menu == '3':
-    mode3_bypass_akses()
-</code>
----
+===== 2. Struktur Folder & File yang Harus Disiapkan =====
-===== 2. Karakteristik tiap Mode =====
+Minimal struktur yang direkomendasikan:
-==== Mode 1 — KODE AKSES ====
+  * `bottelegramtoken.txt`
-  * Mengharuskan pengguna memiliki **kode akses** (format dan validasi tergantung implementasi `mode_kode_akses()`).
+    - Satu token bot per baris.
-  * Biasanya digunakan bila ingin memberi hak hanya kepada pemilik kode.
-  * Interaksi: pengguna mengirim kode khusus atau command yang memuat kode.
-==== Mode 2 — ID AKSES ====
+  * `bot_config/`
-  * Menggunakan **ID Telegram** untuk validasi (daftar ID yang diizinkan disimpan di konfigurasi).
+    - `admin_id.txt` (ID admin)
-  * Cocok untuk kontrol akses ketat (mis. hanya admin atau daftar user tertentu).
+    - `list_user.txt` (otomatis terisi; daftar user yang berinteraksi)
-  * Interaksi: pengguna harus memiliki ID yang terdaftar agar command berjalan.
+    - `nowa_owner.txt` (opsional — nomor WA owner)
+    - `kode_akses.txt` (MODE 1 — daftar kode akses)
+    - `id_akses.txt` (MODE 2 — daftar ID Telegram)
-==== Mode 3 — SIMPEL AKSES (Bypass / Plain Text) ====
+  * `poinku/`
-  * Tidak ada validasi akses (tidak perlu registrasi atau kode akses).
+    - File per-nomor yang berisi data akun yang digunakan untuk generate QR. (Format baris contoh lihat bagian 5)
-  * Pengguna cukup mengirim **kode kupon** sebagai teks biasa (tanpa `/`).
-  * Kode valid → bot mengirim QR + Barcode; kode salah → bot **silent** (tidak membalas).
-  * Handler utama: `__kupon_code_bypass` (dipicu untuk pesan yang **tidak** diawali `/`).
----
+  * `bot_kupon/`
+    - Digunakan untuk mode command (mis. per-file kumpulan kupon berdasarkan kampanye)
-===== 3. Struktur Folder Wajib (minimal) =====
+  * `bot_kupon_mode3/`
+    - WAJIB untuk MODE 3 — berisi daftar kupon yang dapat ditukarkan melalui plain text
-Agar semua mode berjalan normal, minimal siapkan struktur berikut:
+Catatan: beberapa file bersifat opsional tergantung mode yang dipakai.
-<code>
+----
-project/
-├── bot_kupon/             # (opsional untuk mode non-bypass)
-├── bot_kupon_mode3/       # WAJIB untuk mode 3 (SIMPEL)
-├── poinku/                # WAJIB: data akun poinku per nomor
-├── bot_config/
-│   ├── admin_id.txt
-│   ├── list_user.txt
-│   └── nowa_owner.txt
-├── bottelegramtoken.txt
-└── main.py (atau file bot)
-</code>
-Catatan:
+===== 3. Format Data File Penting =====
-  * `bot_kupon/` biasa dipakai untuk mode non-bypass (command `/kupon <nama> <kode>`).
-  * `bot_kupon_mode3/` dipakai untuk pencarian kupon plain-text (mode 3).
----
+(Contoh baris — **HANYA** format data, bukan kode)
-===== 4. Folder `bot_kupon_mode3` =====
+  * **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)
-Folder ini berisi daftar kupon untuk mode simpel. Bot akan membaca seluruh baris dari semua file di folder ini.
+  * **Format file akun (poinku/<nomor>.txt)**
+    Baris pertama harus berisi data akun yang diperlukan untuk generate QR:
+    ```
+    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 baris (WAJIB) ====
+  * **Format kode akses (MODE 1 — bot_config/kode_akses.txt)**
-<code>
+    Satu kode per baris.
-NOMOR_POINKU:KODE_KUPON:EXP
-</code>
-==== Contoh ====
+  * **Format ID akses (MODE 2 — bot_config/id_akses.txt)**
-<code>
+    Satu ID per baris (angka ID Telegram).
-628123456789:ABC123:2026-12-31
-628111222333:DEF456:2026-06-30
-628999888777:GIFT999
-</code>
-Catatan penting:
+----
-  * Pemisah harus `:`; urutan tidak boleh diubah.
-  * FIELD `EXP` bersifat opsional — jika kosong, caption EXP tidak ditampilkan.
-  * Mode 3 mencari kecocokan pada elemen kedua (`split(':')[1] == user_input`).
----
+===== 4. Perintah / Cara Interaksi (User & Admin) =====
-===== 5. Folder `poinku` =====
+  * 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)
-Berisi file per- nomor yang dipakai untuk menghasilkan QR melalui API Poinku.
+  * 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.
-==== Nama file ====
+  * Mode 2 (ID AKSES):
-<code>
+    - Admin menambahkan Telegram ID user ke `bot_config/id_akses.txt`.
-poinku/<nomor>.txt
+    - Hanya ID dalam daftar yang dapat memakai perintah.
-</code>
-==== Format isi (baris pertama digunakan) ====
+  * Mode 3 (SIMPEL / BYPASS):
-<code>
+    - User cukup mengirim **kode kupon sebagai teks biasa** (tanpa slash /).
-nomor:pin:device_id:access_token:...
+    - Jika kode cocok pada entri di `bot_kupon_mode3`, bot mengirim QR + Barcode.
-</code>
+    - Jika tidak cocok: bot **diam** (tidak membalas).
-Contoh:
+----
-<code>
-628123456789:1234:DEVICEID123:TOKENABCXYZ
-</code>
-Keterangan:
+===== 5. Alur Kerja (Flow) Tanpa Menyingkap Kode =====
-  * `device_id` dan `access_token` harus valid — digunakan oleh `PoinkuQr.generate_qrcode()`.
-  * Field `pin` digunakan saat operasi `/potong` (aktivasi wallet).
----
+. Bot menerima pesan dari user.
+. Pesan diperiksa apakah berbentuk perintah (diawali `/`) atau teks biasa.
+. Cabang alur:
+   * **Perintah** → diproses sesuai fungsi perintah (scan, scn, potong, dsb).
+   * **Teks biasa** → bila Mode 3 aktif, dianggap kupon; bila Mode 1/2 aktif, biasanya tidak diproses (kecuali ada implementasi khusus).
+. Jika kupon/nomor ditemukan:
+   * Aplikasi membaca data akun dari file terkait di folder `poinku/`.
+   * Aplikasi memanggil layanan internal yang menghasilkan data untuk QR (encoded data).
+   * Gambar QR dan barcode dibuat dari data tersebut.
+   * Gambar dikirim ke user; gambar biasanya dihapus otomatis setelah interval tertentu (mis. ~120 detik).
+. Jika ada kegagalan (file tidak ada, data hilang, token invalid):
+   * Untuk mode command biasanya ada pesan error/panduan.
+   * Untuk Mode 3 — default silent (tidak memberi petunjuk) untuk menjaga alur stealth.
-===== 6. File Konfigurasi Bot =====
+----
-#### bottelegramtoken.txt
+===== 6. Setup Awal & Checklist Sebelum Menjalankan =====
-Isi token bot Telegram (1 token per baris), contoh:
-<code>
-:ABC-DEF-TOKEN
-</code>
-#### bot_config/admin_id.txt
+. Siapkan token bot di `bottelegramtoken.txt`.
-Isi ID admin (dipakai untuk fitur /bc), contoh:
+. Pastikan folder `poinku/` berisi file untuk setiap nomor yang akan dipakai, dengan format data sesuai bagian 3.
-<code>
+. Jika pakai Mode 1: isi `bot_config/kode_akses.txt` dengan kode yang valid.
-123456789
+. Jika pakai Mode 2: isi `bot_config/id_akses.txt` dengan daftar ID Telegram yang diizinkan.
-</code>
+. Jika pakai Mode 3: isi `bot_kupon_mode3/` dengan file berisi kupon (format baris sesuai bagian 3).
+. Pastikan file `bot_config/admin_id.txt` terisi ID admin untuk operasi broadcast.
+. (Opsional) Siapkan `bot_config/qris.jpg` bila ingin fitur /qris.
-#### bot_config/list_user.txt
+----
-  * Berisi daftar user yang berinteraksi: `user_id:dummy`
-  * Otomatis ditambah oleh bot saat user menggunakan command atau berinteraksi.
-#### bot_config/nowa_owner.txt
+===== 7. Troubleshooting Umum (Tanpa Log Internal) =====
-  * Nomor WA owner untuk keperluan PM regist (opsional, sesuai kode).
----
+  * **Tidak ada respon saat kirim kupon (Mode 3)**
+    - Pastikan kupon ada di `bot_kupon_mode3` dan format baris benar.
+    - Pastikan `NOMOR_POINKU` pada baris memiliki file terkait di `poinku/`.
-===== 7. Cara Pakai Kupon (untuk pengguna) =====
+  * **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`.
-Berikut ringkasan interaksi untuk tiap skenario:
+  * **Command menolak user (Mode 1/2)**
+    - Mode 1: periksa `kode_akses.txt`.
+    - Mode 2: periksa `id_akses.txt`.
-==== A. Mode non-bypass (dengan command) ====
+  * **Gagal kirim file/gambar**
-  * Command umum:
+    - Pastikan bot memiliki izin dan session Telegram valid.
-    <code>/kupon <nama_file> <kode_atau_nomor></code>
+    - Cek ketersediaan disk/temp folder bila aplikasi menulis file sementara.
-  * Contoh:
-    <code>/kupon promo_juli ABC123</code>
-  * Bot akan:
-. Buka file `bot_kupon/<nama_file>.txt`
-. Cari baris yang cocok (berdasarkan nomor atau kode)
-. Ambil `poinku/<nomor>.txt`
-. Generate QR + Barcode → kirim ke user (gambar otomatis dihapus ~120s)
-==== B. Mode 3 — SIMPEL (plain-text) ====
-  * Cukup kirim:
-    <code>ABC123</code>
-  * Bot mencari di `bot_kupon_mode3`:
-    * Ketemu → kirim QR + Barcode (caption EXP jika tersedia)
-    * Tidak ketemu → bot tidak merespon
-==== C. Command tambahan ====
-  * <code>/scn &lt;nomor&gt;</code> — generate QR untuk nomor spesifik (pakai `poinku/<nomor>.txt`)
-  * <code>/potong &lt;nomor&gt;</code> — generate QR sekaligus memanggil activation (pakai pin di file poinku)
-  * <code>/ulangi</code> — kirim ulang QR terakhir untuk user (pakai `index_previous`)
-  * <code>/qris</code> — kirim file `bot_config/qris.jpg` (jika ada)
----
-===== 8. Alur Kerja Bot (Flow) =====
-. Bot menerima pesan dari user.
-. Jika pesan diawali dengan `/` → proses sebagai command:
-   * Mis. `/kupon`, `/scn`, `/potong`, `/start`, `/help`, dsb.
-. Jika pesan **tidak** diawali `/` → perilaku tergantung mode:
-   * Mode 3 aktif → anggap sebagai **kode kupon**; cari di `bot_kupon_mode3`.
-   * Mode lain → pesan plain text dapat diabaikan atau diproses sesuai implementasi mode.
-. Jika ditemukan entri kupon:
-   * Ambil `nomor` dari entri
-   * Baca file `poinku/<nomor>.txt` untuk `device_id` dan `access_token`
-   * Panggil `PoinkuQr.generate_qrcode()` → dapatkan `encodedData`
-   * Buat gambar QR & Barcode via `editor.create_poiku_qrbarcode(...)`
-   * Kirim gambar ke user (kedua gambar dihapus otomatis setelah ~120 detik)
-. Jika entri tidak ditemukan atau ada error:
-   * Mode 3 → silent (tidak membalas)
-   * Mode command → kirim pesan error / dialog (`cus_dialog.get_dialog('error_qr')` atau `not_regist`)
-----