Docs/Getting Started
KHUSUS INTERNAL DISKOMINFOTIKSAN · NON-KOMERSIAL

Panduan Memulai 5 Menit (Quick Start).

Panduan integrasi resmi untuk sistem informasi di lingkungan Diskominfotiksan Kota Pekanbaru. Ikuti 5 langkah cepat berikut untuk menghubungkan aplikasi Anda ke WhatsApp Gateway secara andal.

INFO
Penting: Konsumen Tidak Memerlukan Akses Login ke Web Portal IniAkses login ke portal konsol web gateway ini khusus untuk Owner / Administrator Diskominfotiksan. Layanan ini saat ini hanya untuk keperluan internal Diskominfotiksan Kota Pekanbaru. Konsumen cukup mengajukan kredensial ke Administrator, memasangnya di file .env aplikasi masing-masing, dan mengelola nomor WhatsApp langsung di panel lokal /waku/dashboard.
1

Pengajuan & Penerbitan Kredensial Resmi oleh Administrator Diskominfotiksan

Tim pengembang aplikasi internal OPD mengajukan permohonan pendaftaran sistem kepada Administrator / Owner Diskominfotiksan. Administrator akan mendaftarkan sistem Anda, mengalokasikan kuota sesi WhatsApp (default 2 nomor), dan menerbitkan sepasang kredensial resmi.

Isolasi Keamanan: 1 Kunci Lisensi Terkunci Eksklusif untuk 1 Aplikasi

Untuk mencegah pencurian atau penyalahgunaan kredensial, sistem gateway menerapkan mekanisme Domain & Host Pinning (Lock-on-First-Use). Kunci API Anda akan terkunci secara permanen pada domain aplikasi pertama yang memanggil gateway. Jika aplikasi lain mencoba menyalin dan menggunakan App Key yang sama, permintaan akan otomatis ditolak dengan pesan HTTP 403 Forbidden.

Masa Berlaku Kunci & Durasi Lisensi Internal

Administrator dapat menetapkan masa berlaku kunci (misal 30 hari, 90 hari, 180 hari, 365 hari, atau permanen). Jika masa aktif kunci hampir berakhir, sistem akan memberi tahu administrator agar lisensi dapat diperpanjang tanpa ada gangguan layanan.

Contoh Kredensial yang Diterima dari Administrator:
WHATSAPP_BASE_URL : http://localhost:3001/api/v1 (Endpoint Gateway Diskominfotiksan)
WHATSAPP_APP_ID : app_kepegawaian_pku
WHATSAPP_API_KEY : wai_live_••••••••••••9999 (Terkunci eksklusif untuk 1 aplikasi)
WHATSAPP_WEBHOOK_SECRET: whsec_kepegawaian_demo_2026
Catatan Konsumen: Anda tidak perlu login ke website ini. Cukup simpan kredensial di atas ke berkas .env proyek Anda seperti pada Langkah 2 di bawah.
2

Pasang Package / SDK pada Aplikasi Konsumen

Official Laravel Package Lifecycle · Composer Standard
xdiego1st/wa-integrationv1.3.0 StablePHP ^8.1 - 8.5Laravel 10 · 11 · 12 · 13

Panduan Siklus Hidup Paket Laravel (Composer)

Panduan teknis lengkap siklus hidup paket: dari instalasi Packagist resmi, konfigurasi instan satu langkah, integrasi Waku Dashboard visual, pembaruan versi tanpa downtime, hingga pencopotan bersih (Zero-Residue) tanpa menyisakan sampah konfigurasi.

