API WhatsApp Wangsaf

Kirim pesan WhatsApp (teks, template, gambar, dokumen, lokasi) dan cek status koneksi perangkat dari server Anda sendiri. Setiap panggilan diautentikasi dengan kunci API milik satu perangkat, bukan akun Anda secara umum.

Base URL

Semua endpoint pada dokumentasi ini relatif terhadap:

https://api.wangsaf.com/v1

Autentikasi

Sertakan header Api-Key berisi kunci API perangkat pada setiap request. Kunci ini spesifik per perangkat, ada di halaman Perangkat pada dashboard Anda, dan menentukan perangkat mana yang mengirim pesan, bukan siapa Anda.

Jika kunci API tidak valid, respons tetap berstatus HTTP 200, tapi field status di body bernilai 401. Periksa field status pada body, jangan hanya kode status HTTP-nya. Header yang hilang sama sekali tetap mengembalikan HTTP 401 seperti biasa.

Contoh Cepat

Mengirim pesan teks ke satu nomor:

cURL

curl -X POST https://api.wangsaf.com/v1/chat/send-text \
  -H "Api-Key: <API_KEY_PERANGKAT>" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "628123456789@s.whatsapp.net",
    "message": "Halo dari Wangsaf!"
  }'

Respons 200

{
  "status": 200,
  "message": "Message sent successfully.",
  "data": {
    "type": "Text",
    "action": "text",
    "chat_id": "3EB0C767D097B3B0F1C9",
    "timestamp": 1758012345
  }
}

Detail lengkap tiap jenis pesan ada di Kirim Pesan.

Format Respons

Setiap respons sukses berbentuk sama: { status, message, data }, dengan status berisi kode numerik (biasanya sama dengan kode HTTP-nya) dan data berisi hasil sesuai endpoint yang dipanggil. Kesalahan validasi input punya bentuk berbeda, dijelaskan di Error & Status.

Saldo Token

Setiap pesan yang berhasil terkirim memotong saldo token akun Anda: 1 token untuk pesan teks, template, atau lokasi, 2 token untuk gambar, dan 5 token untuk dokumen. Jika saldo tidak cukup, pengiriman gagal dengan respons yang sama seperti kegagalan pengiriman lainnya, lihat Error & Status. Cek status perangkat tidak memotong saldo.