REST API WhatsApp: Kirim Pesan via API dalam 5 Menit

Mengirim pesan WhatsApp dari aplikasi Anda tidak harus rumit. Dengan REST API Shiftwa, satu request HTTP sudah cukup untuk mengirim teks ke nomor mana pun. Panduan ini membawa Anda dari membuat API key sampai pesan pertama terkirim.

Langkah 1: Buat API key

API key adalah kredensial yang mengizinkan aplikasi Anda mengakses gateway. Buat key dari dashboard, simpan di tempat aman, dan jangan pernah menaruhnya langsung di kode klien atau repositori publik. Gunakan variabel lingkungan di server Anda.

Langkah 2: Kirim pesan pertama

Untuk mengirim teks, kirim request POST dengan API key di header dan nomor tujuan serta isi pesan di body. Contoh berikut menggunakan curl, tapi pola yang sama berlaku untuk bahasa apa pun.

curl -X POST https://api.shiftwa.dev/v1/messages \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "type": "text",
    "text": "Halo! Pesanan Anda sudah kami terima."
  }'

Langkah 3: Kirim media dan pesan grup

Setelah teks berhasil, mengirim gambar, dokumen, atau pesan grup hanya soal mengganti tipe dan menambahkan URL media. Struktur request tetap sama, sehingga menambah kemampuan ke integrasi Anda berjalan mulus.

• Kirim teks untuk notifikasi, OTP, dan konfirmasi pesanan.
• Kirim media untuk invoice, katalog, atau bukti pengiriman.
• Kirim ke grup untuk pengumuman internal tim.

Tangani respons dan error

Setiap request mengembalikan status. Tangani respons sukses dengan menyimpan ID pesan untuk pelacakan, dan tangani error dengan membaca kode error agar tahu apakah perlu mencoba ulang. Untuk menerima balasan pelanggan, daftarkan webhook agar pesan masuk terkirim ke sistem Anda.

Buat integrasi tahan banting

Gunakan Idempotency-Key agar percobaan ulang tidak mengirim pesan ganda, dan terapkan antrean di sisi Anda untuk lonjakan trafik. Platform sudah menangani failover dan rotasi nomor, jadi Anda fokus pada logika bisnis.