mattu0501/whatsapp-v3 repository overview

DOKUMENTASI API GATEWAY V3.0

Format URL GET / POST Universal: http://ServerWAGateway:3000/send-message?param_number=[number]&text=[text⁠] Endpoint ini bersifat universal dan fleksibel untuk sistem apapun. Anda tidak perlu menentukan kode khusus. Setiap pesan yang masuk akan otomatis dideteksi kategorinya dan otomatis di-spin dengan Anti-Ban Engine.

Parameter yang Didukung: param_number / phone / number / to: Nomor WhatsApp tujuan (Contoh: 08123456789 / 628123456789) text / message / msg: Isi teks pesan yang dikirim (Diutamakan 100% dari Billing) code / condition: (Opsional) Kode kondisi template jika pesan kosong (test_wa, reminder_7d, expired, payment_received) name / username / price / package / payment_link / bills: Variabel otomatis dari PHPNuxBill ⚙️ HANYA 1 URL API UNTUK SEMUA NOTIFIKASI PHPNuxBill URL WhatsApp Gateway di Pengaturan PHPNuxBill:

http://ServerWAGateway:3000/send-message?number=[number]&text=[text⁠] ✅ Sistem Gateway Otomatis Pintar (Smart Auto-Detection):

Meskipun di PHPNuxBill Anda menggunakan &text=[text], &code=[text], atau &msg=[text], Server Gateway secara otomatis mendeteksi isi pesan asli dari PHPNuxBill tanpa tertimpa pesan tes ping atau template lain!

Format Variabel PHPNuxBill yang Didukung Sepenuhnya:

%name% atau [[name]] Nama Pelanggan %username% atau [[username]] User PPPoE / Hotspot %package% atau [[package]] Nama Paket Internet %price% atau [[price]] Harga / Total Tagihan %payment_link% atau [[payment_link]] Link Invoice Payment %bills% atau [[bills]] Detail Rincian Tagihan Contoh Penggunaan GET Query (Auto-Loaded Environment): http://ServerWAGateway:3000/send-message?param_number=08123456789&text=Yth+Budi,+tagihan+internet+sebesar+Rp+150.000+jatuh+tempo+besok⁠. Contoh cURL POST JSON: curl -X POST "http://ServerWAGateway:3000/send-message⁠"
-H "Content-Type: application/json"
-d '{ "param_number": "08123456789", "text": "Halo Budi, tagihan internet sebesar Rp 150.000 jatuh tempo besok." }'

TROUBLESHOOTING DEPLOYMENT DI SERVER / VPS LAIN Jika Anda mengalami masalah di mana status QR Code gantung pada GENERATING FRESH QR STREAM... Connecting Baileys Socket Engine, penyebab utamanya adalah:

1. Timeout Fetching WhatsApp Version dari GitHub: Baileys mencoba mengunduh versi WA Web terbaru dari raw.githubusercontent.com. Jika VPS memblokir atau memperlambat koneksi ini, socket akan gantung. Sistem V3 kami telah menambahkan fallback versi lokal otomatis dalam 3000ms.

2. IPv6 DNS Stall pada Linux Server: Node.js di server Linux secara default mendahulukan IPv6. Jika IPv6 VPS tidak aktif, koneksi WebSocket gantung. Sistem V3 kami memaksa setDefaultResultOrder('ipv4first').

3. Stale Session / Companion JID Suffix: Jika nomor tujuan memiliki beberapa perangkat terhubung, onWhatsApp terkadang mengembalikan JID perangkat :x atau @lid. Sistem V3 sudah memaksa normalisasi jidNormalizedUser agar pesan selalu mendarat di HP utama.

⚠️ Pesan Terlihat Terkirim di Logs tapi Tidak Masuk HP Tujuan di CHR? Mount Persistent Volume /app/session: Pastikan /app/session di-mount ke disk CHR (RouterOS mount) agar token autentikasi tidak korup saat container di-restart. Normalisasi JID Otomatis: Sistem V3 sudah dikerahkan dengan pembersihan suffix :device dan pemrosesan antrean otomatis jika socket sempat terputus NAT RouterOS. Reset Session jika Masih Terkendala: Jika pesan tetap tidak terkirim, klik "Reset Session Folder" lalu scan QR ulang untuk menyegarkan kunci enkripsi Signal Protocol dengan server WhatsApp.

⚡ MIKROTIK CHR CONTAINER ENVIRONMENT & MOUNTS: Semua parameter lingkungan (ENV) dan folder mount dari RouterOS MikroTik CHR didukung secara otomatis tanpa mengunci IP lokal:

/container envs
add comment=whatsapp key=PORT name=WA_GATEWAY_V3.0 value=3000
add comment=whatsapp key=SESSION_PATH name=WA_GATEWAY_V3.0 value=/app/session
add comment=whatsapp key=MEDIA_PATH name=WA_GATEWAY_V3.0 value=/app/media
add comment=whatsapp key=DATA_PATH name=WA_GATEWAY_V3.0 value=/app/data
add comment=whatsapp key=LOGS_PATH name=WA_GATEWAY_V3.0 value=/app/logs
add comment=whatsapp key=SUPERADMIN_USER name=WA_GATEWAY_V3.0 value=bosbesar
add comment=whatsapp key=SUPERADMIN_PASS name=WA_GATEWAY_V3.0 value=rahasia123
add comment=whatsapp key=ADMIN_USER name=WA_GATEWAY_V3.0 value=karyawan
add comment=whatsapp key=ADMIN_PASS name=WA_GATEWAY_V3.0 value=karyawan123

/container mounts
add dst=/app/session name=wa-session-WA_GATEWAY_V3.0 src=/Container/WS/WA_GATEWAY_V3.0
add dst=/app/media name=wa-media-WA_GATEWAY_V3.0 src=/Container/CT/WA_GATEWAY_V3.0
add dst=/app/logs name=wa-logs-WA_GATEWAY_V3.0 src=/Container/LOG/WA_GATEWAY_V3.0
add dst=/app/data name=wa-data-WA_GATEWAY_V3.0 src=/Container/DATA/WA_GATEWAY_V3.0