Cara Kirim Pesan WhatsApp Lewat API (REST)

Kalau Anda seorang developer atau punya tim teknis, mengirim WhatsApp satu per satu lewat aplikasi jelas tidak masuk akal. Yang Anda butuhkan adalah cara memanggil pengiriman pesan langsung dari kode: dari backend saat pesanan masuk, dari website setelah pengguna daftar, atau dari workflow otomatis. Inilah gunanya WhatsApp API — sebuah REST API sederhana yang menerima nomor dan isi pesan, lalu mengirimkannya.

Artikel ini menjelaskan kapan Anda butuh API (bukan sekadar dashboard broadcast), cara memulai dalam beberapa langkah, endpoint inti yang tersedia, serta catatan keamanan agar nomor Anda tetap sehat. Untuk memahami mesin di baliknya, ada baiknya membaca dulu apa itu WhatsApp Gateway.

Kapan Anda Butuh API, Bukan Dashboard

Dashboard broadcast cocok untuk kampanye yang dikirim manual oleh tim marketing. Tetapi ada kebutuhan yang hanya bisa dijawab API, yaitu ketika pesan harus dipicu oleh kejadian di sistem Anda:

• OTP dan verifikasi. Pengguna daftar atau login, sistem langsung mengirim kode lewat WhatsApp secara real time.
• Notifikasi transaksi. Pesanan dibayar, status berubah menjadi dikirim, atau invoice jatuh tempo — semuanya dikirim otomatis tanpa staf menyalin nomor.
• Integrasi antar-aplikasi. Menyambungkan WhatsApp ke CRM, toko online, spreadsheet, atau alur otomatisasi n8n.

Intinya: kalau pemicunya adalah data dan waktu, bukan klik manusia, Anda butuh API.

Quickstart: Kirim Pesan Pertama

Alurnya ringkas. Hubungkan nomor lewat pindai QR, ambil token API dari dashboard, lalu panggil endpoint /send. Contoh permintaan paling dasar terlihat seperti ini:

POST https://app.jalinara.id/send
Header: Authorization: Bearer <TOKEN_API>
Body (JSON): { "target": "6281234567890", "message": "Halo, pesanan Anda dikonfirmasi." }

Responsnya berupa JSON, misalnya { "status": true, "detail": "message queued" }, menandakan pesan sudah masuk antrean pengiriman. Karena berbasis HTTP standar, Anda bisa memanggilnya dari bahasa apa pun — PHP, Node.js, Python, Go — cukup lakukan HTTP POST biasa.

Endpoint Inti

Ada beberapa endpoint yang paling sering dipakai. Semuanya menerima token lewat header Authorization (format Bearer <token> atau Token <token>).

POST /send — kirim pesan

Mengirim teks atau media ke satu nomor. Parameter wajib: target (nomor tujuan format internasional tanpa tanda plus, mis. 6281234567890) dan message (isi teks). Parameter opsional: url untuk melampirkan gambar, dokumen, atau video, dan filename untuk memberi nama berkas lampiran.

GET /device — cek status perangkat

Mengembalikan apakah perangkat WhatsApp Anda siap mengirim. Berguna dipanggil sebelum batch besar, agar Anda tidak mengirim ke antrean saat nomor sedang terputus.

POST /validate — cek nomor

Memeriksa apakah sebuah nomor terdaftar di WhatsApp, tanpa memakan kuota pesan. Berguna untuk membersihkan daftar kontak sebelum broadcast agar tidak membuang pesan ke nomor yang tidak aktif.

Referensi lengkap parameter dan contoh kode tersedia di halaman dokumentasi developer.

Keamanan dan Batas Wajar

API memudahkan, tapi justru karena mudah, ia gampang disalahgunakan. Beberapa hal yang perlu dijaga:

• Simpan token di server. Jangan pernah menaruh token di kode front-end atau repositori publik. Perlakukan seperti password.
• Hormati jeda pengiriman. Mengirim ratusan pesan dalam hitungan detik adalah pola yang berisiko diblokir. Untuk pengiriman massal, terapkan jeda seperti dijelaskan di artikel jeda aman WA blast.
• Panaskan nomor baru. Nomor yang baru dihubungkan sebaiknya tidak langsung mengirim volume besar. Lihat panduan warm-up nomor WhatsApp baru.
• Kirim hanya ke kontak yang setuju. Notifikasi transaksi ke pelanggan sendiri aman; blast promosi ke nomor yang tidak mengenal Anda berisiko dilaporkan.

Perlu diketahui: koneksi WhatsApp Web bukan API resmi Meta, dan Jalinara tidak berafiliasi dengan Meta. Untuk volume sangat besar atau OTP kritikal berskala tinggi, pertimbangkan juga jalur WhatsApp Cloud API resmi. Lihat perbandingan WhatsApp Business API vs biasa.

Contoh Penggunaan Nyata

Beberapa pola yang paling umum dibangun developer di atas API ini:

• Toko online: kirim notifikasi transaksi otomatis setiap status pesanan berubah.
• SaaS/website: OTP saat registrasi dan pengingat masa aktif akun.
• Operasional internal: peringatan sistem (server down, stok menipis) langsung ke WhatsApp tim.

Dengan API, WhatsApp berubah dari sekadar aplikasi chat menjadi kanal notifikasi yang bisa Anda program sesuai kebutuhan. Anda bisa buat token gratis lewat paket Free untuk mencoba mengirim pesan pertama hari ini.