WatZap SDK (JavaScript)

Library resmi untuk menghubungkan aplikasi Node.js Kamu dengan WhatsApp lewat WatZap, cukup dengan beberapa baris kode.

WatZap SDK (@watzapid/sdk) adalah library resmi dari WatZap untuk aplikasi berbasis JavaScript/TypeScript (Node.js). Dengan SDK ini, aplikasi Kamu bisa mengirim pesan WhatsApp, menerima pesan masuk, dan mengelola kontak di WatZap tanpa perlu merakit request API satu per satu.

Contohnya, mengirim pesan WhatsApp cukup dengan satu baris ini:

await wz.whatsapp.messages.sendText({ to: '081234567890', text: 'Pesanan Kamu sudah dikirim 📦' })

SDK tersedia gratis di npm: @watzapid/sdk. Panduan ini berlaku untuk SDK versi 0.2.0.

Kenapa Disarankan Pakai SDK?

Kamu tetap bisa memanggil REST API WatZap secara langsung. Tapi kalau aplikasi Kamu memakai Node.js, SDK membuat integrasi lebih cepat dan lebih aman:

Tanpa SDK (panggil API langsung)	Dengan WatZap SDK
Harus hafal nama endpoint dan parameternya	Nama fungsi jelas dan muncul otomatis di editor (autocomplete)
Format nomor HP harus dirapikan sendiri	08…, 62…, dan +62… otomatis dirapikan
Sebagian error dikirim dengan status HTTP 200, jadi mudah terlewat	Setiap error dilempar sebagai error yang jelas jenisnya
Saat koneksi putus, retry buatan sendiri bisa membuat pelanggan menerima pesan dobel	Retry otomatis yang aman: pesan yang mungkin sudah terkirim tidak akan dikirim ulang
Input yang salah baru ketahuan setelah ditolak server atau Meta	Kesalahan umum sudah dicek sebelum dikirim, misalnya judul tombol yang terlalu panjang
Harus menulis sendiri kode untuk mengambil data per halaman	Cukup for await untuk mengambil semua data

Selain itu, SDK ini:

• Resmi dan gratis, dirawat langsung oleh tim WatZap (lisensi MIT).

• Ringan, tanpa dependensi tambahan. Mendukung import (ESM), require (CommonJS), dan TypeScript.

• Aman secara bawaan: SDK menolak berjalan di browser, supaya API Key tidak bocor ke pengunjung website.

Apa Saja yang Bisa Dilakukan?

Fitur	Yang bisa dilakukan
WhatsApp Official (WABA)	Kirim teks, template (termasuk OTP), gambar, dokumen, video, audio, tombol, daftar pilihan, dan lokasi. Cek status terkirim dan dibaca. Kelola template.
WhatsApp Unofficial	Kirim teks, gambar, dan file ke nomor pribadi maupun grup. Cek apakah nomor terdaftar di WhatsApp. Baca inbox.
Pesan masuk (webhook)	Teruskan setiap pesan yang masuk ke aplikasi Kamu.
Kontak & List	Tambah dan perbarui kontak, sinkronkan data pelanggan dari database Kamu ke List WatZap.
Lainnya	Lihat daftar nomor pengirim, simpan URL media, baca data bot dan n8n.

Contoh Pemakaian

• Toko online: kirim notifikasi pesanan dan nomor resi secara otomatis.

• Aplikasi atau website: kirim kode OTP login lewat WhatsApp.

• Sistem internal: kirim laporan harian ke grup WhatsApp tim.

• Customer service: terima pesan masuk, lalu balas otomatis untuk kata kunci tertentu.

• CRM: sinkronkan data pelanggan ke List WatZap.

Contoh kodenya ada di halaman Contoh Use Case.

SDK, REST API, n8n, atau Plugin?

Pilihan	Perlu coding?	Cocok untuk
WatZap SDK	Ya (JavaScript/TypeScript)	Aplikasi atau backend Node.js, misalnya Express, Next.js, atau NestJS
REST API	Ya (bahasa apa pun)	Aplikasi PHP, Python, Go, dan lainnya. Lihat dokumentasi API
n8n	Hampir tidak	Alur kerja otomatis tanpa coding. Lihat Integrasi dengan N8N
Plugin & integrasi siap pakai	Tidak	WordPress, WooCommerce, OrderOnline, Scalev, dan lainnya di menu Integrations

Yang Perlu Disiapkan

• Akun WatZap dengan paket yang sudah mendukung fitur API.

• API Key. Lihat Mendapatkan API Key di Member Area.

• Minimal satu nomor WhatsApp yang terhubung:

  • WABA Official. Lihat Cara Connect Nomor WABA Official, atau

  • Nomor Unofficial untuk API beserta Number Key-nya. Lihat Menambahkan Nomor WA untuk API dan Mendapatkan Number Key untuk API.

• Node.js versi 18 atau lebih baru di server atau komputer Kamu.

Jalankan SDK hanya di server (backend). API Key memberi akses penuh ke akun WatZap Kamu. Jangan taruh API Key di kode website yang bisa dibuka pengunjung, dan jangan upload ke GitHub.

Siap mencoba? Lanjut ke Instalasi & Kirim Pesan Pertama.