Dokumentasi BotForge

Buat Akun & Bot Pertama

Semua bot di BotForge dikonfigurasi lewat dashboard — tidak perlu menulis kode sama sekali.

1. Daftar akun BotForgeBuka /register, isi nomor WhatsApp/email dan password, lalu verifikasi lewat kode OTP yang dikirim.
2. Buat bot Telegram lewat @BotFatherDi Telegram, chat @BotFather → kirim /newbot → ikuti instruksinya → salin token bot yang diberikan (formatnya 123456:ABC-def...).
3. Tambahkan bot di dashboard BotForgeDashboard → "Bot Saya" → "+ Tambah Bot" → pilih tipe bot (VIP, FSUB, AI, atau Menfes) → tempel token dari BotFather → simpan. BotForge otomatis mendaftarkan webhook Telegram-nya, bot langsung aktif.
4. Jadikan bot sebagai admin (VIP/FSUB)Kalau bot Anda tipe VIP atau FSUB, tambahkan bot sebagai admin di grup/channel tujuan — bot butuh izin ini untuk membuat link invite atau mengecek keanggotaan.

Konfigurasi VIP Bot

VIP Bot menjual akses berbayar ke grup/channel Telegram — pembeli scan QRIS, bot otomatis kirim link invite atau approve permintaan join.

1. Tambah produk

1. Buka tab "Produk" di halaman botKlik bot VIP Anda di dashboard → tab "Produk" → "+ Tambah Produk".
2. Isi detail produkNama produk, kode produk (bebas, buat identifikasi internal), harga (Rp), dan opsional URL gambar preview yang tampil saat pembeli klik "JOIN".
3. Isi ID Grup/Channel TujuanUsername (@namagrup) atau ID numerik (-1001234567890) dari grup/channel yang mau dijual aksesnya — BUKAN kode produk bebas di atas.
4. Pilih mode penjualan"Link Otomatis" (bot langsung kirim link invite begitu dibayar) atau "Approve Manual" (pembeli request join, bot approve otomatis setelah verifikasi pembayaran).
5. Atur Join Limit & Masa BerlakuBerapa kali link invite bisa dipakai dan berapa lama link tersebut berlaku, sebelum otomatis kedaluwarsa.

2. Atur teks & payment provider

1. Buka tab "Konfigurasi"Atur teks sambutan (welcome text) yang tampil saat user pertama kali /start, dan teks List VIP/Syarat & Ketentuan yang tampil sebelum daftar produk.
2. Pilih Payment ProviderSaweria, Pakasir, atau HadesPay — lihat bagian Pembayaran di bawah untuk cara setting masing-masing.

Konfigurasi FSUB Bot

FSUB Bot mewajibkan user join channel/grup tertentu dulu sebelum bisa memakai fitur bot Anda — cocok untuk menaikkan subscriber channel promosi.

1. Tambah channel wajib joinTab "Channel Wajib Join" → "+ Tambah Channel" → isi username/ID channel. Bisa lebih dari satu channel sekaligus.
2. Atur Storage Chat IDTab Konfigurasi → isi channel/grup privat tempat konten premium Anda disimpan (bot harus jadi admin di sini juga) — ini sumber konten yang di-forward ke user setelah lolos verifikasi.
3. Atur teks ajakan joinIsi "Join Prompt Text" — pesan yang tampil ke user yang belum join semua channel wajib.
4. Upload konten & buat batchTab "Konten & Batch" → pilih konten dari Storage Chat ID → kelompokkan jadi satu batch bernama (mis. "Materi Minggu 1") yang bisa dibagikan ke user.

Konfigurasi Bot AI

Chatbot AI custom yang membalas otomatis di Telegram, kompatibel dengan API bergaya OpenAI (chat/completions) — bisa pakai OpenAI, DeepSeek, Groq, OpenRouter, atau provider lain yang kompatibel.

1. Buka tab "Config Bot"Klik bot AI Anda di dashboard → tab "Config Bot".
2. Isi Base URL APIDefault https://api.openai.com/v1 — ganti sesuai provider yang Anda pakai (mis. endpoint DeepSeek/Groq/OpenRouter).
3. Isi API Key & ModelAPI key dari provider AI Anda, dan nama model yang mau dipakai (mis. gpt-4o-mini).
4. Tulis System PromptKepribadian dan aturan bot ini — instruksi ini dikirim ke model di setiap percakapan.

Konfigurasi Menfes Bot

Bot confession/menfes anonim dengan sistem coin — user top up coin, lalu kirim pesan berprefix untuk diposting anonim ke channel Anda.

