Daftar & Login

Untuk mulai menggunakan WADUH, Anda perlu membuat akun terlebih dahulu.

1. Buka halaman Daftar dan isi nama, email, serta password (minimal 8 karakter). Nomor WhatsApp bersifat opsional.
2. Setelah mendaftar, akun otomatis mendapat Plan Free yang langsung aktif.
3. Login menggunakan email dan password yang sudah didaftarkan.
4. Setelah login, Anda akan diarahkan ke Dashboard.
5. Update profil (nama & nomor WA) kapan saja dari menu Pengaturan → Profil.

Menghubungkan Sesi WhatsApp

Sesi WhatsApp adalah koneksi antara server dan nomor WhatsApp Anda. Satu sesi = satu nomor.

1. Buka menu Sesi WhatsApp di sidebar dashboard.
2. Klik Tambah Sesi dan beri nama identifikasi (misal: main atau cs-team).
3. Klik tombol QR Code pada sesi yang baru dibuat.
4. Buka WhatsApp di HP → menu Perangkat Tertaut → Tautkan Perangkat.
5. Scan QR code yang muncul. Status sesi akan berubah menjadi CONNECTED.

Alternatif: Tautkan dengan Kode (tanpa scan QR)

1. Pada sesi yang menunggu QR, klik Tautkan dengan kode (atau Tidak bisa scan? Tautkan dengan kode di bawah QR).
2. Masukkan nomor WhatsApp yang akan ditautkan (format 628xxx atau 08xxx), klik Minta Kode.
3. Di HP: WhatsApp → Perangkat tertaut → Tautkan perangkat → Tautkan dengan nomor telepon saja, lalu masukkan kode 8 karakter yang tampil.
4. Cocok bila HP dan layar yang sama (tidak bisa memindai QR). Kode baru bisa diminta setiap 60 detik.

Mengirim Pesan

Buka menu Kirim Pesan. Pilih sesi WhatsApp aktif, lalu pilih tipe pesan:

Pilih Tujuan Pesan

• Manual — ketik nomor langsung (format: 628xxx tanpa +)
• Phonebook — pilih dari daftar kontak yang tersimpan
• Grup Kontak — kirim ke semua kontak dalam grup tertentu
• Grup WA — kirim ke grup WhatsApp (khusus tipe Teks)

Pratinjau Link (Thumbnail Website)

