Fix Status WhatsApp
BY @NandSkie · fixsw.zenand.my.id · v2 — Sistem Akun
Mengecek sesi login kamu.
Arsitektur & Keamanan Demo — baca ini dulu
Validasi ketat di halaman ini (cek format, batas file, kunci login, sanitasi caption) hanya untuk pengalaman pengguna (UX) dan saringan pertama. Frontend bisa di-bypass siapa pun lewat DevTools — jadi demo ini belum aman beneran hanya karena tampilannya ketat.
Sisi baiknya: frontend asli FixStatus jalan di Cloudflare Pages, yang memang aman untuk menyajikan file statis — HTTPS otomatis, CDN global, dan perlindungan DDoS bawaan. Tapi keamanan akun, role, dan upload tetap harus ditegakkan di backend-nya, yaitu Pages Functions di folder functions/ (contoh yang sudah ada: functions/api/login.js, functions/api/config.js, functions/api/jadibot/[[path]].js).
Pemisahan arsitektur yang direncanakan (jangan dicampur):
- Frontend → Cloudflare Pages · Backend web → Pages Functions di folder functions/
- Database akun web (user, role, premium, aktivitas) → rekomendasi utama: Cloudflare D1 — terintegrasi langsung dengan Pages Functions, tanpa server tambahan, dan cocok untuk data akun/role/aktivitas. Alternatifnya: Supabase / Postgres bila nanti butuh fitur Auth yang lebih lengkap. Sudah dipakai di demo ini.
- Database bot WA → tetap di VPS, terpisah dari DB akun. Aturan arsitektur: jangan pernah mencampur DB bot dengan DB akun web.
- File media → Cloudflare R2 — Functions yang memberi URL/aksesnya, bukan bot dan bukan frontend langsung.
- Bot WA → VPS terpisah. Web hanya mengaksesnya lewat API dengan API key server-side (FIXSW_API_URL / FIXSW_API_KEY di Environment Variables) — bot hanya menyediakan route kirim media, cek anggota grup, dan hapus pesan.
- Di produksi, semua validasi wajib dicek ulang di Functions — bukan cuma di browser.
- Role (user / premium / owner) dicek di Functions lewat JWT yang ditandatangani server, bukan dari localStorage seperti demo ini.
- Login Google: ID token wajib diverifikasi di Functions (functions/api/auth/google.js) memakai Google Cloud OAuth Client ID — browser saja tidak cukup.
- Password wajib di-hash dengan bcrypt / argon2 di Functions — jangan pernah disimpan polos.
- Rate limit & lockout login ditegakkan di Functions, bukan cuma hitung mundur 60 detik di browser seperti demo ini.
- File divalidasi ulang tipe & ukurannya di Functions sebelum diteruskan ke bot.
- Secrets HANYA boleh disimpan di Environment Variables Cloudflare Pages (FIXSW_API_URL, FIXSW_API_KEY, ADMIN_AUTH_KEY, dan sejenisnya). Jangan pernah hardcode di index.html atau frontend mana pun — API bot hanya boleh dipanggil Functions dengan API key itu.
Backend akun (Pages Functions + D1) — yang sudah ada & yang masih perlu dibuat:
- functions/api/auth/register.js — daftar akun + hash password, simpan user & role di D1
- functions/api/auth/login.js — login + rate limit / lockout + terbitkan JWT, data akun dari D1
- functions/api/auth/google.js — verifikasi ID token Google, cocokkan / buat akun di D1
- functions/api/groups/check.js — cek nomor WA sudah join grup, diteruskan ke Bot API di VPS
- functions/api/upload.js — terima & validasi ulang file sesuai role, simpan media ke R2
- functions/api/messages/send.js — minta bot di VPS mengirim media (dari R2) ke grup lewat Bot API
- functions/api/activity.js — daftar aktivitas / monitoring per user dari D1
- functions/api/messages/[id].js — hapus pesan (revoke) lewat bot di VPS, hanya milik user sendiri
- functions/api/admin/users.js — Owner Panel: kelola user, role, ban di D1 (wajib cek JWT role owner)
- Di sisi bot (VPS) cukup sediakan route: kirim media ke grup, cek anggota grup, hapus pesan — DB bot tetap di VPS dan tidak dicampur dengan D1.
Halo!
—
Verifikasi Grup Bot
Media hanya bisa dikirim kalau nomor WhatsApp kamu sudah gabung di salah satu Room grup Bot. Nomor kamu: —
Status dicek langsung ke bot lewat API — pastikan nomor kamu sudah gabung di salah satu Room di atas.
Kasih Rating & Komentar
Ceritakan pengalaman kamu pakai FixStatus. Satu akun satu rating untuk satu upload — rating kamu bisa diedit atau dihapus kapan saja.
Ketuk bintang 1–5. Belum memilih bintang.
Maksimal 300 karakter. Dilarang SARA & pornografi — komentar yang melanggar akan ditolak / auto-delete dan nomor bisa di-blacklist, sama seperti aturan upload & Chat CS.
Kata Mereka — Rating Pengguna
Ulasan asli dari pengguna FixStatus. Klik tombol suka kalau ulasan ini membantu kamu.
Kirim Media ke Grup WA
Pilih metode kirim dulu, lalu upload gambar atau video. Tanpa token, tanpa copy-paste.
Metode 3 — RentBot
Segera hadir — sewa bot sendiri. Belum bisa dipakai.
Catatan: Metode Token lama sudah diganti Bot Utama di v2.
Jadibot — Hubungkan WA Kamu
Nomor WA dari akun kamu dipakai otomatis (tidak bisa diganti). Kamu akan dapat kode pairing untuk dimasukkan di WhatsApp: Perangkat Tertaut → Tautkan dengan nomor telepon.
Media dikirim langsung ke WA kamu sendiri, lalu kamu teruskan manual ke Status Saya.
Aktivitas & Monitoring
Semua media yang kamu kirim lewat website ini. Pantau statusnya, lihat lagi, atau hapus pesan dari grup.
Profil & Pengaturan
Data akun FixStatus kamu.
Chat 1-lawan-1 dengan CS. Bisa kirim teks, gambar, video & file.
Klik untuk memuat daftar percakapan customer, lalu balas langsung — anti-delay.
Status Bot Utama, perintah & token, plus sesi Jadibot kamu — semua dalam satu halaman Bot.
Semua endpoint API FixStatus: status, sesi, grup, kirim v1/v2, riwayat & hapus — lengkap dengan playground dan contoh kode.
Bot WA & Jadibot
Dua layanan bot dalam satu halaman. BotWA = bot utama FixStatus di grup. Jadibot = nomor WA kamu sendiri yang dijadikan bot. Tinggal pilih tab-nya.
Status Bot Utama
Statistik di atas dihitung dari log aktivitas demo di browser ini.
Cara Pakai Token FixStatus (cara lama)
- Upload media seperti biasa, kamu dapat token / ID pesan (contoh: FS-XXXX-XXXX).
- Buka grup ChatBot FixStatus (Room 1–3 di Beranda).
- Kirim perintah .fixstatus FS-XXXX-XXXX di grup — bot mengambil media-nya dan meneruskan tanpa kompres ulang.
- Di v2, cara akun (Bot Utama) lebih simpel: upload dari web langsung terkirim ke grup, tanpa copy token. Token tetap didukung untuk cara lama.
Perintah Bot Contoh
Sesi Jadibot Saya
Jadibot menghubungkan nomor WA kamu sendiri. Media dari web dikirim ke WA kamu, lalu kamu teruskan ke Status. Satu akun memakai nomor WA akun itu.
Hubungkan Nomor Baru
Nama sesi / nomor ini juga dicek aturan konten — nama atau nomor dari akun ter-blacklist tidak bisa dihubungkan.
QR dibuat oleh bot dan hanya berlaku sebentar. Kalau kedaluwarsa, buat QR baru.
Tombol ini membuka halaman Upload dengan metode Jadibot yang sudah ada.
Panel API
Route: /panelSemua yang berhubungan dengan API FixStatus ada di sini: status server, autentikasi, semua endpoint BotWA & Jadibot, playground buat coba request langsung, contoh kode, kode error, dan log request.
Status & Ringkasan
Autentikasi & API Key
Semua endpoint (kecuali GET /) wajib memakai header x-api-key. Dari website, key ini tidak pernah dikirim browser — Pages Functions yang menyisipkannya dari Environment Variables Cloudflare (FIXSW_API_URL & FIXSW_API_KEY).
Membuat ulang key di demo ini hanya mengganti contoh di browser. Di produksi, key diganti di Environment Variables Cloudflare + config bot di VPS, lalu keduanya di-restart — key lama langsung tidak berlaku.
curl https://demo.zenand.my.id/session/list \ -H "x-api-key: <API_KEY_KAMU>"
Cara Web Memanggil API
Semua Endpoint
12 endpoint resmi API gabungan (BotWA + Jadibot). Klik Coba untuk membuka endpoint itu di playground, atau Salin curl untuk contoh perintahnya.
Playground — Coba Request
Pilih endpoint, isi parameter, lalu kirim. Di demo ini responnya disimulasikan di browser (status, isi JSON, dan waktu respon contoh) dan tercatat di Log Request di bawah.
Contoh curl
Respon 200 OK
Log Request (Demo)
Request terakhir dari playground halaman ini, tersimpan di browser. Di produksi, log asli ada di VPS (log API Go) dan bisa dipantau owner dari sana.
Kode Error & Batasan
Arti kode respon API dan batas yang berlaku untuk semua pemanggil.
| Kode | Arti | Yang harus dilakukan |
|---|---|---|
| 200 | Berhasil | Baca isi JSON-nya — field status bernilai true. |
| 400 | Request salah — parameter / body kurang atau formatnya keliru | Cek lagi nomor (format 628xxx), field wajib, dan validitas JSON body. |
| 401 | API key salah atau tidak dikirim | Pastikan header x-api-key terisi key yang benar (di web: cek Environment Variables Cloudflare). |
| 404 | Data tidak ditemukan — sesi / pesan / riwayat tidak ada | Cek lagi nomor sesi atau ID pesan (FS-…) yang diminta. |
| 429 | Terlalu banyak request (rate limit) | Tunggu sebentar lalu coba lagi — jangan spam request beruntun. |
| 500 | Error di server bot (VPS) | Cek status bot di halaman Bot / log VPS. Biasanya soal koneksi WhatsApp bot. |
- Format nomor WhatsApp selalu 628xxx (tanpa +, spasi, atau strip).
- Media FixStatus maksimal 100MB per file — API tidak menaikkan kualitas, hanya meneruskan kualitas asli tanpa kompres ulang.
- Kode pairing Jadibot bersifat custom 8 karakter (contoh pola NAND-XXXX) dan kedaluwarsa dalam ±160 detik — buat sesi baru kalau sudah lewat.
- Aturan konten berlaku juga lewat API: konten SARA & pornografi ditolak, pesan auto-delete, dan nomor pengirim bisa di-blacklist.
- Jangan pernah menaruh API key asli di frontend / kode publik — selalu lewat Pages Functions (server-side).
Owner Panel
Hanya untuk akun OWNER, dibuka dari Profil. Di produksi, akses wajib dicek ulang di Pages Functions (functions/api/admin/users.js) dari JWT server — menyembunyikan tombol di frontend saja tidak cukup.
Ringkasan cepat FixStatus hari ini. Kelola user di tab Pengguna, pantau semua kiriman di Aktivitas, dan ubah batas di Pengaturan.
Manajemen User
Cari user, ubah role, ban / unban, atau hapus akun. Akun ter-ban tidak bisa login dan tidak bisa upload.
| User | Kontak | Role | Status | Aksi |
|---|
Log Aktivitas Global
Semua kiriman dari semua user. Pesan juga bisa dihapus dari sini — selalu dengan konfirmasi dulu.
Pengaturan
Batas user gratis, status bot, dan link Saweria. Tersimpan di browser ini (demo) dan langsung berpengaruh.
Rating & Komentar
Semua ulasan pengguna. Filter per bintang, cari komentar, hapus yang melanggar, dan balas ulasan — terutama yang bintang 1–2.
Moderasi / Blacklist
Konten SARA & pornografi = auto-delete + blacklist nomor. Di bawah ini daftar nomor ter-blacklist & log auto-delete (demo, tersimpan di browser).
Daftar Blacklist
Log Auto-Delete
Pesan Masuk — Chat CS
Semua customer yang chat CS. Klik satu percakapan untuk membalas langsung. Pesan baru muncul tanpa refresh (simulasi WebSocket).
Batas chat: gambar JPG/PNG/WebP • video MP4 maks 50MB • file lain maks 10MB. Di produksi media chat juga lewat tmpfile.link.