cuan77:bot_tele_poin
Perbedaan
Ini menunjukkan perbedaan antara versi yang terpilih dengan versi yang sedang aktif.
| Kedua sisi revisi sebelumnyaRevisi sebelumnya | |||
| cuan77:bot_tele_poin [2026/01/31 13:54] – fakhrun | cuan77:bot_tele_poin [2026/01/31 13:55] (sekarang) – fakhrun | ||
|---|---|---|---|
| Baris 1: | Baris 1: | ||
| - | ====== | + | ====== |
| - | Dokumentasi | + | Dokumen |
| - | * Struktur folder | + | Dokumen |
| - | * Cara kerja masing-masing mode | + | |
| - | | + | |
| - | + | ||
| - | Mode dipilih melalui menu awal aplikasi. | + | |
| ---- | ---- | ||
| - | ===== 1. MODE 1 — KODE AKSES ===== | + | ===== 1. Ringkasan Mode ===== |
| - | Mode ini menggunakan | + | * **Mode 1 — KODE AKSES** |
| + | Akses berdasarkan kode yang diberikan kepada | ||
| - | ==== Folder & File yang Digunakan ==== | + | * **Mode 2 — ID AKSES** |
| + | Akses berdasarkan daftar ID Telegram. Cocok untuk kontrol internal. | ||
| - | < | + | * **Mode 3 — SIMPEL |
| - | project/ | + | Tanpa validasi; user cukup mengirim teks (kode kupon) |
| - | ├── bot_config/ | + | |
| - | │ | + | |
| - | │ | + | |
| - | │ | + | |
| - | │ | + | |
| - | │ | + | |
| - | ├── bot_kupon/ | + | |
| - | ├── poinku/ | + | |
| - | └── bottelegramtoken.txt | + | |
| - | </ | + | |
| - | ==== Fungsi Utama ==== | + | ---- |
| - | < | + | |
| - | mode_kode_akses() | + | |
| - | </ | + | |
| - | ==== Cara Kerja Mode 1 ==== | + | ===== 2. Struktur Folder & File yang Harus Disiapkan ===== |
| - | - Bot meminta user memasukkan **kode akses** | + | Minimal struktur yang direkomendasikan: |
| - | - Bot mengecek kode di file `bot_config/ | + | |
| - | - Jika kode valid: | + | |
| - | - User diizinkan menggunakan command bot | + | |
| - | - User disimpan ke `list_user.txt` | + | |
| - | - Jika kode salah: | + | |
| - | - Bot menolak akses | + | |
| - | ==== Cara Pengguna Memakai Bot (User) ==== | + | * `bottelegramtoken.txt` |
| + | - Satu token bot per baris. | ||
| - | 1. User membuka bot | + | * `bot_config/ |
| - | 2. User mengirim command awal (misalnya | + | - `admin_id.txt` (ID admin) |
| - | 3. User diminta memasukkan **kode akses** | + | - `list_user.txt` (otomatis terisi; daftar user yang berinteraksi) |
| - | 4. Setelah lolos: | + | - `nowa_owner.txt` (opsional — nomor WA owner) |
| - | - User bisa menggunakan command: | + | - `kode_akses.txt` (MODE 1 — daftar |
| - | < | + | - `id_akses.txt` (MODE 2 — daftar ID Telegram) |
| - | / | + | |
| - | / | + | |
| - | / | + | |
| - | / | + | |
| - | / | + | |
| - | </ | + | |
| - | ==== Kapan Mode 1 Dipakai ==== | + | |
| - | | + | - File per-nomor yang berisi data akun yang digunakan untuk generate QR. (Format baris contoh lihat bagian 5) |
| - | * Kupon berbayar | + | |
| - | * Sistem whitelist berbasis kode | + | |
| - | ---- | + | * `bot_kupon/ |
| + | | ||
| - | ===== 2. MODE 2 — ID AKSES ===== | + | * `bot_kupon_mode3/ |
| + | - WAJIB untuk MODE 3 — berisi daftar kupon yang dapat ditukarkan melalui plain text | ||
| - | Mode ini menggunakan **ID Telegram** untuk menentukan siapa yang boleh memakai bot. | + | Catatan: beberapa file bersifat opsional tergantung mode yang dipakai. |
| - | ==== Folder & File yang Digunakan ==== | + | ---- |
| - | < | + | ===== 3. Format Data File Penting ===== |
| - | project/ | + | |
| - | ├── bot_config/ | + | |
| - | │ | + | |
| - | │ | + | |
| - | │ | + | |
| - | │ | + | |
| - | │ | + | |
| - | ├── bot_kupon/ | + | |
| - | ├── poinku/ | + | |
| - | └── bottelegramtoken.txt | + | |
| - | </ | + | |
| - | ==== Fungsi Utama ==== | + | (Contoh baris — **HANYA** format data, bukan kode) |
| - | < | + | |
| - | mode_id_akses() | + | |
| - | </ | + | |
| - | ==== Cara Kerja Mode 2 ==== | + | * **Format file kupon (bot_kupon atau bot_kupon_mode3)** |
| + | Setiap baris: | ||
| + | ``` | ||
| + | NOMOR_POINKU: | ||
| + | ``` | ||
| + | - `NOMOR_POINKU` | ||
| + | - `KODE_KUPON` | ||
| + | - `EXP` = tanggal kadaluarsa (opsional) | ||
| - | | + | |
| - | - Setiap user yang mengirim command: | + | Baris pertama harus berisi data akun yang diperlukan untuk generate QR: |
| - | | + | ``` |
| - | - Jika ID terdaftar: | + | NOMOR:PIN: |
| - | | + | |
| - | - Jika ID tidak terdaftar: | + | - `PIN` digunakan untuk operasi pemotongan/ |
| - | - Bot menolak atau mengabaikan | + | - `DEVICE_ID` dan `ACCESS_TOKEN` harus valid untuk proses pembuatan QR |
| - | ==== Cara Pengguna Memakai Bot (User) ==== | + | * **Format kode akses (MODE 1 — bot_config/ |
| + | Satu kode per baris. | ||
| - | 1. Admin menambahkan | + | * **Format |
| - | < | + | Satu ID per baris (angka ID Telegram). |
| - | bot_config/ | + | |
| - | </ | + | |
| - | + | ||
| - | 2. User membuka bot | + | |
| - | 3. User langsung bisa memakai command tanpa registrasi tambahan: | + | |
| - | < | + | |
| - | / | + | |
| - | / | + | |
| - | / | + | |
| - | / | + | |
| - | </ | + | |
| - | + | ||
| - | 4. Jika ID tidak terdaftar: | + | |
| - | - Command tidak dijalankan | + | |
| - | + | ||
| - | ==== Kapan Mode 2 Dipakai ==== | + | |
| - | | + | |
| - | * Admin / reseller tertentu | + | |
| - | * Kontrol ketat berbasis akun Telegram | + | |
| ---- | ---- | ||
| - | ===== 3. MODE 3 — SIMPEL AKSES (BYPASS) ===== | + | ===== 4. Perintah / Cara Interaksi |
| - | Mode ini **tidak menggunakan sistem akses sama sekali**. | + | |
| - | Semua user bebas menggunakan bot. | + | - `/start` — sambutan |
| + | - `/help` — panduan singkat | ||
| + | - `/scan` — generate QR otomatis dari daftar akun (jika diaktifkan) | ||
| + | - `/ulangi` — kirim ulang QR terakhir untuk user tersebut | ||
| + | - `/scn < | ||
| + | - `/potong < | ||
| + | - `/qris` — kirim gambar QRIS (jika file tersedia) | ||
| - | ==== Folder & File yang Digunakan ==== | + | * 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. | ||
| - | < | + | * Mode 2 (ID AKSES): |
| - | project/ | + | - Admin menambahkan Telegram ID user ke `bot_config/id_akses.txt`. |
| - | ├── bot_kupon_mode3/ | + | - Hanya ID dalam daftar yang dapat memakai perintah. |
| - | ├── poinku/ | + | |
| - | │ | + | |
| - | ├── | + | |
| - | │ | + | |
| - | │ | + | |
| - | │ | + | |
| - | │ | + | |
| - | └── bottelegramtoken.txt | + | |
| - | </ | + | |
| - | ==== Fungsi Utama ==== | + | * Mode 3 (SIMPEL / BYPASS): |
| - | < | + | - User cukup mengirim **kode kupon sebagai teks biasa** (tanpa slash /). |
| - | mode3_bypass_akses() | + | - Jika kode cocok pada entri di `bot_kupon_mode3`, |
| - | </code> | + | - Jika tidak cocok: bot **diam** (tidak membalas). |
| - | ==== Cara Kerja Mode 3 ==== | + | ---- |
| - | - Semua pesan **tanpa awalan `/`** dianggap sebagai **kode kupon** | + | ===== 5. Alur Kerja (Flow) Tanpa Menyingkap Kode ===== |
| - | - Bot membaca seluruh data di folder `bot_kupon_mode3` | + | |
| - | - Bot mencari baris dengan format: | + | |
| - | < | + | |
| - | NOMOR: | + | |
| - | </ | + | |
| - | - Jika kode cocok: | + | |
| - | - Bot generate QR + Barcode | + | |
| - | - Bot mengirim ke user | + | |
| - | - Jika kode tidak cocok: | + | |
| - | - Bot **tidak membalas apa pun (silent)** | + | |
| - | ==== Format File Kupon MODE 3 ==== | + | 1. Bot menerima pesan dari user. |
| + | 2. Pesan diperiksa apakah berbentuk perintah (diawali `/`) atau teks biasa. | ||
| + | 3. 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). | ||
| + | 4. 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). | ||
| + | 5. Jika ada kegagalan (file tidak ada, data hilang, token invalid): | ||
| + | * Untuk mode command biasanya ada pesan error/ | ||
| + | * Untuk Mode 3 — default silent (tidak memberi petunjuk) untuk menjaga alur stealth. | ||
| - | < | + | ---- |
| - | 628123456789: | + | |
| - | 628987654321: | + | |
| - | </ | + | |
| - | ==== Cara Pengguna Memakai Bot (User) | + | ===== 6. Setup Awal & Checklist Sebelum Menjalankan ===== |
| - | ===== A. Tanpa Command | + | 1. Siapkan token bot di `bottelegramtoken.txt`. |
| + | 2. Pastikan folder `poinku/` berisi file untuk setiap nomor yang akan dipakai, dengan format data sesuai bagian 3. | ||
| + | 3. Jika pakai Mode 1: isi `bot_config/ | ||
| + | 4. Jika pakai Mode 2: isi `bot_config/ | ||
| + | 5. Jika pakai Mode 3: isi `bot_kupon_mode3/ | ||
| + | 6. Pastikan file `bot_config/ | ||
| + | 7. (Opsional) Siapkan `bot_config/ | ||
| - | User cukup mengirim: | + | ---- |
| - | < | + | |
| - | ABC123 | + | |
| - | </ | + | |
| - | Hasil: | + | ===== 7. Troubleshooting Umum (Tanpa Log Internal) ===== |
| - | * QR dikirim | + | |
| - | * Barcode dikirim | + | |
| - | * Pesan dihapus otomatis ±120 detik | + | |
| - | ===== B. Dengan Command ===== | + | * **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/`. | ||
| - | Command tetap bisa digunakan: | + | * **QR tidak muncul saat command |
| - | < | + | - Periksa file `poinku/< |
| - | /scan | + | - Periksa token bot di `bottelegramtoken.txt`. |
| - | /scn < | + | |
| - | /potong | + | |
| - | /ulangi | + | |
| - | /qris | + | |
| - | </ | + | |
| - | ==== Karakteristik Penting Mode 3 ==== | + | |
| - | | + | - Mode 1: periksa `kode_akses.txt`. |
| - | | + | |
| - | | + | |
| - | | + | |
| - | ---- | + | * **Gagal kirim file/ |
| + | | ||
| + | | ||
cuan77/bot_tele_poin.1769867683.txt.gz · Terakhir diubah: oleh fakhrun
