Dokumentasi RNFBOT: Panduan Bot Telegram, Bot WhatsApp & Xoftware

Cara Mulai

Supabase & Xoftware untuk bot Anda sudah disetup oleh Team RNFBOT, jadi Admin Toko cukup menunggu data dikirim lalu mulai start bot.

1. Tunggu data toko (kredensial bot) dikirim oleh Team RNFBOT
2. Setelah data diberikan, langsung mulai setting bot bisa dilakukan sambil menunggu proses integrasi Xoftware selesai disetup oleh Team RNFBOT
3. Bot akan diberi 1 hari free trial. Setelah itu, perpanjang langganan sendiri lewat menu admin /admin → ⏳ Perpanjang Sewa

Lihat juga video tutorial: Cara Setting Bot

Command & Menu

Referensi command dan tombol yang dilihat buyer di bot. Berguna bagi Admin Toko untuk memahami fitur yang tersedia untuk pelanggan.

Daftar Command

Daftar Tombol (Menu Utama)

Admin Panel

Diakses lewat command /admin. Panel ini menampilkan status bot dan seluruh menu pengelolaan toko.

🔧 ADMIN PANEL 🔧

Status Bot: 🟢 Bot AKTIF
Masa Aktif: 22 Januari 2027

Selamat datang di panel admin RNF BOT!
Pilih menu di bawah untuk mengelola bot:

Daftar Menu Admin

Detail Menu Settings

Contoh isi menu Settings, edit profil toko, sistem transaksi, dan kontak Admin Toko:

🏪 Profil Toko
├ Nama Toko: TOKO ANDA
├ Deskripsi: Deskripsi singkat toko Anda
├ Cara Order: https://telegram.me/namachannel/4
├ Channel Testi: https://telegram.me/namachannel_testi
└ Channel Garansi: https://telegram.me/namachannel_garansi

💳 Sistem Transaksi
├ Prefix TRX: TOKOANDA
├ Min. Topup: 2000
└ Waktu Expired: 5 menit

📞 Kontak Admin
├ Status Admin: Online
├ Username: @admintoko
└ WhatsApp: 628xxxxxxxxxx

Profil Toko

Sistem Transaksi

Kontak Admin

Web Mini App

Ada 2 Web Mini App dengan tujuan berbeda jangan tertukar:

Alur Kelola Produk, Varian, Stok & Gambar

Semua bisa dikelola dari 1 tempat:
/admin → 📦 Buka Panel Web (Secure) → Manajemen Produk.
Tiap baris produk punya 3 ikon aksi:
📦 Kelola Stok, ✏️ Edit, 🗑️ Hapus.
Setiap field yang perlu penjelasan (format stok, cara ambil link gambar, fulfillment, aturan pembelian) sudah ada tombol ? berbentuk popup langsung di form-nya di sini cuma alur & nama field-nya saja.

🖥️ Screenshot: Dashboard Awal Panel Admin

🏷️ Screenshot: Form Tambah/Edit Produk & Varian

📦 Screenshot: Kelola Stok

Cara Tambahkan Katalog Toko (Buyer) ke Menu Bot lewat BotFather

Ini bukan untuk buka Panel Admin Toko, ini supaya buyer bisa lihat katalog produk dalam tampilan web (grid produk, pilih varian, checkout) langsung dari tombol menu (☰) di kolom chat, sebagai alternatif yang lebih nyaman dibanding command /listproduk. Team RNFBOT akan mengirimkan link dengan format:

https://app.rnfbot.my.id/?bot_id=<bot_id>&shop=<username_bot>

1. Buka @BotFather di Telegram
2. Kirim perintah /mybots
3. Pilih bot toko Anda dari daftar
4. Pilih Bot Settings → Menu Button
5. Pilih Edit Menu Button URL
6. Paste link Katalog Toko yang dikirim Team RNFBOT (sudah berisi bot_id dan username bot Toko Anda)
7. Kirim nama tombol menu (contoh: "Lihat Katalog")
8. Selesai tombol menu (☰) akan muncul di kolom chat bot, buyer klik untuk buka tampilan katalog

Lihat juga video tutorial: Cara Setting Web App

Cara Tambah Produk (Inline Telegram)

Fungsi: membuat "Produk" sebagai item utama. Setelah produk dibuat, lanjut buat Varian & Harga, lalu isi Stok.

Tambah Produk (Inline Telegram)

1. Buka /admin → 🏷️ Produk
2. Klik ➕ Tambah Produk (ikuti step dari bot)
3. Kirim Nama Produk
4. Kirim Deskripsi Produk
5. Produk berhasil ditambahkan ✅