• Pesan berisi URL (https://… atau www.…) otomatis dikirim dengan judul, deskripsi, dan thumbnail situsnya — seperti saat link ditempel manual di WhatsApp.
• Aktif di tab Teks dan Broadcast, di Blast Aman, pesan terjadwal, serta undangan Event & RSVP. Matikan lewat checkbox Tampilkan pratinjau link.
• Hanya URL pertama di pesan yang dipratinjau. Data diambil dari meta Open Graph situs (og:title, og:description, og:image).
• Bila situs tidak menyediakan judul atau lambat merespons (±10 detik), pesan tetap terkirim sebagai teks biasa.

Phonebook

Simpan dan kelola kontak WhatsApp Anda agar mudah dipilih saat mengirim pesan.

• Kontak — tambah, edit, atau hapus kontak individual (nama + nomor).
• Grup Kontak — buat grup (misal: “Pelanggan VIP”) dan tambahkan kontak ke dalamnya.
• Grup WhatsApp — sinkronkan daftar grup WA dari sesi yang terhubung. Klik Sinkronkan untuk memperbarui.

Pesan Terjadwal

Anda bisa menjadwalkan pengiriman pesan di masa depan, termasuk pesan media (gambar, dokumen, audio, video).

Pesan Teks Terjadwal

1. Di form kirim pesan, centang Jadwalkan Pengiriman.
2. Pilih waktu pengiriman (minimal 1 menit dari sekarang).
3. Klik Jadwalkan. Pesan masuk ke antrian.
4. Pantau status di menu Riwayat Pesan → Pesan Terjadwal.

Pesan Media Terjadwal (Gambar/Dokumen/Audio/Video)

Untuk media terjadwal, file harus tersimpan di cloud agar bisa diakses saat jadwal tiba. Ada dua cara:

Riwayat & Statistik

Buka menu Riwayat Pesan untuk melihat:

• Statistik — total pesan per bulan, breakdown per tipe, dan histori harian.
• Log Pesan — detail setiap pesan yang dikirim: waktu, nomor tujuan, status (terkirim/gagal).
• Pesan Terjadwal — daftar pesan yang menunggu dikirim, dengan opsi batalkan atau hapus.

Langganan

Kelola paket berlangganan Anda dari menu Langganan.

• Upgrade — pilih paket yang lebih tinggi. Paket lama tetap aktif sampai pembayaran baru dikonfirmasi.
• Downgrade — batalkan paket aktif terlebih dahulu, lalu pilih paket yang lebih rendah.
• Pembayaran — untuk paket berbayar via Transfer Manual, upload bukti transfer di menu Pembayaran. Admin akan memverifikasi dan mengaktifkan paket.

Pilihan Durasi & Diskon

Saat berlangganan atau upgrade, Anda bisa memilih durasi 1, 3, 6, atau 12 bulan. Durasi lebih panjang mendapat diskon otomatis yang dikonfigurasi admin.

Webhook

Webhook memungkinkan WADUH mengirimkan notifikasi HTTP POST ke server Anda setiap kali ada pesan masuk atau perubahan status sesi.

Setup via Dashboard

1. Buka menu Webhook di sidebar dashboard.
2. Klik Tambah Webhook.
3. Isi Nama dan URL endpoint server Anda.
4. (Opsional) Isi Secret — jika diisi, setiap request menyertakan header X-WADUH-Signature untuk verifikasi.
5. (Opsional) Pilih Session ID — kosongkan untuk menangkap event dari semua sesi.
6. Pilih events yang ingin diterima, lalu klik Simpan.
7. Klik tombol Test untuk memverifikasi koneksi ke URL Anda.

Verifikasi Signature

<?php
$secret  = 'secret_anda';
$rawBody = file_get_contents('php://input');
$sig     = $_SERVER['HTTP_X_WADUH_SIGNATURE'] ?? '';
$expected = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($expected, $sig)) {
    http_response_code(403);
    exit;
}
$payload = json_decode($rawBody, true);
echo $payload['event'];          // message.incoming
echo $payload['data']['fromNumber'];

Integrasi Spreadsheet

WADUH bisa mencatat setiap pesan masuk dan keluar langsung ke Google Sheets — tanpa API key Google, cukup menggunakan Google Apps Script Web App.

Setup Google Apps Script

1. Buka Google Sheet yang ingin digunakan.
2. Klik Extensions → Apps Script.
3. Hapus kode default, paste kode berikut:

function doPost(e) {
  var ss    = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();

  if (sheet.getLastRow() === 0) {
    sheet.appendRow(['Waktu', 'Arah', 'Sesi', 'Nomor', 'Tipe', 'Pesan']);
    sheet.getRange(1, 1, 1, 6).setFontWeight('bold');
  }

  var data  = JSON.parse(e.postData.contents);
  var waktu = new Date(data.timestamp);

  sheet.appendRow([
    Utilities.formatDate(waktu, 'Asia/Jakarta', 'dd/MM/yyyy HH:mm:ss'),
    data.direction, data.session, data.phone, data.type, data.content
  ]);

  return ContentService.createTextOutput('OK');
}

4. Klik Deploy → New Deployment → Web App.
5. Set Who has access ke Anyone.
6. Copy URL deployment (format: https://script.google.com/macros/s/XXXX/exec).
7. Buka menu Spreadsheet di dashboard WADUH dan paste URL tersebut.

Autentikasi

Semua endpoint API (kecuali /auth/login dan /auth/register) membutuhkan autentikasi via API Key atau Bearer Token JWT.

Parameter — Register

Parameter — Login

Contoh: Login

curl -X POST https://api.waduh.fun/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "password123"
  }'

Cara Autentikasi Request

# Metode 1 — API Key (header x-api-key)
curl https://api.waduh.fun/api/session/list \
  -H "x-api-key: YOUR_API_KEY"

# Metode 2 — Bearer Token (JWT)
curl https://api.waduh.fun/api/session/list \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Session API

Parameter — Buat Sesi

Contoh: Buat Sesi & Ambil QR

# 1. Buat sesi
curl -X POST https://api.waduh.fun/api/session/create \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sessionId": "main"}'

# 2. Ambil QR (setelah sesi dibuat)
curl https://api.waduh.fun/api/session/main/qr \
  -H "x-api-key: YOUR_API_KEY"
# Response: { "data": { "qr": "data:image/png;base64,..." } }

