Notifikasi transaksi otomatis via WhatsApp dikirim lewat WhatsApp API resmi memakai template, terpicu event di sistemmu. Begitu pembayaran sukses, pesanan masuk, atau resi terbit, sistem memanggil API dan pelanggan langsung menerima update tanpa admin mengetik manual.
Panduan ini menjelaskan cara kerjanya untuk sisi bisnis sekaligus langkah teknis nyata, termasuk struktur request yang benar, buat kamu yang mengintegrasikan WhatsApp notification API ke aplikasimu.
Apa Itu Notifikasi Transaksi via WhatsApp (dan Kenapa Lewat API)
Notifikasi transaksi adalah pesan otomatis yang mengabari pelanggan tentang status sebuah transaksi. Contoh event yang lazim antara lain konfirmasi pesanan, status pembayaran, nomor resi atau pengiriman, dan reminder tagihan. Ini pesan transaksional satu arah, bukan promosi.
Kenapa lewat API, bukan kirim manual dari HP admin? Setidaknya ada tiga alasan utama:
- Konsisten: format pesan seragam setiap kali.
- Terpicu event: pesan otomatis terkirim persis saat status berubah, bukan menunggu admin ingat.
- Skala: seribu pesanan atau satu pesanan diperlakukan sama, tanpa menambah beban ketik. Untuk bisnis, artinya pelanggan selalu dapat kepastian dan tim tidak lagi copy-paste update sepanjang hari.
Dibanding channel lain, WhatsApp punya karakter yang cocok untuk notifikasi transaksi. SMS memang terkirim ke hampir semua ponsel, tapi terbatas teks polos dan tidak punya jalur balik yang praktis. Email sering tenggelam di folder promosi dan jarang dibuka cepat untuk hal seperti status pesanan.
WhatsApp berada di antara keduanya. Pesan sampai di aplikasi yang dibuka pelanggan setiap hari, mendukung isi terformat, dan tetap membuka ruang percakapan bila pelanggan ingin bertanya. Trade-off-nya, WhatsApp menuntut jalur resmi dan template yang di-approve. Bagian berikut menjelaskan apa yang perlu kamu siapkan.
Yang Perlu Disiapkan Sebelum Kirim Notifikasi Otomatis
Sebelum baris kode pertama, ada tiga hal yang harus siap.
WhatsApp Business API Resmi (Meta)
Notifikasi otomatis wajib lewat WhatsApp Business Platform resmi Meta, bukan aplikasi WhatsApp biasa atau WhatsApp Business app di HP. Jalur resmi memberi akses endpoint API, manajemen template, dan status pengiriman. Aplikasi biasa tidak dirancang untuk pengiriman terprogram dan berisiko diblokir. Chat Gateway API api.co.id berjalan di atas WhatsApp Business Platform resmi Meta, jadi notifikasimu terkirim lewat jalur yang diakui.
Template Kategori UTILITY
Setiap notifikasi transaksi harus berbentuk template yang dibuat lebih dulu dan di-approve Meta. Notifikasi transaksi masuk kategori UTILITY. Menurut dokumentasi Meta for Developers soal utility templates, kategori UTILITY dipakai untuk pesan yang menindaklanjuti aksi atau transaksi pengguna, seperti konfirmasi pesanan, update pengiriman, alert akun, dan tagihan berulang. Menempatkan kategori yang benar itu penting, karena kategori yang salah bisa membuat template ditolak atau direklasifikasi Meta.
Consent dan Data Pelanggan
Pastikan pelanggan sudah opt-in untuk menerima pesan darimu, dan nomor tersimpan dalam format internasional E.164 (misalnya 628123456789). Consent penting bukan hanya soal kepatuhan, tapi juga menjaga reputasi nomor pengirimmu.
Cara Kerja Notifikasi Transaksi (Alur Teknis)
Alur end-to-end-nya bisa dipetakan dalam empat langkah.
- Event terjadi di sistemmu, misalnya pembayaran berstatus sukses.
- Sistem memanggil endpoint kirim WhatsApp API dengan template dan data pelanggan.
- Pesan template dikirim ke nomor pelanggan lewat WhatsApp Business Platform.
- Pelanggan menerima notifikasi di WhatsApp mereka.
Satu hal yang sering terlewat, yaitu jendela 24 jam. Kamu hanya bisa mengirim pesan bebas (free-form) dalam 24 jam sejak interaksi terakhir pelanggan. Di luar jendela itu, satu-satunya yang boleh dikirim adalah template. Karena notifikasi transaksi biasanya dipicu event kapan saja, sering di luar 24 jam, notifikasi transaksi memang harus dikirim sebagai template. Ini bukan kelemahan, justru alasan template UTILITY ada.
Secara implementasi, langkah 2 dan 3 dalam alur di atas terjadi di kodemu. Kamu tidak memanggil API dari HP, melainkan dari backend aplikasi. Biasanya kamu menaruh pemanggilan di handler yang sudah ada, misalnya di webhook payment gateway atau di service yang memproses status order. Begitu status berubah, satu HTTP request ke endpoint kirim sudah cukup untuk menembakkan notifikasi.
Karena semua jenis pesan lewat satu endpoint yang sama, kamu cukup mengelola satu integrasi untuk konfirmasi pesanan, status bayar, sampai resi, dibedakan hanya oleh nama template dan isi variabelnya.
Langkah Kirim Notifikasi Transaksi via WhatsApp API
Berikut langkah konkret menggunakan Chat Gateway API api.co.id. Base URL API adalah https://chat.api.co.id dengan base path /api/v1/public/. Semua request diautentikasi dengan Bearer token di header Authorization: Bearer {API_KEY} dan mengirim body JSON.
1. Buat Template UTILITY
Buat template lewat POST /api/v1/public/templates. Isi category dengan UTILITY dan gunakan {{1}}, {{2}} untuk variabel body seperti nama pelanggan dan nomor order.
POST /api/v1/public/templates
Authorization: Bearer {API_KEY}
Content-Type: application/json
{
"template_name": "order_update_example",
"category": "UTILITY",
"language": "id",
"body": "Halo {{1}}, pesanan {{2}} Anda sedang diproses.",
"variables": ["Budi", "INV-00000"],
"whatsapp_phone_number_id": "{PHONE_NUMBER_ID}"
}Nama template hanya boleh huruf kecil, angka, dan underscore. Jumlah nilai di variables harus sama dengan jumlah placeholder di body.
2. Submit dan Tunggu Approval Meta
Setelah template dibuat, submit ke Meta untuk approval lewat POST /api/v1/public/templates/{TEMPLATE_ID}/submit. Request ini tidak butuh body. Template baru bisa dikirim setelah statusnya berubah menjadi approved. Approval dilakukan oleh Meta, jadi sisakan waktu tunggu sebelum go-live.
3. Kirim Template saat Event Terjadi
Semua pengiriman pesan lewat satu endpoint: POST /api/v1/public/messages/send. Notifikasi transaksi dikirim dengan message_type: "template" dan isi variabel lewat components. Nilai parameters[0] mengisi {{1}}, parameters[1] mengisi {{2}}, dan seterusnya.
POST /api/v1/public/messages/send
Authorization: Bearer {API_KEY}
Content-Type: application/json
{
"phone_number": "{CUSTOMER_PHONE}",
"channel": "whatsapp",
"message_type": "template",
"whatsapp_phone_number_id": "{PHONE_NUMBER_ID}",
"template": {
"name": "order_confirmation",
"language": { "code": "id" },
"components": [
{ "type": "body", "parameters": [
{ "type": "text", "text": "Nama Customer" },
{ "type": "text", "text": "INV-00000" }
] }
]
}
}Panggilan ini yang kamu tempatkan di titik event sistemmu, misalnya di webhook payment gateway ketika status berubah menjadi paid. Template tanpa variabel bahkan lebih ringkas: cukup kirim template.name dan template.language tanpa components.
4. Pantau Lewat Webhook dan Status
Chat Gateway API menyediakan webhook untuk menerima update, dan endpoint webhook bisa kamu kelola sendiri (list, get, serta enable ulang bila auto-disabled). Manfaatkan ini untuk melacak status pengiriman notifikasi. Detail struktur payload webhook mengikuti dokumentasi teknis resmi, jadi rujuk dokumentasi saat memetakan field.
Contoh Skenario Notifikasi Transaksi
Berikut beberapa skenario umum dan template UTILITY yang cocok untuk masing-masing.
- E-commerce:Â Konfirmasi pesanan begitu checkout selesai, lalu notifikasi resi saat barang dikirim. Dua template UTILITY terpisah, dipicu event order-created dan order-shipped.
- Jasa dan reservasi:Â Reminder janji atau jadwal, dipicu H-1 sebelum appointment. Template UTILITY dengan variabel nama dan waktu.
- Invoice dan tagihan:Â Notifikasi status pembayaran (berhasil atau menunggu) dan reminder tagihan berulang. Template UTILITY dengan variabel nama dan nominal.
Batasan yang Perlu Kamu Tahu
Supaya integrasimu tidak tersendat, sadari batasan ini dari awal.
- Jendela 24 jam:Â Di luar 24 jam sejak interaksi terakhir pelanggan, hanya template yang boleh dikirim, bukan pesan bebas.
- Wajib approval template:Â Tidak ada notifikasi yang bisa dikirim sebelum templatenya di-approve Meta.
- Kategori harus benar:Â Notifikasi transaksi harus UTILITY. Template yang mencampur konten utility dengan promosi bisa direklasifikasi Meta menjadi MARKETING, seperti dijelaskan di panduan template categorization Meta.
- Consent dan opt-out:Â Pelanggan bisa menolak menerima pesan, jadi hormati status consent mereka.
Mulai Kirim Notifikasi Transaksi
Untuk mengirim notifikasi transaksi otomatis, kamu butuh akses WhatsApp API resmi dan satu endpoint kirim yang jelas. Chat Gateway API dari api.co.id menyediakan satu endpoint messages/send untuk semua jenis pesan plus manajemen template, dan sudah dipakai 5000+ pengguna dengan jutaan panggilan API di seluruh produknya. Buat template UTILITY, submit ke Meta, lalu picu pengiriman dari event di sistemmu. Pelajari juga panduan notifikasi dan integrasi WhatsApp lainnya untuk melengkapi implementasimu.