Edit Produk (Inline Telegram)

1. Buka /admin → 🏷️ Produk
2. Pilih Edit (ikuti step dari bot)
3. Ubah data
4. Simpan ✅

Hapus Produk (Inline Telegram)

1. Buka /admin → 🏷️ Produk
2. Pilih Hapus (ikuti step dari bot)
3. Simpan ✅

Urutan yang benar: 1️⃣ Buat Produk → 2️⃣ Buat Varian & Harga → 3️⃣ Isi Stok

Cara Tambah Varian & Harga (Inline Telegram)

Fungsi: Varian menentukan paket/durasi, harga, tipe pengiriman, jumlah item per pembelian, dan batas pembelian (Min/Max).

Tambah Varian (Inline Telegram)

1. Buka /admin → 🧩 Varian & Harga
2. Klik ➕ Tambah Varian
3. Pilih Produk
4. Kirim Nama Varian (contoh: 1 Bulan / 3 Bulan)
5. Kirim Harga (Rp) (contoh: 10000)
6. Set Harga Grosir (opsional): buat harga per pcs otomatis lebih murah kalau buyer beli dalam jumlah banyak, tanpa perlu diskon manual.
   • Format: qty=harga, satu baris per tier
   • Qty minimal tiap tier: 2, dan harga tier harus lebih murah dari Harga dasar
   • Tidak boleh ada Qty Min yang sama di lebih dari satu baris
   • Ketik - atau tekan tombol Skip kalau tidak mau pakai harga grosir
   Contoh Harga Grosir

   10=8000
   50=6000

   Artinya: beli 10+ pcs otomatis Rp8.000/pcs, beli 50+ pcs otomatis Rp6.000/pcs. Sistem otomatis pilih harga termurah sesuai qty yang dibeli buyer, tier aktif ditandai "✅ Aktif" saat checkout.

7. Pilih Fulfillment Type:
   • ACCOUNT → email|password
   • CODE → KODEVOUCHER
   • LINK → https://link
8. Set Item per Pembelian (qty_per_purchase) berapa item stok yang dikirim ke buyer untuk 1x pembelian:
   • Jual satuan → ketik 1 (atau Skip)
   • Paket isi 3 → ketik 3
   • Paket isi 10 → ketik 10
9. Set Min & Max Qty (opsional bisa Skip untuk default). Min = minimal pembelian (default 1), Max = maksimal pembelian (default Unlimited)
10. Pilih status Aktif / Nonaktif
11. Review ringkasan → Simpan ✅

Min 1 Max 10       → beli Min 1–10 Max
Min 5 Max Unlimited → beli Min 5–Unlimited Max
Biarkan default (Skip) → pembelian bebas tidak terbatas

Kasus A 
Jual satuan: Item per Pembelian = 1
Isi 10 baris stok → tersedia untuk 10x pembelian (tiap beli 1 qty = kirim 1 baris)

Kasus B 
Varian "Paket 5 Akun Capcut": Item per Pembelian = 5
Isi 10 baris stok → tersedia untuk 2x pembelian saja (tiap beli 1 qty = kirim 5 baris sekaligus)
10 baris ÷ 5 per pembelian = 2 kali beli

Edit Varian (Inline Telegram)

1. Buka /admin → 🧩 Varian & Harga
2. Klik ✏️ Edit Varian (ikuti step dari bot)
3. Pilih Produk
4. Pilih Varian
5. Ubah data (termasuk tombol "✏️ Harga Grosir" untuk ubah tier harga grosir)
6. Simpan ✅

Hapus Varian (Inline Telegram)

1. Buka /admin → 🧩 Varian & Harga
2. Klik 🗑️ Hapus Varian (ikuti step dari bot)
3. Pilih Produk
4. Pilih Varian
5. Hapus ✅

Urutan yang benar: 1️⃣ Buat Produk → 2️⃣ Buat Varian & Harga → 3️⃣ Isi Stok

Cara Tambah Stok (Inline Telegram)

Fungsi: Mengisi stok untuk varian tertentu. Setiap baris = 1 item stok. Cara input: 1 baris = 1 item.

Tambah Stok (Inline Telegram)

1. Buka /admin → 📦 Stok/Inventory
2. Klik ➕ Tambah Stok
3. Pilih Produk
4. Pilih Varian
5. Pilih metode input:
   • 📝 Paste Text: ketik/paste langsung
   • 📎 Upload .txt: upload file text
