Panduan Integrasi API

Gunakan dokumentasi ini untuk menghubungkan aplikasi Anda (WHMCS, PHP, Python, dll) dengan Gateway WhatsApp ini.

1. Informasi Dasar

Method: GET / POST / JSON

URL Endpoint:

https://wa-api1.maudynetwork.com/api.php

2. Contoh Penggunaan GET (URL)

Tes langsung di browser:

https://wa-api1.maudynetwork.com/api.php?token=TOKEN&to=628xxx&message=Halo

2. Parameter API

ParameterDeskripsiWajib
tokenAPI Token yang dibuat di menu "Token API"Ya
toNomor tujuan (Contoh: 628123456789)Ya
message / msgIsi pesan teks yang ingin dikirimYa
modepriority (Default) atau randomOpsional
device_idID Sesi untuk mengirim via nomor spesifikOpsional
attachmentFile (Image/PDF/Doc). Gunakan Multipart Form Data.Opsional

3. Mode Pengiriman (Routing)

  • Berdasarkan Prioritas (Default):
    mode=priority - Otomatis menggunakan nomor dengan prioritas tertinggi yang aktif.
  • Acak (Random):
    mode=random - Pesan akan disebar secara acak ke semua nomor yang aktif (Load Balancing).
  • Nomor Spesifik:
    device_id=_12345678 - Pesan akan dipaksa dikirim melalui nomor tertentu sesuai ID Sesi.

4. Panduan Instalasi cPanel (Hosting)

  1. Upload File: Upload semua file folder ini ke folder tujuan di cPanel (misal: public_html/wa-api1).
  2. Setup Node.js App:
    • Cari menu "Setup Node.js App" di cPanel.
    • Klik "Create Application".
    • Application Root: Isi dengan path folder tadi (misal: public_html/wa-api1).
    • Application URL: Sesuaikan dengan domain Anda.
    • Application Startup File: Isi dengan server.js.
  3. Install Dependencies: Setelah aplikasi Node.js dibuat, klik tombol "Run JS Install" atau jalankan npm install via Terminal cPanel.
  4. Konfigurasi Port: Pastikan port yang digunakan (default 3000) tidak diblokir oleh Provider Hosting Anda. Jika perlu, ubah port di menu Pengaturan.
  5. PENTING (Chromium): Beberapa hosting Shared (biasa) memblokir jalannya Chromium. Jika muncul error Puppeteer, hubungi support hosting untuk mengizinkan "Headless Chrome" atau gunakan layanan VPS.
  6. Terminal Access: Untuk masuk ke lingkungan Node.js via Terminal, gunakan perintah:
    source /home/mauh8935/nodevenv/wa-api1/14/bin/activate && cd /home/mauh8935/wa-api1

5. Contoh Kode (PHP CURL)

A. Kirim Pesan Teks

$url = 'https://wa-api1.maudynetwork.com/api.php';
$data = [
    'token'   => 'ISI_TOKEN_ANDA',
    'to'      => '628123456789',
    'message' => 'Halo, ini pesan dari API!'
];

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

B. Kirim Pesan dengan File (PDF/Gambar)

$url = 'https://wa-api1.maudynetwork.com/api.php';
$file_path = '/path/ke/file/nota.pdf'; // Path absolut file di server

$data = [
    'token'      => 'ISI_TOKEN_ANDA',
    'to'         => '628123456789',
    'message'    => 'Ini file nota pesanan Anda.',
    'attachment' => new CURLFile($file_path)
];

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);
echo $response;