Dokumentasi Fitur & REST API Waply

2. Autentikasi & API Key

Setiap request ke REST API Waply wajib menyertakan API Key pada Header HTTP dengan format standar:

3. WhatsApp Device & Multi-Device Rotasi

Waply menghubungkan nomor WhatsApp bisnis Anda secara langsung menggunakan engine socket berkecepatan tinggi tanpa memerlukan emulator.

4. Warmup Device & Panduan Anti-Ban

Nomor WhatsApp baru atau nomor yang baru saja didaftarkan sangat rentan diblokir oleh algoritma WhatsApp jika langsung mengirim ribuan pesan. Gunakan fitur Device Warmup untuk membangun reputasi nomor secara bertahap:

Endpoint utama untuk mengirim pesan WhatsApp transaksional (OTP, notifikasi pesanan, invoice tagihan) ke nomor pelanggan secara otomatis.

curl -X POST http://localhost:3001/api/v1/messages/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer snd_live_YOUR_API_KEY" \
  -d '{
    "to": "6281234567890",
    "message": "{Halo|Hai|Selamat siang} {{name}}, pesanan Anda {{order_id}} sedang diproses!",
    "deviceId": "auto_rotate",
    "variables": {
      "name": "Budi Santoso",
      "order_id": "INV-2026-9812"
    }
  }'

const res = await axios.post(
  "http://localhost:3001/api/v1/messages/send",
  {
    to: req.body.phone,
    message: "Kode OTP Anda: *{{otp}}*.",
    deviceId: "auto_rotate",
    variables: { otp: "492810" }
  },
  { 
    headers: { 
      Authorization: "Bearer " + API_KEY 
    } 
  }
);

$res = Http::withToken($apiKey)->post(
  "http://localhost:3001/api/v1/messages/send",
  [
    "to" => $order->customer_phone,
    "message" => "Halo {{name}}, tagihan Rp {{total}} terbit.",
    "deviceId" => "auto_rotate",
    "variables" => [
      "name" => $order->customer_name,
      "total" => "150.000",
      "inv" => (string)$order->id
    ]
  ]
);

6. Spintax Engine & Variabel Dinamis

Spintax adalah teknik variasi kata acak untuk mencegah sistem spam WhatsApp mendeteksi kesamaan teks:

Kirim pesan massal ke ribuan penerima dengan aman menggunakan sistem Safety Throttling dan Batch Cooldown bawaan Waply:

curl -X POST http://localhost:3001/api/broadcast \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer snd_live_YOUR_API_KEY" \
  -d '{
    "name": "Promo Weekend Spesial 30%",
    "messageTemplate": "{Halo|Hai|Selamat siang} {{name}}, dapatkan diskon 30% hari ini dengan kode {{kode}}!",
    "batchSize": 10,
    "batchDelaySec": 60,
    "minDelaySec": 4,
    "maxDelaySec": 8,
    "recipients": [
      { "phoneNumber": "6281234567890", "name": "Budi Santoso", "variables": { "kode": "WAPLY30" } },
      { "phoneNumber": "6285712345678", "name": "Siti Rahma", "variables": { "kode": "WAPLY30" } }
    ]
  }'

8. Buku Kontak & Segmentasi Grup

Kelola database pelanggan Anda di menu Buku Kontak:

• Import Bulk (CSV/Excel): Masukkan ratusan nomor sekaligus via endpoint /api/contacts/import.
• Grup Kontak: Segmentasikan pelanggan menjadi grup seperti Pelanggan VIP, Leads Baru, Reseller.
• Custom Variables: Tambahkan variabel dinamis per kontak (kota, saldo, invoice, resi).

Simpan format pesan siap pakai di menu Templates. Client dapat langsung memanggil template di aplikasi backend mereka menggunakan Shortcode tanpa perlu menulis ulang seluruh isi pesan di kode program.

Contoh Pengaturan Shortcode & Variabel di Menu Templates:Dashboard > Templates

Kotak merah pada gambar di atas menunjukkan Shortcode (tpl_order_notif) yang digunakan sebagai nilai parameter "template" pada payload JSON API di bawah ini.

curl -X POST http://localhost:3001/api/v1/messages/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer snd_live_YOUR_API_KEY" \
  -d '{
    "to": "6281234567890",
    "template": "tpl_order_notif",
    "deviceId": "auto_rotate",
    "variables": {
      "name": "Budi Santoso",
      "order_id": "INV-2026-9812",
      "eta": "Besok Siang"
    }
  }'

11. Blacklist & Auto Opt-Out DND

Patuhi privasi pelanggan dan hindari blokir nomor dengan manajemen Blacklist:

13. Billing, Paket Langganan & Voucher

Kelola status paket langganan dan upgrade kuota di menu Billing & Paket:

14. Pusat Bantuan (Support Tickets)

Jika mengalami kendala teknis atau pertanyaan seputar gateway, buat tiket bantuan di menu Bantuan & Support. Tim teknis Waply akan membalas langsung di room chat tiket Anda.