Kirim Pesan

Parameter — Kirim Teks

Contoh: Kirim Teks

curl -X POST https://api.waduh.fun/api/send/text \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "main",
    "phone": "6281234567890",
    "message": "Halo! Ini pesan dari WADUH.",
    "delayMin": 0,
    "delayMax": 0
  }'

Parameter — Kirim Gambar

Contoh: Kirim Gambar via URL

curl -X POST https://api.waduh.fun/api/send/image \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "main",
    "phone": "6281234567890",
    "url": "https://example.com/promo.jpg",
    "caption": "Promo spesial hari ini!"
  }'

Contoh: Kirim Gambar via Upload File

curl -X POST https://api.waduh.fun/api/send/image \
  -H "x-api-key: YOUR_API_KEY" \
  -F "sessionId=main" \
  -F "phone=6281234567890" \
  -F "caption=Promo spesial!" \
  -F "file=@/path/to/image.jpg"

Parameter — Kirim Dokumen

Parameter — Kirim Audio

Parameter — Kirim Lokasi

Parameter — Kirim Kontak (vCard)

Parameter — Kirim ke Grup WhatsApp

Parameter — Broadcast

Contoh: Broadcast ke Banyak Nomor

curl -X POST https://api.waduh.fun/api/send/broadcast \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "main",
    "phones": ["6281234567890", "6289876543210", "628111222333"],
    "message": "Halo! Promo kami berlaku hari ini.",
    "delayMin": 1000,
    "delayMax": 3000
  }'

Pesan Terjadwal

Parameter — Buat Pesan Terjadwal

Struktur payload per msgType

Contoh: Jadwalkan Pesan Teks

curl -X POST https://api.waduh.fun/api/scheduled \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "main",
    "msgType": "text",
    "payload": { "message": "Pengingat meeting jam 9 pagi!" },
    "phones": ["6281234567890"],
    "scheduledAt": "2026-06-01T09:00:00+07:00",
    "delayMin": 0,
    "delayMax": 0
  }'

Contoh: Jadwalkan Pesan Gambar via URL

curl -X POST https://api.waduh.fun/api/scheduled \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "main",
    "msgType": "image",
    "payload": {
      "url": "https://cdn-anda.com/promo-juni.jpg",
      "caption": "Promo spesial bulan Juni!"
    },
    "phones": ["6281234567890", "6289876543210"],
    "scheduledAt": "2026-06-01T08:00:00+07:00"
  }'

Phonebook API

Parameter — Tambah Kontak

Parameter — Buat Grup Kontak

Contoh: Tambah Kontak

curl -X POST https://api.waduh.fun/api/phonebook/contacts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Budi Santoso",
    "phone": "6281234567890",
    "groupId": 1,
    "notes": "Pelanggan setia"
  }'

Webhook API

Parameter — Buat / Update Webhook

Contoh: Buat Webhook

curl -X POST https://api.waduh.fun/api/webhook \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Notif Pesan Masuk",
    "url": "https://yourapp.com/wa-hook",
    "sessionId": null,
    "secret": "rahasia123",
    "events": ["message.incoming", "session.connected"]
  }'

Format Payload Masuk ke Server Anda

{
  "event": "message.incoming",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "data": {
    "sessionId": "main",
    "fromNumber": "6281234567890",
    "fromName": "Budi Santoso",
    "isGroup": false,
    "groupJid": null,
    "messageId": "XXXXXXXXXXXXXXXX",
    "type": "text",
    "content": "Halo, saya butuh informasi produk.",
    "timestamp": "2026-01-15T10:30:00.000Z"
  }
}

Spreadsheet API

Parameter — Tambah Spreadsheet

Contoh: Tambah Spreadsheet

curl -X POST https://api.waduh.fun/api/spreadsheet \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Log WA Sales",
    "appsScriptUrl": "https://script.google.com/macros/s/XXXX/exec",
    "sessionId": null,
    "logIncoming": true,
    "logOutgoing": true
  }'

Format Respons

Semua endpoint mengembalikan format JSON yang konsisten:

// Sukses
{
  "code": 200,
  "status": "success",
  "message": "Data berhasil diambil.",
  "data": { ... }
}

// Error
{
  "code": 400,
  "status": "error",
  "message": "sessionId wajib diisi.",
  "data": null
}

HTTP Status Code

Umum

Teknis

Billing & Quota