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.
.env aplikasi masing-masing, dan mengelola nomor WhatsApp langsung di panel lokal /waku/dashboard.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.
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.
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.
.env proyek Anda seperti pada Langkah 2 di bawah.Pasang Package / SDK pada Aplikasi Konsumen
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.
WaIntegration\Laravel\WhatsAppServiceProvider · Facade: WhatsApp--with-views untuk kustomisasi Blade template, atau --force untuk menimpa config lama.WhatsApp, dan Artisan commands terisolasi tanpa tabrakan nama./waku/dashboard dengan Live QR scanner, rotasi anti-spam, dan riwayat pesan instan.Pilihan B: Ekosistem Node.js, TypeScript & React
Universal Waku Dashboardnpm install @platform-core/whatsapp-sdk # atau: pnpm add @platform-core/whatsapp-sdk
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!}
/>
);
}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!,
}));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:
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();
}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.