Webhook WhatsApp API yang Perlu Diketahui Pebisnis UKM

Webhook WhatsApp adalah jalur atau pintu gerbang otomatis yang membuat server WhatsApp memberikan informasi ke sistem bisnis Anda setiap ada kejadian baru, misalnya pesan masuk dari pelanggan atau perubahan status pesan terkirim.

Tanpa webhook, CRM Anda baru tahu ada chat baru setelah seseorang membuka aplikasinya. Sebaliknya, kalau menggunakan webhook, chat itu muncul di dashboard dalam secara langsung.

Bagi pemilik UKM, customer service, sales, dan marketer, webhook WhatsApp menentukan seberapa cepat tim membalas, seberapa rapi data lead yang tercatat, dan berapa biaya pesan yang bisa Anda hemat.

Di artikel CRM.ID ini kita akan bahas terkait webhook WhatsApp, cara kerjanya, jenis event yang masuk, risiko saat webhook gagal, hubungannya dengan biaya, sampai cara setting tanpa perlu jadi programmer/developer.

Di bagian akhir Anda juga mendapat peta event ke tugas tim, simulasi kerugian saat webhook mati, dan 7 pertanyaan untuk vendor.

Semuanya tersedia sebagai template yang bisa Anda salin ke Word atau Sheets atau langsung download.

Daftar isi show

Apa Itu Webhook WhatsApp dan Kenapa Pelaku UKM Perlu Tahu?

Webhook adalah panggilan balik (callback) otomatis dari satu aplikasi ke aplikasi lain saat ada pemantiknya.

Pada WhatsApp, kejadian/pemantik itu bisa berupa pesan masuk, status terkirim, atau perubahan kualitas nomor. Server WhatsApp lalu mengirim data kejadian ke alamat URL yang Anda daftarkan.

Alasan UKM perlu peduli ada di kebiasaan pelanggan. Laporan DataReportal Digital 2026 mencatat 90,8% pengguna internet Indonesia menggunakan WhatsApp sebulan terakhir.

Menurut We Are Social, mereka menghabiskan sekitar 1 jam 52 menit per hari di aplikasi ini.

Yudhi Hastiardi, Managing Director We Are Social Indonesia, menyebut media sosial sudah menjadi tempat orang menemukan produk, memutuskan membeli, lalu langsung bertindak.

Karena customer Anda sebagian besar ada di WhatsApp, jadi kecepatan membalas pesan juga turut serta dalam menentukan penjualan.

Apa Bedanya Webhook dengan API WhatsApp?

API bekerja saat sistem Anda yang memanggil WhatsApp, misalnya untuk mengirim pesan.

Webhook bekerja sebaliknya, karena WhatsApp yang menghubungi sistem Anda saat ada kabar terbaru. Anggap API sebagai telepon keluar dan webhook sebagai telepon masuk. Keduanya saling melengkapi.

Webhook memberi tahu CRM kalau ada pesan masuk, lalu CRM menggunakan API untuk meresponnya.

Aplikasi WhatsApp Business biasa tidak memiliki webhook, jadi tim yang butuh shared inbox atau chatbot perlu beralih dari WhatsApp biasa ke sistem CRM yang menggunakan WhatsApp Business API.

Tim Anda juga bisa memanfaatkan webhook untuk menyaring pertanyaan berulang, yang mana terdapat panduan dari Meta for Developers menyebut kalau webhook pesan masuk bisa mengurangi beban agen layanan pelanggan.

Cara Kerja Webhook WhatsApp Business API dari Pesan Masuk sampai Muncul di CRM

Flownya terdiri dari 2 fase, antara lain fase pertama untuk verifikasi yang terjadi sekali saat setting, sedangkan fase kedua adalah pengiriman notifikasi setiap ada trigger.

Dokumentasi resmi Webhooks WhatsApp Cloud API menyebutkan kalau endpoint Anda harus menangani 2 jenis permintaan HTTPS, yaitu verification request dan event notification.

Tahap Verifikasi dengan Verify Token

