← Blog • 12 Jun 2026 • Tim LoginWA

API WhatsApp Gratis untuk Developer, Mulai 5 Menit

Kalau kamu lagi cari API WhatsApp gratis untuk proyek pribadi, skripsi, MVP startup, atau sekadar eksperimen, kabar baiknya: kamu nggak perlu daftar WhatsApp Business API resmi yang prosesnya panjang dan butuh verifikasi bisnis. Ada jalur yang jauh lebih cepat.

Di artikel ini kita akan praktik langsung: dari nol sampai berhasil kirim pesan WhatsApp lewat API dalam waktu sekitar 5 menit, pakai paket Free dari LoginWA. Gratis 500 pesan per bulan, tanpa kartu kredit, dan boleh kirim media. Setelah itu kita lanjut ke contoh integrasi Node.js yang siap kamu tempel ke aplikasi.

Kenapa Butuh API WhatsApp?

WhatsApp adalah aplikasi chat nomor satu di Indonesia. Hampir semua orang membukanya setiap hari, beda jauh dengan email yang sering dicuekin atau SMS yang sudah jarang dibaca. Karena itu banyak developer ingin pakai WhatsApp untuk:

Notifikasi otomatis, order masuk, pembayaran berhasil, pengingat jadwal.
OTP / verifikasi login, lebih murah daripada SMS, dan delivery rate-nya tinggi.
Chatbot dan auto-reply, balas pertanyaan pelanggan 24 jam.
Broadcast, info promo atau pengumuman ke banyak kontak sekaligus.

Masalahnya, WhatsApp tidak menyediakan API "colok langsung" untuk akun biasa. Pilihannya dua: WhatsApp Business API resmi (via BSP, bayar per pesan, butuh verifikasi bisnis Meta) atau API gateway unofficial yang menghubungkan nomor WA kamu sendiri lewat protokol web. Untuk eksperimen dan skala kecil-menengah, jalur kedua jauh lebih praktis, dan ada yang gratis.

Opsi API WhatsApp Gratis: Perbandingan Singkat

Sebelum praktik, ini perbandingan jujur opsi gratis yang populer di Indonesia:

Aspek	LoginWA Free	Fonnte Free
Kuota gratis	500 pesan/bulan	1.000 pesan/bulan
Kirim media (gambar/dokumen)	Boleh	Tidak (tanpa attachment)
Watermark	Ada, teks kecil "Dikirim via loginwa.com"	Ada
Kartu kredit	Tidak perlu	Tidak perlu
Upgrade termurah	Lite Rp25.000/bln (3.000 pesan, tanpa watermark)	Lite Rp25.000/bln (1.000 pesan)

Fonnte adalah pemain terbesar dengan fitur sangat lengkap dan dokumentasi bagus, kuota gratisnya juga lebih banyak. Tapi kalau use case kamu butuh kirim gambar, dokumen, atau media lain di tier gratis, LoginWA Free mengizinkannya (dengan watermark kecil). Dua-duanya layak dicoba; di tutorial ini kita pakai LoginWA karena alur onboarding-nya yang akan kita praktikkan.

Ada juga Wablas (mulai Rp22.000/bln dengan trial 15 hari, tanpa tier gratis permanen) dan Watzap.id (Rp449.000–649.000/tahun, unlimited), bagus untuk skala besar, tapi bukan opsi gratis.

Tutorial: Kirim Pesan WhatsApp via API dalam 5 Menit

Yang kamu butuhkan: nomor WhatsApp aktif (untuk daftar) dan satu nomor WA lagi yang akan dijadikan "device" pengirim. Bisa juga pakai nomor yang sama untuk keduanya.

Menit 1: Daftar pakai nomor WhatsApp

Buka loginwa.com/auth/otp, masukkan nomor WhatsApp kamu, lalu masukkan kode OTP yang dikirim ke WA. Tidak ada form panjang, tidak ada kartu kredit. Selesai daftar, kamu langsung masuk dashboard dengan paket Free aktif: 500 pesan per bulan.

Catatan: di LoginWA, 1 pesan API = 1 OTP = 1 blast = 1 kuota. Jadi 500 kuota gratis itu fleksibel mau dipakai untuk apa saja.

Menit 2: Buat app dan ambil API key

Di dashboard, buat app baru (misalnya "proyek-belajar"). Setiap app punya API key sendiri, ini yang akan kamu pakai di header Authorization. Salin dan simpan baik-baik; jangan pernah commit API key ke repository publik.

Kalau nanti sudah serius, kamu bisa aktifkan IP whitelist supaya API key hanya bisa dipakai dari server kamu (fitur ini ada di paket Business).

Menit 3: Scan QR untuk hubungkan device

Masih di dashboard, tambahkan device lalu scan QR code yang muncul, persis seperti login WhatsApp Web:

Buka WhatsApp di HP → menu titik tiga → Perangkat Tertaut → Tautkan Perangkat.
Arahkan kamera ke QR di dashboard LoginWA.
Tunggu status device berubah jadi connected.

Nomor WA yang kamu scan inilah yang akan jadi pengirim pesan. Saran: untuk produksi, pakai nomor khusus, bukan nomor pribadi.

Menit 4: Kirim pesan pertama dengan curl

Buka terminal, jalankan ini (ganti API_KEY dan nomor tujuan):

curl -X POST https://api.loginwa.com/api/v1/messages/send \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"6281234567890","message":"Halo! Ini pesan pertama dari API."}'