6. Preview & konfirmasi → Simpan ✅

Format Stok (Wajib: 1 Baris = 1 Item)

A. ACCOUNT format per baris: email|password

akun1@gmail.com|pass1
akun2@gmail.com|pass2
akun3@gmail.com|pass3

✅ Total otomatis = 3 stok

B. CODE format per baris: KODEVOUCHER

DISKON10
PROMO20
VIP-ABCD-1234

✅ Total otomatis = 3 stok

C. LINK format per baris: https://linkamu

https://example.com/akses1
https://example.com/akses2

✅ Total otomatis = 2 stok

Item per Pembelian (untuk Varian Paket/Bulk)

Angka Item per Pembelian (diatur waktu bikin Varian) menentukan berapa baris stok yang diambil & dikirim sekaligus untuk 1x qty dibeli. Kalau varian satuan, angkanya 1 jadi bagian ini fokus ke varian paket/bulk yang angkanya lebih dari 1.

Total baris stok diinput  : 10
Item per Pembelian varian : 5
Stok tersedia untuk       : 10 ÷ 5 = 2x pembelian

Beli 1 qty → bot ambil 5 baris teratas, kirim sekaligus ke buyer (sisa 5 baris)
Beli 1 qty lagi → bot ambil 5 baris terakhir, kirim sekaligus (stok habis)

Pastikan jumlah baris stok yang diinput adalah kelipatan dari Item per Pembelian bot menghitung stok yang bisa dibeli pakai pembagian bulat ke bawah, jadi sisa baris yang tidak cukup untuk 1 paket penuh tidak akan dihitung sebagai stok tersedia (bukan error/gagal, tapi diam-diam "hilang" dari hitungan sampai ditambah stok lagi):

Total baris stok diinput     : 12
Stok yang dihitung tersedia  : floor(12 ÷ 5) = 2x pembelian saja
Sisa 2 baris di ujung        : tidak terhitung, tidak bisa dibeli buyer

Buyer hanya bisa beli maksimal 2 qty (dapat 10 baris terkirim)
2 baris sisanya baru bisa terpakai setelah Admin Toko nambah 3 baris lagi (total 15 = kelipatan 5)

Hapus Stok (Inline Telegram)

1. Buka /admin → 📦 Stok/Inventory
2. Pilih Produk
3. Pilih Varian
4. Klik salah satu Item atau hapus semua
5. Hapus ✅

Fitur Garansi

Fitur klaim garansi memungkinkan buyer melapor kendala produk langsung lewat bot. Semua klaim diteruskan real-time ke Channel Garansi milik toko tidak disimpan sebagai riwayat/database, jadi channel ini berfungsi sebagai "kotak masuk" klaim buyer.

Cara Buyer Klaim Garansi

1. Buyer klik tombol 🛡️ Claim Garansi di menu utama bot
2. Bot menampilkan daftar format garansi yang aktif (dibuat Admin Toko sebelumnya)
3. Buyer pilih salah satu format garansi
4. Bot menampilkan isi/template garansi (syarat & cara klaim) dalam bentuk teks
5. Buyer membalas pesan tersebut isi keterangan klaim (mengikuti template), boleh lampirkan foto/screenshot bukti sebagai caption
6. Bot menampilkan preview klaim dengan tombol Kirim / Batal
7. Setelah buyer klik Kirim, klaim otomatis diteruskan ke Channel Garansi yang sudah diset Admin Toko

Cara Tambah Format Garansi

Ada 2 tahap: siapkan Channel Garansi dulu, baru buat format garansinya.

Tahap 1: Siapkan Channel Garansi (sekali saja)

1. Buat channel Telegram baru, misal "Garansi Toko Anda"
2. Masukkan bot ke channel tersebut sebagai anggota
3. Jadikan bot sebagai Admin channel (kasih izin kirim pesan)
4. Salin link/username channel (contoh: https://telegram.me/garansitokoanda)
5. Buka /admin → ⚙️ Settings → Profil Toko → Channel Garansi → paste link tadi → simpan

Tahap 2: Buat format garansi

1. Buka /admin → 🛡️ Garansi
2. Klik ➕ Tambah
3. Kirim Nama format (contoh: "Garansi Netflix Private")
4. Kirim isi/Content format (syarat, ketentuan, cara klaim bebas teks)
5. Format tersimpan dan otomatis muncul sebagai pilihan saat buyer klik Claim Garansi

✏️ Edit / 🗑️ Hapus: pilih format yang ada di daftar → Edit Nama / Edit Isi, atau Hapus.