WAMu API Reference

Selamat datang di dokumentasi API WAMu. API ini memungkinkan Anda untuk mengintegrasikan pengiriman pesan WhatsApp (seperti OTP, notifikasi tagihan, dll), mengelola Auto-Reply, dan mengatur integrasi Llama AI ke dalam aplikasi eksternal atau sistem backend Anda sendiri.

Base URL: https://wa-api-dev.matadigital.workers.dev
*Jika Anda menggunakan server VPS mandiri (Private Server), ganti URL di atas dengan domain Worker Anda.

Otentikasi

Semua request API yang bersifat private membutuhkan Bearer Token. Token ini sama dengan sesi wamu_session yang bisa Anda ambil setelah melakukan login atau dengan menanyakan super-admin Anda.

Kirimkan token pada Header Request:

Authorization: Bearer <YOUR_API_TOKEN>

Kirim Pesan (OTP / Notifikasi)

Gunakan endpoint ini untuk mengirim pesan teks, OTP, atau notifikasi ke nomor pengguna secara realtime.

POST /send-message

Payload (JSON)

Parameter	Tipe	Wajib	Deskripsi
`bot_number`	string	Ya	ID bot pengirim (contoh: `Bot-1`). Jika ingin dikirim oleh acak, bisa gunakan `ALL`.
`target`	string	Ya	Nomor tujuan (Gunakan format `628xxx` tanpa tanda +). Bisa juga menggunakan `628xxx@s.whatsapp.net`.
`text`	string	Ya	Isi pesan teks. Anda bisa menggunakan markdown WhatsApp seperti tebal atau _miring_.
`agent_name`	string	Tidak	Label pengirim di dashboard (Default: `Sistem`).
`media_url`	string	Tidak	URL media yang valid jika ingin mengirim gambar/dokumen.
`media_type`	string	Tidak	Tipe media (`image`, `document`, `video`). Wajib jika `media_url` diisi.

Contoh Request Node.js

fetch('https://wa-api-dev.matadigital.workers.dev/send-message', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer 8f72a...' // Token Anda
  },
  body: JSON.stringify({
    bot_number: 'Bot-1',
    target: '6281234567890',
    text: '*KODE OTP ANDA: 9942* \n\nMohon jangan berikan kode ini ke siapapun.'
  })
})
.then(res => res.json())
.then(data => console.log(data));

Contoh Response

{
  "success": true
}

Manajemen Auto-Reply

Menambahkan aturan balas otomatis ke database melalui API.

POST /add-autoreply

Payload (JSON)

Parameter	Tipe	Wajib	Deskripsi
`bot_number`	string	Ya	ID bot pengirim atau `ALL`.
`keyword`	string	Ya	Kata kunci pemicu (pisahkan dengan koma jika lebih dari satu).
`is_exact_match`	boolean	Ya	`true` jika pesan pengguna harus sama persis dengan keyword, `false` jika keyword hanya perlu mengandung kata tersebut.
`response`	string	Ya	Teks balasan otomatis.

Konfigurasi Chat AI

Mengatur instruksi kepintaran buatan (Llama AI) pada *device* secara terprogram.

POST /update-device-ai

Payload (JSON)

Parameter	Tipe	Wajib	Deskripsi
`bot_id`	string	Ya	ID bot yang ingin dikonfigurasi (contoh: `Bot-1`).
`ai_enabled`	integer	Ya	`1` untuk mengaktifkan AI, `0` untuk menonaktifkan.
`ai_prompt`	string	Ya	Instruksi Prompt sistem. Contoh: `Anda adalah CS perusahaan sepatu. Selalu ramah.`

Contoh Request cURL

curl -X POST https://wa-api-dev.matadigital.workers.dev/update-device-ai \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_API_TOKEN>" \
-d '{
  "bot_id": "Bot-1",
  "ai_enabled": 1,
  "ai_prompt": "Kamu adalah asisten pintar bernama WAMu."
}'