1. Tambah prefix menfesTab produk → "+ Tambah Prefix" → isi label & prefix (mis. #curhat). User mengawali pesan dengan prefix ini untuk mengirim menfes.
2. Atur channel tujuanTab Konfigurasi → isi ID/username channel tempat menfes diposting — pastikan bot sudah jadi admin di channel tersebut.
3. Atur harga coinIsi "Coin per Pesan" (biaya coin yang terpotong tiap kirim menfes) dan "Harga Jual Coin" (harga per coin yang dibayar user saat top up).
4. Pastikan stok coin tersediaAnda perlu top up stok coin lebih dulu (lewat halaman top up coin BotForge) sebelum user bisa membeli — stok berkurang tiap user top up.

Setting Payment Gateway: Saweria

Dipakai kalau Anda pilih Saweria sebagai Payment Provider di Konfigurasi VIP Bot. Kredensial ini milik Anda sendiri — pembayaran masuk langsung ke akun Saweria Anda.

1. Siapkan akun Saweria AndaKalau belum punya, daftar dulu di saweria.co.
2. Ambil API Key dari akun Saweria AndaMasuk ke pengaturan akun/API pada dashboard Saweria Anda, lalu salin API Key yang tersedia di sana. (Tampilan menu Saweria bisa berubah sewaktu-waktu — cari bagian terkait "API" atau "Developer" di pengaturan akun Anda.)
3. Buka Pengaturan → Kredensial Pembayaran di BotForgeDashboard BotForge → menu "Pengaturan" → "Kredensial Pembayaran" → bagian "Integrasi Saweria".
4. Tempel API Key, lalu simpanMasukkan ke field "API Key Saweria Anda" → klik "Simpan API Key".
5. Salin URL Webhook Saweria AndaMasih di halaman yang sama, klik "Salin" pada field "URL Webhook Saweria Anda" — formatnya kira-kira:
   https://[domain-botforge-anda]/api/webhook/saweria/[token-unik-anda]
6. Tempel URL webhook itu ke dashboard SaweriaBuka pengaturan webhook/notifikasi pada akun Saweria Anda → tempel URL dari langkah sebelumnya → simpan.
7. Pilih "Saweria" sebagai Payment Provider bot AndaBuka bot VIP Anda → tab Konfigurasi → pilih Payment Provider "Saweria" → simpan.

Setting Payment Gateway: Pakasir

Dipakai kalau Anda pilih Pakasir sebagai Payment Provider. Sama seperti Saweria, kredensial ini milik Anda sendiri.

1. Siapkan akun & proyek PakasirDaftar/masuk di app.pakasir.com, lalu buat proyek kalau belum ada.
2. Ambil Project Slug & API KeyBuka halaman detail proyek Anda di dashboard Pakasir → salin "Project Slug" dan "API Key" yang tertera di sana.
3. Buka Pengaturan → Kredensial Pembayaran di BotForgeBagian "Integrasi Pakasir".
4. Isi Project Slug & API Key, lalu simpanKlik "Simpan Konfigurasi Pakasir".
5. Salin URL Webhook Pakasir Anda & tempel ke dashboard PakasirTempel ke kolom "Webhook URL" pada halaman Edit Proyek di dashboard Pakasir Anda.
6. Pilih "Pakasir" sebagai Payment Provider bot AndaBot VIP → tab Konfigurasi → Payment Provider "Pakasir" → simpan.

HadesPay — Tanpa Setup Sama Sekali

HadesPay adalah gateway internal BotForge — kredensialnya dikelola langsung oleh owner platform, jadi Anda tidak perlu mengisi apapun di halaman Kredensial Pembayaran.

1. Buka bot VIP Anda → tab KonfigurasiPilih Payment Provider "HadesPay" → simpan. Selesai — tidak ada langkah tambahan.
2. Pembeli otomatis dapat pilihan metodeSaat checkout, pembeli diarahkan ke halaman pembayaran dengan pilihan QRIS, Crypto, atau PayPal sesuai channel yang diaktifkan owner platform.
3. Dana masuk ke Saldo BotForge AndaSetelah dipotong fee platform, dana pembeli otomatis dikreditkan ke Saldo BotForge Anda — bisa dicairkan lewat fitur Withdraw.

Saldo BotForge & Withdraw

Saldo BotForge adalah saldo internal di akun Anda (beda dari saldo di akun Saweria/Pakasir pribadi Anda) — bertambah lewat HadesPay, komisi referral, atau deposit manual.

1. Cek saldo AndaLihat di halaman Dashboard atau menu Saldo pada sidebar.
2. Ajukan withdrawBuka menu Withdraw → isi nominal & rekening/e-wallet tujuan → ajukan.
3. Tunggu diprosesTergantung metode yang diaktifkan owner platform — otomatis lewat Midtrans Iris, atau dikonfirmasi manual oleh admin.

Upgrade Paket

Tiap paket membuka kombinasi tipe bot dan jumlah bot yang berbeda — lihat detail lengkap di halaman Harga.

1. Buka menu Upgrade PaketDari Dashboard → pilih paket yang diinginkan.
2. Selesaikan pembayaranLewat gateway platform yang aktif (Midtrans/Xendit/Tripay/HadesPay).
3. Paket aktif otomatisSisa waktu langganan lama otomatis diperhitungkan (prorata) kalau Anda upgrade sebelum masa aktif habis.

FAQ Teknis

• Bot tidak meresponCek token bot masih valid di BotForge, dan bot belum di-block/dihapus dari sisi Telegram.
• QR pembayaran tidak munculPastikan API Key gateway (Saweria/Pakasir) sudah diisi & benar di halaman Kredensial Pembayaran.
• Pembayaran sudah masuk tapi bot tidak meresponCek URL webhook sudah tertempel dengan benar di dashboard Saweria/Pakasir Anda, sesuai token yang tertera di BotForge.
• Gagal buat link invite grupPastikan bot sudah dijadikan admin di grup/channel tujuan, dan ID/username yang diisi di field grup/channel tujuan sudah benar.
• FSUB tidak mendeteksi user sudah joinBot butuh status admin di channel wajib join untuk bisa mengecek keanggotaan — pastikan sudah ditambahkan.