Dokumentasi API

Sambungkan WhatsApp ke Sistem Anda Sendiri

Kirim pesan WhatsApp otomatis langsung dari website, aplikasi, atau sistem internal Anda — tanpa perlu buka dashboard ini sama sekali. Cukup 1 API Key & 1 request HTTP.

Daftar gratis lalu generate API Key di halaman Profil untuk mulai integrasi.

1

Hubungkan Nomor WA

Scan QR di menu "Scan WA" seperti biasa — perangkat inilah yang nanti mengirim pesan lewat API.

2

Generate API Key

Buka halaman Profil, klik "Generate API Key". Simpan baik-baik — ini kunci rahasia akun Anda.

3

Panggil Endpoint-nya

Dari sistem/aplikasi Anda, kirim 1 request HTTP ke endpoint kami — pesan langsung terkirim ke WhatsApp tujuan.

Autentikasi

Setiap request wajib menyertakan API Key pribadi Anda lewat header Authorization, format Bearer:

Authorization: Bearer API_KEY_ANDA

Dapatkan/generate API Key di halaman Profil setelah login. API Key bersifat rahasia — jangan taruh di kode frontend/JS yang bisa dilihat publik, taruh di server Anda saja.

Kirim Pesan WhatsApp

POST https://ruangnotif.web.id/api/v1/kirim-pesan

Mengirim satu pesan teks WhatsApp lewat perangkat Anda yang sedang Terhubung. Tiap pesan memotong 1 Kredit Blast dari akun Anda (sama seperti fitur Blast di dashboard).

Parameter (JSON body)

Nama	Tipe	Wajib	Keterangan
`to`	string	✅ Ya	Nomor tujuan, format `62xxxxxxxxxx` (boleh pakai spasi/strip, otomatis dibersihkan)
`message`	string	✅ Ya	Isi pesan yang mau dikirim
`device_id`	number	Opsional	ID perangkat spesifik (lihat di Scan WA). Kalau kosong, otomatis pakai perangkat pertama yang Terhubung

Contoh Kode

curl -X POST https://ruangnotif.web.id/api/v1/kirim-pesan \
  -H "Authorization: Bearer API_KEY_ANDA" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "message": "Halo, ini pesan dari sistem kami!"
  }'

<?php
$ch = curl_init('https://ruangnotif.web.id/api/v1/kirim-pesan');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer API_KEY_ANDA',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'to'      => '6281234567890',
        'message' => 'Halo, ini pesan dari sistem kami!',
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

const response = await fetch('https://ruangnotif.web.id/api/v1/kirim-pesan', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer API_KEY_ANDA',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '6281234567890',
    message: 'Halo, ini pesan dari sistem kami!'
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://ruangnotif.web.id/api/v1/kirim-pesan',
    headers={'Authorization': 'Bearer API_KEY_ANDA'},
    json={
        'to': '6281234567890',
        'message': 'Halo, ini pesan dari sistem kami!'
    }
)

print(response.json())

Contoh Respons

200 OK Berhasil

{
  "ok": true,
  "message": "Pesan berhasil dikirim.",
  "sisa_kredit_blast": 49
}

4xx / 5xx Gagal

{
  "ok": false,
  "error": "Kredit Blast tidak cukup..."
}

Kode	Arti
`200`	Pesan berhasil dikirim
`401`	API Key tidak valid / tidak disertakan
`400`	Parameter `to`/`message` kosong, atau `device_id` tidak valid
`402`	Kredit Blast habis — perlu upgrade paket
`502`	Gagal kirim lewat WhatsApp (device terputus, dll)

Yang Sering Ditanyakan

Berapa biaya per panggilan API?

Setiap pesan yang berhasil terkirim memotong 1 Kredit Blast dari akun Anda — sama persis dengan biaya fitur Blast manual di dashboard. Tidak ada biaya tambahan khusus API.

Apakah bisa kirim gambar/dokumen lewat API ini?

Endpoint publik ini saat ini khusus pesan teks. Untuk lampiran file, gunakan fitur Schedule di dashboard.

Apakah API Key bisa diganti kalau bocor?

Bisa — buka halaman Profil, klik "Generate Ulang API Key". API Key lama otomatis tidak berlaku lagi begitu Anda generate yang baru.

Siap sambungkan WhatsApp ke sistem Anda?

Daftar gratis, generate API Key, langsung integrasi hari ini juga.

Daftar Gratis Sekarang