B BGWA Docs
Mulai

Pengantar

Kenali BGWA: gateway WhatsApp berbasis API untuk mengirim pesan dari website dan aplikasi Anda.

BGWA adalah gateway WhatsApp berbasis API. Hubungkan nomor WhatsApp Anda sebagai device, ambil API key, lalu kirim pesan dari website, aplikasi, atau sistem billing Anda lewat satu request HTTP, tanpa perlu login ke dashboard.

Yang bisa Anda bangun

  • Notifikasi tagihan, jatuh tempo, dan bukti pembayaran otomatis.
  • Kode OTP dan verifikasi login yang dikirim lebih dulu dari antrean biasa.
  • Pengingat jadwal, konfirmasi pesanan, dan status pengiriman.
  • Pemberitahuan gangguan atau info penting ke pelanggan dengan gambar dan keterangan.

Kemampuan utama

API sederhana

REST + JSON dengan autentikasi Bearer. Satu endpoint untuk mengirim, satu untuk mengecek status.

Pengiriman aman

Pesan dikirim bertahap dengan jeda acak dan indikator mengetik, agar nomor Anda terlindungi dari pemblokiran.

Teks dan gambar

Kirim teks, atau gambar JPG/PNG/WebP dengan teks sebagai keterangan dalam satu pesan.

Variasi isi pesan

Spintax {Halo|Hai} dan variabel {nama} supaya setiap pesan tampil berbeda.

Jalur OTP

Pesan type: "otp" didahulukan dan tidak tertahan jam malam.

Webhook bertanda tangan

Hasil akhir dikirim ke server Anda dengan tanda tangan HMAC-SHA256 dan pengulangan otomatis.

Cara kerja

Pesan tidak langsung ditembakkan ke WhatsApp. Alurnya seperti ini:

1. RequestServer Anda memanggil POST /messages.
2. AntreanBGWA memeriksa kuota dan aturan, lalu menjawab queued atau scheduled.
3. PengirimanPesan dikirim satu per satu dengan jeda seperti manusia.
4. HasilStatus sent/failed bisa dicek, atau diterima lewat webhook.

Yang Anda butuhkan

  • Akun BGWA dengan paket aktif (trial atau berbayar) dan saldo dompet yang cukup.
  • Satu nomor WhatsApp yang bisa memindai QR code di ponsel.
  • Server atau aplikasi yang dapat membuat request HTTPS keluar. Tidak perlu library khusus.
  • Untuk webhook: endpoint HTTPS publik di server Anda.

Ringkasan endpoint

Basis URL: https://bgwa.web.id/api/v1

MetodePathFungsi
GET/deviceCek status device
POST/messagesKirim pesan teks atau gambar
GET/messages/{id}Cek status satu pesan
GET/webhookLihat pengaturan webhook dan 10 pengiriman terakhir
PUT/webhookAtur URL webhook
DELETE/webhookHapus webhook
POST/webhook/secretGanti secret penandatangan
POST/webhook/testKirim ping uji ke webhook

Langkah berikutnya