Panduan Lengkap Instalasi & Penggunaan Naka Digital BOT v4

Terima kasih telah membeli script Naka Digital BOT v4! Panduan ini akan membantu Anda melakukan instalasi script (baik di Pterodactyl maupun VPS) serta cara mengelola bot sebagai Admin dan menggunakannya sebagai User.

🛠️ PERSIAPAN AWAL (WAJIB)

Sebelum memulai instalasi, pastikan Anda sudah menyiapkan 2 hal berikut:

1. BOT TOKEN: Dapatkan dari Telegram dengan chat ke @BotFather. Buat bot baru (/newbot) dan copy token HTTP API-nya.
2. ADMIN ID: Dapatkan ID Telegram Anda (berupa angka) dengan chat ke bot @userinfobot atau @MissRose_bot (ketik /id).

Buka folder script yang Anda download, cari file bernama .env. Buka file tersebut dengan text editor (Notepad/VS Code), lalu isi dengan data Anda:

Cuplikan kode

ADMIN_ID=masukkan_id_telegram_anda_disini
BOT_TOKEN=masukkan_bot_token_anda_disini

Simpan file tersebut sebelum diupload ke server.

💻 BAGIAN 1: CARA INSTALASI DI PANEL PTERODACTYL

Jika Anda menyewa hosting/panel Pterodactyl, ikuti langkah berikut:

1. Login ke Panel Pterodactyl Anda dan buka server NodeJS Anda.
2. Masuk ke menu Files (File Manager).
3. Hapus semua file bawaan (jika ada), lalu klik Upload dan unggah file .zip script bot ini.
4. Setelah ter-upload, klik kanan pada file .zip tersebut dan pilih Unarchive / Extract.
5. Pastikan file .env yang sudah Anda edit tadi ikut ter-upload.
6. Masuk ke menu Console di panel.
7. Ketik perintah berikut lalu tekan Enter untuk menginstal modul yang dibutuhkan:Bashnpm install
8. Tunggu hingga proses instalasi selesai. Jika sudah, klik tombol Start di pojok kanan atas.
9. Jika di console muncul tulisan Bot is running... dan Connected to the SQLite database., artinya bot Anda sudah aktif dan siap digunakan!

🖥️ BAGIAN 2: CARA INSTALASI DI VPS (UBUNTU / DEBIAN)

Jika Anda menggunakan VPS Linux (Ubuntu/Debian), ikuti langkah berikut:

1. Login ke VPS Anda menggunakan SSH (bisa pakai aplikasi PuTTY atau Termius).
2. Update & Install NodeJS dengan menjalankan perintah berikut secara berurutan:Bashsudo apt update sudo apt install nodejs npm -y
3. Upload File Script ke VPS Anda menggunakan aplikasi FTP seperti WinSCP atau FileZilla. Taruh di dalam folder baru (misal: /root/bot-naka).
4. Kembali ke terminal SSH, masuk ke direktori bot Anda:Bashcd /root/bot-naka
5. Install Modul / Dependencies:Bashnpm install
6. Install PM2 (Agar bot bisa menyala 24 jam nonstop walaupun VPS ditutup):Bashsudo npm install -g pm2
7. Jalankan Bot:Bashpm2 start index.js --name "nakabot" pm2 save pm2 startup
8. Selesai! Bot Anda sudah berjalan 24 jam. (Untuk melihat log/error, ketik: pm2 logs nakabot).

👑 BAGIAN 3: PANDUAN PENGGUNAAN SEBAGAI ADMIN

Karena Anda mendaftarkan ID Telegram Anda di file .env, Anda otomatis menjadi Admin.

1. Buka bot Anda di Telegram dan ketik /start.
2. Anda akan melihat tombol tambahan bernama Admin Menu. Klik tombol tersebut.
3. Mengelola Produk & Kategori:
   • Kategori: Klik Management Kategori -> Tambah. Masukkan nama kategori (misal: Netflix).
   • Produk: Klik Management Produk -> Tambah. Pilih kategori, lalu masukkan nama produk, harga (angka saja tanpa titik), dan deskripsinya.
   • Catatan Edit Produk: Jika ingin mengedit produk, gunakan format: nama_baru|harga_baru|deskripsi_baru.
4. Mengelola Stok (PENTING):
   • Klik Management Stok -> Tambah -> Pilih Produk.
   • Kirimkan stok Anda. Anda bisa mengirim banyak stok sekaligus dengan format per baris.
   • Contoh:akun1@gmail.com:pass1akun2@gmail.com:pass2
5. Setting Pembayaran Otomatis (QRIS):
   • Di Admin Menu, klik Settings.
   • Pilih provider yang ingin Anda gunakan (InvoiceKu atau Pakasir).
   • Klik Set API Key dan masukkan API Key akun Anda.
   • Jangan lupa pastikan status provider diubah menjadi ON (Toggle ON/OFF).
6. Merespon Orderan Manual (Jika Saldo/QRIS Error):
   • Klik Management Order -> Order Pending.
   • Anda bisa mengklik tombol Approve (jika pembayaran sudah dipastikan valid) atau Reject (jika invalid). Stok akan otomatis terkirim ke pembeli jika di-approve.

👤 BAGIAN 4: PANDUAN PENGGUNAAN SEBAGAI USER (PEMBELI)

Ini adalah panduan yang akan dialami oleh pelanggan Anda:

1. Mulai Bot: User membuka bot dan klik /start.
2. Cek Stok & Info: User bisa mengklik tombol Cek Stok untuk melihat daftar produk yang tersedia sebelum membeli.
3. Cara Order:
   • User mengklik tombol Order.
   • Bot akan menampilkan kategori. User memilih kategori lalu memilih produk.
   • Bot menampilkan detail harga dan sisa stok. User bisa menambah kuantitas (qty) menggunakan tombol +, -, atau Custom.
4. Proses Pembayaran:
   • User memilih metode pembayaran (QRIS InvoiceKu / QRIS Pakasir / Saldo).
   • Jika via QRIS: Bot akan mengirimkan gambar/kode QRIS. User membayarnya lewat M-Banking / E-Wallet.
   • Setelah sukses bayar, user WAJIB mengklik tombol Cek Pembayaran di bawah gambar QRIS.
5. Penerimaan Barang:
   • Begitu sistem mendeteksi pembayaran berhasil, bot akan otomatis mengirimkan detail pesanan beserta kode/akun/stok yang dibeli ke chat user.
6. Topup Saldo (Alternatif):
   • User bisa klik menu Profile -> Topup Saldo.
   • Masukkan nominal topup dan scan QRIS. Saldo akan otomatis bertambah setelah dibayar dan user mengklik “Cek Pembayaran”.

💡 Tips Tambahan:

• Jika terjadi error saat pembayaran otomatis, Admin bisa melayani secara manual dengan menyuruh user transfer, lalu Admin membuatkan Voucher Saldo (Menu Admin -> Management Voucher) untuk di-redeem oleh user.
• Pastikan API Key Payment Gateway (InvoiceKu/Pakasir) diisi dengan benar agar sistem auto-payment berjalan lancar.