Pilih Saluran Distribusi Instalasi:
Gunakan saluran Packagist (Publik Resmi) untuk aplikasi produksi atau Monorepo / Local Path untuk lingkungan pengembangan internal Diskominfotiksan.
1Jalankan Composer Require dari Packagist.org:
bash · host-laravel-app
packagist.org/packages/xdiego1st/wa-integration
# Mengunduh paket resmi & mendaftarkan provider via Laravel Auto-Discovery
$composer require xdiego1st/wa-integration
Terdaftar Resmi di Packagist.orgNamespace: WaIntegration\Laravel\WhatsAppServiceProvider · Facade: WhatsApp
Buka di Packagist
2Jalankan Installer Otomatis Satu Langkah (Artisan CLI):
artisan · automated installer
Zero-Configuration
# Otomatis: publish config/waku.php, inject .env template, publish dashboard view & clear cache
$php artisan waku:install
# Flag opsional: --with-views untuk kustomisasi Blade template, atau --force untuk menimpa config lama.
Nol Ketergantungan NPM
Murni PHP & Tailwind CDN mandiri. Aplikasi host Anda tidak memerlukan build step Vite atau Node.js tambahan.
Standar Arsitektur Spatie
Auto-discovery Service Provider, Facade resmi WhatsApp, dan Artisan commands terisolasi tanpa tabrakan nama.
Waku Dashboard Siap Pakai
Langsung aktif di /waku/dashboard dengan Live QR scanner, rotasi anti-spam, dan riwayat pesan instan.

Pilihan B: Ekosistem Node.js, TypeScript & React

Universal Waku Dashboard
1. Pasang Package SDK Resmi:
npm install @platform-core/whatsapp-sdk
# atau: pnpm add @platform-core/whatsapp-sdk
Next.js 14 / Vite (React Component)

Drop-in komponen visual di rute /waku/dashboard:

"use client";
import { WakuDashboard } from "@platform-core/whatsapp-sdk/react";

export default function WhatsAppPage() {
  return (
    <WakuDashboard
      appId={process.env.NEXT_PUBLIC_WAKU_APP_ID!}
      apiKey={process.env.NEXT_PUBLIC_WAKU_API_KEY!}
    />
  );
}
Express.js (Node Backend Middleware)

Sajikan dashboard langsung di server tanpa framework frontend:

import express from "express";
import { wakuDashboardExpress } from "@platform-core/whatsapp-sdk/server";

const app = express();
app.use("/waku/dashboard", wakuDashboardExpress({
  appId: process.env.WAKU_APP_ID!,
  apiKey: process.env.WAKU_API_KEY!,
}));
3

Hubungkan Nomor WhatsApp (Scan QR) di Dashboard Lokal Aplikasi Anda

Anda tidak perlu login ke website ini untuk menghubungkan nomor WhatsApp. Buka browser dan kunjungi panel lokal aplikasi host Anda di http://aplikasi-anda.test/waku/dashboard. Anda dapat membuat sesi baru dan memindai QR code secara visual:

# Atau gunakan perintah CLI Laravel dari terminal host Anda:
php artisan wa:status
Auto-Reconnect 24/7 & Load Balancing Anti-Spam
Koneksi yang telah terhubung akan dijaga aktif 24 jam nonstop oleh sistem auto-reconnect cerdas. Jika Anda mendaftarkan lebih dari 1 nomor WhatsApp, gateway otomatis mendistribusikan pengiriman pesan secara bergantian (round-robin) untuk mencegah spam dan nomor terblokir.
4

Kirim Pesan Pertama Anda!

Jalankan kode berikut dari controller atau service class aplikasi Laravel Anda:

use PlatformCore\WhatsApp\Facades\WhatsApp;

$response = WhatsApp::send([
    'to'      => '081200001234',
    'content' => 'Halo dari aplikasi klien! Pesan WhatsApp gateway berhasil terhubung.',
]);

if ($response->isSuccessful()) {
    echo "Pesan berhasil dikirim! ID: " . $response->messageId();
}
5

Konfigurasi Webhook Masuk (Opsional)

Daftarkan URL webhook Anda (misal: https://api.aplikasi-anda.id/whatsapp/webhook) di Multi-Application Hub agar aplikasi menerima event pesan masuk dan status tanda centang secara otomatis.