Saat Anda mendaftarkan URL di Meta App Dashboard, WhatsApp mengirim permintaan GET berisi hub.mode, hub.verify_token, dan hub.challenge.

Server Anda mencocokkan verify token, yaitu kata sandi buatan Anda sendiri, lalu mengembalikan nilai hub.challenge apa adanya. Kalau cocok, URL Anda resmi terdaftar, sebagaimana penjelasan di Hookdeck.

Tahap ini sering membuat setting berhenti. Banyak orang membalas dengan format JSON padahal Meta meminta nilai mentah, dan sebagian menyamakan verify token dengan app secret padahal fungsinya berbeda, menurut Webhook Relay.

Kalau Anda menggunakan CRM yang sudah terintegrasi, vendor mengurus tahap ini untuk Anda.

Tahap Notifikasi dan Isi Payload

Setelah verifikasi, WhatsApp mengirim notifikasi lewat permintaan POST. Format dasarnya memuat objek whatsapp_business_account dengan entry dan changes, dengan metadata nomor bisnis.

Satu payload bisa membawa beberapa pesan sekaligus dan berukuran sampai 3 MB.

Isinya seperti teks atau media, nomor pengirim, dan ID pesan unik. Metadata nomor bisnis yang memudahkan Anda saat menggunakan lebih dari satu nomor WhatsApp dalam satu CRM.

Keamanan dengan Tanda Tangan X-Hub-Signature-256

Setiap POST dari Meta membawa header X-Hub-Signature-256, hasil enkripsi HMAC-SHA256 dari isi pesan dengan app secret Anda.

Server wajib menghitung ulang nilai itu dan membandingkannya sebelum memproses data.

Tanpa langkah ini, siapa pun yang tahu URL Anda bisa menyusupkan lead fiktif atau status pembayaran palsu.

Gareth Wilson dari Hookdeck menyarankan urutan kerja yang ringkas seperti validasi tanda tangan, memasukkan payload ke antrian, lalu segera membalas.

Meta juga tidak mendukung sertifikat self-signed, jadi URL Anda wajib menggunakan HTTPS yang valid.

Jenis Event Webhook WhatsApp dan Artinya untuk Tim Anda

Webhook WhatsApp tidak hanya membawa pesan masuk saja, Meta sendiri mengelompokkan event/trigger ke dalam field yang bisa Anda langgani, dan tiap field butuh penanggung jawab atau PIC di tim.

Tabel berikut menerjemahkan istilah teknis menjadi tugas harian.

Event (field)	Artinya untuk Bisnis	Action di CRM	Penanggung Jawab / PIC
messages: pesan masuk	Pelanggan bertanya atau membalas	Buat lead, bagikan ke agen	CS dan Sales
messages: status sent, delivered, read, failed	Nasib pesan yang Anda kirim	Jadwalkan follow up, lalu ulangi jika gagal	Sales
message_template_status_update	Template lolos atau gagal lolos	Kirim alert sebelum campaign	Marketer
phone_number_quality_update	Kualitas nomor naik atau turun	Kurangi blast, tinjau opt-in	Supervisor
account_update	Status akun berubah	Cek akun Meta Business	Owner

Dengan adanya PIC atau penanggung jawab, Anda bisa menentukan orang atau agen yang tepat yang harus mencegah atau menangani insiden/pemicu terjadi, Anda atau tim Anda bisa mengisi template peta event di bagian template.

Contoh Penggunaan Webhook WhatsApp untuk Tim CS, Sales, dan Marketer

Tim CS memakai webhook pesan masuk untuk membagi chat ke agen yang sedang online dan menandai chat yang belum terjawab lebih dari 5 menit, kemudian supervisor melihat antrian itu tanpa membuka HP tiap agen.

Contoh Penggunaannya untuk untuk Tim CS, Sales, dan Marketer

Tim sales menggunakan event status pesan. Penawaran yang sudah terbaca tapi belum Anda balas selama 2 hari langsung masuk ke daftar follow up, sedangkan penawaran yang gagal terkirim akan memicu pengecekan nomor pelanggan.