Cek HP kamu, pesan masuk dalam hitungan detik. Selamat, kamu baru saja mengirim pesan WhatsApp lewat API gratis.

Format nomor pakai kode negara tanpa tanda plus: 62812xxxx, bukan 0812xxxx atau +62812xxxx.

Menit 5: Kirim gambar (ini yang gratis di LoginWA)

Mau kirim gambar dengan caption? Tambahkan type dan media_url:

curl -X POST https://api.loginwa.com/api/v1/messages/send \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "6281234567890",
    "type": "image",
    "media_url": "https://example.com/struk-pembayaran.jpg",
    "caption": "Terima kasih! Ini bukti pembayaran kamu."
  }'

Selain gambar, kamu juga bisa kirim video, dokumen, dan audio dengan cara yang sama. Di tier gratis, pesan akan menyertakan watermark teks kecil "Dikirim via loginwa.com", hilang otomatis begitu upgrade ke Lite (Rp25.000/bulan).

Integrasi ke Node.js dengan fetch

Curl bagus buat tes, tapi di aplikasi nyata kamu butuh kode. Karena fetch sudah built-in di Node.js 18+, kamu tidak perlu install library apa pun:

// kirim-wa.js, Node.js 18+
const LOGINWA_API_KEY = process.env.LOGINWA_API_KEY;

async function kirimWA(phone, message) {
  const res = await fetch("https://api.loginwa.com/api/v1/messages/send", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${LOGINWA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ phone, message }),
  });

  if (!res.ok) {
    const err = await res.text();
    throw new Error(`Gagal kirim WA (${res.status}): ${err}`);
  }

  return res.json();
}

// contoh pemakaian
kirimWA("6281234567890", "Order #1234 kamu sudah kami terima. Terima kasih!")
  .then((data) => console.log("Terkirim:", data))
  .catch((err) => console.error(err.message));

Jalankan dengan:

LOGINWA_API_KEY=api_key_kamu node kirim-wa.js

Beberapa praktik baik yang sebaiknya kamu terapkan dari awal:

Simpan API key di environment variable, bukan hardcode di kode.
Cek nomor sebelum kirim, pakai endpoint POST /api/v1/numbers/check untuk memastikan nomor terdaftar di WhatsApp, supaya kuota tidak terbuang ke nomor mati.
Tangani error dengan benar, kuota habis atau device terputus harus terdeteksi, jangan gagal diam-diam.

Bonus: contoh kirim media dari Node.js tinggal menambah field di body:

async function kirimGambar(phone, mediaUrl, caption) {
  const res = await fetch("https://api.loginwa.com/api/v1/messages/send", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${LOGINWA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      phone,
      type: "image",
      media_url: mediaUrl,
      caption,
    }),
  });
  return res.json();
}

Kalau lebih suka pakai SDK, LoginWA menyediakan SDK resmi untuk JavaScript dan PHP, detailnya ada di dokumentasi. Di sana juga ada endpoint lain seperti OTP API (POST /api/v1/auth/start dan POST /api/v1/auth/verify) kalau kamu mau bikin login via WhatsApp, plus webhook dengan signature HMAC-SHA256 untuk menerima event pesan masuk.

Hal yang Perlu Kamu Tahu Soal API Unofficial

Supaya adil dan kamu tidak kaget di kemudian hari:

Ini bukan API resmi Meta. Gateway unofficial bekerja dengan menghubungkan nomor WA kamu via protokol web. Selalu ada risiko nomor kena pembatasan kalau dipakai spam. LoginWA memakai typing indicator, delay acak menyerupai manusia, dan delay antar pesan broadcast yang bisa diatur untuk meminimalkan risiko, tapi tidak ada layanan mana pun yang bisa menjamin 100% aman, dan kamu sebaiknya curiga pada yang berani klaim begitu.
Jangan spam. Kirim hanya ke orang yang memang mengharapkan pesan kamu (opt-in). Ini bukan cuma soal risiko banned, tapi juga etika.
Fitur interaktif resmi seperti button dan list message tidak tersedia di jalur unofficial. Kalau butuh itu, jalurnya WhatsApp Business API resmi.
Untuk volume besar dan use case kritikal (misalnya OTP perbankan), pertimbangkan API resmi. Untuk notifikasi toko online, sistem internal, reminder, dan chatbot UMKM, gateway unofficial sudah lebih dari cukup dan jauh lebih hemat.

Kalau Kuota Gratis Sudah Tidak Cukup

500 pesan per bulan cukup untuk development dan proyek kecil. Begitu mulai serius, upgrade-nya tidak bikin kaget:

Lite Rp25.000/bln, 3.000 pesan, tanpa watermark, 1 device.
Regular Rp65.000/bln, 15.000 pesan, 3 device, blast terjadwal + import CSV.
Business Rp149.000/bln, 60.000 pesan, 10 device, IP whitelist.

Pembayaran bisa pakai QRIS (aktif instan), virtual account, atau PayPal. Detail lengkap ada di halaman pricing.

Penutup

API WhatsApp gratis itu nyata dan bisa kamu pakai hari ini juga, tanpa verifikasi bisnis, tanpa kartu kredit, tanpa menunggu approval. Dalam 5 menit kamu sudah bisa: daftar via OTP, buat app, ambil API key, scan QR, dan kirim pesan pertama lewat curl atau Node.js.

Kalau mau langsung praktik, daftar gratis di loginwa.com/auth/otp, 500 pesan per bulan, boleh kirim media, dan dokumentasi lengkapnya tersedia di /docs. Selamat ngoding, dan kirim pesan pertamamu hari ini.