Tentang Hikuy

Informasi, Arsitektur & Kapabilitas Integrasi Hikuy

Panduan lengkap mengenai cara kerja sistem langganan bulanan, arsitektur WhatsApp Gateway, serta modul khusus aplikasi pihak ketiga yang menyewa infrastruktur Hikuy.

1. Cara Kerja Langganan Bulanan & Device

Setiap akun mendapatkan 1 Nomor / Device WhatsApp (CS SATU) yang langsung terhubung dengan nomor pendaftaran setelah scan QR Code. Setiap permintaan ke POST /api/v1/messages atau POST /api/send mengecek kuota paket bulanan aktif terlebih dahulu.

2. Arsitektur Antrean & Engine

Pesan yang lolos verifikasi billing disimpan ke messages_log dan dilempar ke antrean background (ProcessWhatsAppMessage) untuk diteruskan ke Hikuy Engine (Node.js + Baileys) dengan dukungan prioritas instan (delay: 0 untuk OTP/Invoice) maupun jeda aman broadcast.

Modul Ekosistem Penyewa API

Fitur Khusus Integrasi Aplikasi Pihak Ketiga

Keempat modul di bawah ini dirancang khusus untuk aplikasi pihak ketiga (ERP, e-Commerce, aplikasi logistik/transportasi seperti Balioh, CRM, dan sistem internal perusahaan) yang menyewa layanan WhatsApp Gateway Hikuy:

🗓️ Kirim, Schedule & Template

Pengiriman pesan teks, gambar/PDF via URL, mention anggota grup (@g.us), variabel dinamis, serta penjadwalan waktu kirim (schedule_at) langsung dari endpoint API aplikasi pihak ketiga.

🤖 Autoreply & Spreadsheet

Mesin balasan otomatis berbasis kata kunci (exact, contains, regex) dan sinkronisasi data kata kunci dari Google Spreadsheet eksternal milik penyewa.

🔔 Webhook & Device Notif

Penerusan pesan masuk (message.incoming), pembaruan status pesan (message.status), dan peringatan putus koneksi device (session.status) secara real-time dengan tanda tangan keamanan HMAC-SHA256 (X-Hikuy-Signature).

🎧 Fitur Agent CS & Inbox

Integrasi multi-agent Customer Service dan pencatatan percakapan 2 arah (pesan masuk & pesan keluar) untuk diintegrasikan ke dashboard Inbox aplikasi penyewa.

Langkah Cepat Memulai (Quick Start)

  1. Daftar akun melalui halaman /daftar dengan mengisi nomor WhatsApp aktif Anda.
  2. Lakukan Scan QR Code pada Langkah 2 untuk mengaktifkan 1 device otomatis Anda (CS SATU).
  3. Pilih atau upgrade paket bulanan melalui tombol ⚡ Upgrade Paket di sebelah kanan device.
  4. Salin api_key dari Dashboard dan hubungkan ke aplikasi Anda melalui endpoint POST /api/send atau POST /api/v1/messages.