MPWA Whatsapp Gateway (CPanel)

Panduan lengkap untuk menginstal MPWA di CPanel.

Pendahuluan

MPWA adalah gateway WhatsApp multi-perangkat yang tangguh, dirancang untuk bekerja dengan lancar di berbagai lingkungan hosting. Panduan ini akan memandu Anda melalui persyaratan instalasi dasar dan menyediakan langkah-langkah rinci untuk menjalankan MPWA secara efisien.

Fitur

Anda dapat melihat fitur-fiturnya di sini.

Persyaratan

Sebelum memulai, pastikan lingkungan CPanel Anda memenuhi persyaratan berikut:

  • PHP: Versi 8.1 atau lebih tinggi.
  • Node.js: Versi 18 atau lebih tinggi.
  • MySQL: Instance database MySQL yang sudah dikonfigurasi.

Alat-alat ini sangat penting untuk fungsi MPWA dan harus diinstal serta dikonfigurasi dengan benar pada lingkungan hosting Anda.

Instalasi

Langkah 1: Membuat Domain

  1. Masuk ke CPanel Anda.

  2. Buka Domains dan buat domain baru jika Anda belum memilikinya.

    Domains

Langkah 2: Membuat Database

  1. Buka Manage My Database di CPanel.

    Manage My Database

  2. Di bagian New Database, masukkan nama untuk database Anda, misalnya wa, lalu klik Create Database.

    New Database

  3. Kembali ke halaman Manage My Database dan buat pengguna database baru:

    • Masukkan nama pengguna dan kata sandi di bagian Add New User.
    • Klik Create User.

    Create User

  4. Hubungkan pengguna ke database:

    • Di bagian Add User to Database, pilih database dan pengguna yang baru Anda buat.
    • Klik Add.

    Add User to Database

  5. Pada halaman Manage User Privileges, pilih ALL PRIVILEGES untuk memberikan akses penuh.

    • Klik Make Changes.

    Manage User Privileges

Langkah 3: Unduh File MPWA

  1. Unduh versi terbaru MPWA melalui tautan berikut:
    Unduh Versi Terbaru

  2. Buka File Manager di CPanel dan navigasikan ke folder domain yang telah Anda buat.

    File Manager

  3. Unggah file ZIP yang telah diunduh ke folder ini dengan mengklik Upload, lalu ekstrak file menggunakan opsi Extract.

    Extract

Langkah 4: Mulai Instalasi

  1. Kunjungi URL situs web Anda. Halaman installer akan terbuka secara otomatis.

    Installation

  2. Pada halaman installer, Anda akan melihat konfigurasi yang diperlukan, termasuk versi PHP, versi MySQL, dan fungsi yang dibutuhkan.

    • Jika semua pemeriksaan ditandai dengan tanda hijau, klik Next untuk melanjutkan.
    • Jika ada fungsi yang dibutuhkan dinonaktifkan, hubungi penyedia hosting Anda untuk mengaktifkannya.

Langkah 5: Konfigurasi Database

  1. Masukkan kredensial database yang telah Anda buat sebelumnya, termasuk:
    • Host Database (Database Host)
    • Nama Pengguna Database (Database Username)
    • Kata Sandi Database (Database Password)
    • Nama Database (Database Name)

Klik Next untuk melanjutkan.

Configure the Database

Langkah 6: Atur Detail Admin

  1. Pada halaman berikutnya, masukkan detail berikut untuk pengguna admin:

    • Nama Pengguna Admin (Admin Username)
    • Kata Sandi Admin (Admin Password)
    • Alamat Email (Email Address)

    Set Admin Details

  2. Setelah menyelesaikan formulir, klik Submit. Ini akan menyelesaikan instalasi dan mengarahkan Anda ke dasbor admin MPWA.

    dashboard

Langkah 7: Konfigurasi Jenis Server

  1. Di panel admin MPWA, buka Admin > Server Settings.

  2. Pilih Server Type yang sesuai:

    • Localhost: Untuk penggunaan pribadi di komputer Anda sendiri.
    • Hosting: Untuk lingkungan hosting bersama.
    • Other: Untuk VPS, VDS, atau server khusus.

    Catatan:
    Jika Anda memilih Other, skrip akan menggunakan protokol ws atau wss. Opsi ini tidak tersedia pada hosting bersama karena memerlukan akses ke port tertentu. Untuk hosting bersama, selalu pilih Hosting.

  3. Masukkan nomor Port (contoh: 3100, 3121, atau angka 4 digit lainnya kecuali 8080 atau 3306).

    port

  4. Untuk pengguna Nginx: Jika hosting bersama Anda menggunakan Nginx, gunakan https daripada http karena Nginx secara otomatis mengarahkan permintaan dari http ke https.

Langkah 8: Verifikasi Pengaturan .env

  1. Buka File Manager di CPanel.
  2. Temukan file .env di direktori root proyek Anda.
  3. Verifikasi dan perbarui pengaturan seperti berikut:

Untuk Hosting Bersama:

APP_URL=https://yoursite.com
WA_URL_SERVER=https://yoursite.com
PORT_NODE=3100
TYPE_SERVER=hosting

Untuk VPS, VDS, atau Server Khusus:

APP_URL=https://yoursite.com
WA_URL_SERVER=https://yoursite.com:3100
PORT_NODE=3100
TYPE_SERVER=other

Penting:
Jika Anda menggunakan https untuk aplikasi Node.js Anda, pastikan sertifikat SSL telah diinstal. Untuk hosting bersama atau server dengan Nginx, Anda tidak memerlukan file SSL terpisah untuk Node.js. Untuk pengguna Apache, lihat panduan berikut untuk pengaturan SSL pada Node.js:
[Panduan SSL untuk Node.js](?doc=Node.js SSL Guide)

Langkah 9: Siapkan Node.js

  1. Di CPanel, buka Setup Node.js App.

    Set Up Node.js

  2. Klik CREATE APPLICATION dan isi detail berikut:

    • Versi Node.js: Pilih 20.17.0 atau versi yang lebih tinggi dari 18.
    • Mode Aplikasi (Application mode): Atur ke Production.
    • Root Aplikasi (Application root): Masukkan path ke direktori proyek Anda, misalnya /home/username/mpwa.my.id.
    • URL Aplikasi (Application URL): Pilih nama domain Anda.
    • File Startup Aplikasi (Application startup file): Masukkan server.js.

Klik CREATE di bagian atas untuk menyelesaikan pengaturan aplikasi.

CREATE APPLICATION

  1. Setelah membuat aplikasi, klik START APP untuk memulai aplikasi Node.js.

    START APP

Langkah 10: Selesaikan Instalasi

Selamat! MPWA telah berhasil diinstal. Sekarang Anda dapat login ke panel admin dan melanjutkan untuk:

  1. Menambahkan nomor telepon Anda.

  2. Membuat kode QR untuk menghubungkan akun WhatsApp Anda.

    Add your phone number

    QR code

Pemecahan Masalah

Jika Anda mengalami masalah selama proses instalasi:

  • Pastikan semua fungsi PHP yang diperlukan dan Node.js telah dikonfigurasi dengan benar.
  • Verifikasi bahwa lingkungan hosting Anda mendukung konfigurasi yang diperlukan.
  • Anda dapat mengunjungi halaman Pemecahan Masalah untuk menemukan solusi.
  • Hubungi penyedia hosting Anda jika diperlukan untuk bantuan dalam perizinan atau konfigurasi.

Semuanya sudah siap! Nikmati menggunakan MPWA untuk mengelola komunikasi WhatsApp Anda dengan efisien.

Cara Menggunakan →