Marketer juga perlu menggunakan event status template dan kualitas nomor sebagai rem darurat. Kalau kualitas nomor turun, Anda akan menahan blast campaign sampai data opt-in selesai Anda dan tim tinjau.

Apa yang Terjadi Kalau Webhook WhatsApp Gagal?

Kalau server Anda membalas selain status 200, Meta mengulang pengiriman dengan frekuensi sampai 7 hari.

Artinya pesan pelanggan tidak langsung menghilang begitu saja, tapi bisa datang terlambat, ganda, atau tidak berurutan.

Hookdeck mencatat WhatsApp tidak menjamin urutan event, sehingga sistem Anda harus aman memproses event yang sama 2 kali.

Di lapangan, efeknya terasa langsung seperti halnya pelanggan menerima balasan otomatis ganda, lead tercatat 2 kali, atau status read tiba lebih dulu daripada status delivered sehingga laporan tim akan membingungkan.

Tanyakan ke penyedia layanan apakah sistemnya menggunakan ID pesan untuk membuang duplikat.

Berikut contohnya pada toko Anda, yang mana misalnya menerima 15 chat baru per jam di jam-jam sibuk, lalu webhook mati 3 jam sehingga 45 chat tidak bisa masuk atau tampil di dashboard.

Jika 20% chat berpotensi jadi order dengan nilai rata-rata Rp 250.000, ada 9 order atau Rp 2.250.000 yang tertunda. Sebagian pelanggan tidak mau menunggu dan pindah ke toko lain.

Bagaimana Menghubungkan Webhook WhatsApp dengan Biaya Pesan?

Sejak 1 Juli 2025, Meta menagih per pesan dan tidak lagi per chat. Balasan non-template gratis selama jendela layanan 24 jam terbuka dan template utility yang terkirim dalam jendela itu juga gratis.

Meta hanya mengubah tarif pada awal kuartal, jadi cek halaman tarif resmi sebelum menyusun anggaran.

Webhook pesan masuk berperan membuka jendela itu. Jendela 24 jam berjalan sejak pelanggan mengirim pesan, bukan sejak sistem Anda menerimanya.

Jika webhook macet lebih dari 24 jam dan pengiriman ulang baru berhasil, Anda hanya bisa membalas lewat template berbayar. Webhook yang stabil menjaga balasan tetap gratis.

Bagaimana Bukti Riset Melihat Hubungan Webhook, CRM, dan UKM Indonesia?

Akhmad dan Nurohman melakukan survei pada 50 member komunitas UMKM di Sragen dan hasil penelitiannya itu tertuang dalam jurnal BEST 2025.

Hasilnya, 82% para member komunitas UMKM ini belum pernah menggunakan CRM, dengan hambatannya yaitu keterbatasan SDM (74%), biaya (65%), dan literasi teknologi (53%).

Setelah 5 UMKM mencoba E-CRM berbasis WhatsApp API selama 3 bulan, retensi rate pelanggan naik dari 42% ke 65%, biaya marketingnya turun dari Rp 2,5 juta ke Rp 2,05 juta per bulan dan omset naik dari Rp 12,5 juta ke Rp 14 juta.

Usanto dan tim juga melaporkan hasil serupa di Jurnal Rekayasa Informasi Swadharma (Januari 2026).

Pada UMKM fashion online, waktu responnya jadi turun dari 5 sampai 10 menit menjadi kurang dari 1 menit, dan efisiensi komunikasi naik sekitar 40%.

Flow itu hanya berjalan kalau ada sistem yang memfasilitasi pemberitahuan ketika ada pesan masuk, dan tugas itulah milik webhook.

Kedua studi menggunakan sampel kecil, jadi anggap angkanya sebagai indikator. Temuan awal Nata dkk. (Sistemasi, 2026) pada 11 UMKM kerajinan di Jambi memberi catatan tambahan.

Baik untuk balasan cepat otomatis tidak menaikkan efektivitas komunikasi, karena pelanggan butuh jawaban personal, Anda perlu menggunakan webhook untuk mempercepat pesan sampai ke agen atau tim yang tepat.

Bagaimana Bukti Riset Hubungannya dengan CRM, dan UKM Indonesia

Cara Setting Webhook WhatsApp untuk Pelaku UKM

Untuk menggunakannya dengan lancar Anda perlu melakukan setting dengan menggunakan 3 cara.

Cara pertama menggunakan CRM atau BSP yang sudah terintegrasi, dan penyedia menangani URL, verify token, serta tanda tangan.

Kalau cara kedua dengan membangun sendiri di Meta App Dashboard menggunakan server buatan developer.

Cara ketiga menggunakan WhatsApp gateway tidak resmi, yang tidak membawa signature dari Meta dan berisiko membuat akun terkena blokir.

Untuk pelaku UKM yang tidak memiliki tim developer atau programmer, cara yang pertama paling masuk akal. Anda bisa membaca panduan integrasi WhatsApp dengan software CRM, lalu lakukan uji ini:

Siapkan akun Meta Business dan nomor khusus untuk WhatsApp API
Daftar ke salah satu penyedia aplikasi CRM yang menggunakan API WhatsApp.
Hubungkan nomor ke CRM sesuai petunjuk dari penyedia aplikasi CRM
Kirim pesan dari HP lain, lalu catat berapa detik pesan itu muncul di CRM
Kirim pesan ke nomor tidak aktif untuk melihat status gagalnya
Simpan hasil pengujian di template log yang sudah tim CRM.ID sediakan, dan ulangi tiap bulan

7 Pertanyaan untuk Vendor Sebelum Anda Memutuskan untuk Berlangganan

Pertanyaan berikut bisa membantu Anda menilai kualitas webhook tanpa harus jago membaca kode atau coding, perhatikan juga untuk mencocokkan dengan checklist otomasi WhatsApp dari CRM.ID, sebagai berikut:

Apakah Anda menggunakan WhatsApp Cloud API resmi lewat BSP?
Apakah sistem memvalidasi tanda tangan X-Hub-Signature-256?
Berapa detik jeda pesan masuk sampai muncul di dashboard?
Bagaimana sistem menangani pesan ganda dan event tidak berurutan?
Apa yang terjadi saat server vendor down, adakah antrian?
Apakah perubahan status template dan kualitas nomor masuk sebagai notifikasi?
Bisakah webhook saya teruskan ke sistem lain, misalnya online shop atau spreadsheet?

Cara Setting Webhook WhatsApp untuk Pelaku UKM

Kesimpulan

Demikian artikel CRM.ID mengenai webhook WhatsApp, yang mana notabenenya sebagai penghubung yang membuat WhatsApp Business API berguna untuk bisnis Anda.

Mulai dari mengantar pesan masuk, status pengiriman, dan peringatan akun ke CRM Anda secara real time.

Cara kerjanya yaitu verifikasi sekali, lalu notifikasi POST yang Anda amankan dengan tanda tangan X-Hub-Signature-256.

Cara ini terbilang praktis untuk pelaku UKM karena tidak perlu mengerti hal-hal teknis untuk bisa menggunakannya.

Pelaku UKM jadi bisa merespon cepat dan CRM berbasis WhatsApp memperbaiki retensi dan efisiensi, selama Anda tetap menyisipkan sentuhan personal di pesan otomatis.

Kalau Anda belum punya tim developer, Anda bisa menggunakan jasa vendor resmi atau penyedia aplikasi.

Anda bisa mencoba software CRM WhatsApp API dari CRM.ID dan menguji sendiri berapa detik pesan pelanggan sampai di dashboard.

Gunakan template peta event, kalkulator risiko, dan log pengujian yang sudah tim CRM.ID lampirkan dalam tulisan ini.

Anda juga bisa menghubungi kontak tim CRM.id melalui nomor WhatsApp berikut.

About
Latest Posts

Ainur Rohman

Content Writer at PT Kledo Berhati Nyaman

Ainur Rohman adalah SEO content writer yang berfokus membuat konten SEO di topik-topik bisnis digital, digital marketing, customer service, CRM, dan aplikasi SaaS. Dia passionate menulis untuk meningkatkan peluang tercapainya KPI digital marketing dan bisnis.