Kirim pembaruan pesanan WooCommerce lewat WhatsApp

Bagaimana pesanan WooCommerce memicu pesan WhatsApp?

Lewat webhook WooCommerce dan sebuah penerima. Di WooCommerce, buka Settings, Advanced, Webhooks, lalu tambahkan webhook dengan topik pesanan, seperti order created atau order updated, sebuah URL pengiriman, dan sebuah secret. Setelah itu WooCommerce mengirim pesanan sebagai JSON ke URL tersebut setiap kali event terjadi.

Payload-nya sudah baku, sehingga tidak bisa diarahkan langsung ke Cloud API. Sebuah penerima berada di antaranya: node Webhook n8n, route di PHP milik toko, atau layanan kecil apa pun. Penerima membaca pesanan, mengambil nomor telepon pelanggan serta detail yang dibutuhkan pesan, lalu membuat satu permintaan HTTPS ke endpoint messages Cloud API untuk nomor yang terhubung, dengan access token nomor itu sebagai bearer token.

Topik order.updated tidak terikat pada satu status, jadi penerima sebaiknya membaca field status pesanan dan mengirim sekali untuk setiap transisi yang dianggap penting. Secara default WooCommerce mengirim di latar belakang lewat wp-cron, sehingga pesan bisa tiba sedikit terlambat setelah pesanan.

Bagaimana penerima tahu permintaan itu berasal dari toko?

Dari tanda tangan WooCommerce. Setiap pengiriman membawa header X-WC-Webhook-Signature, yaitu HMAC-SHA256 dari payload mentah yang dikodekan base64 dan dihitung dengan secret yang Anda atur pada webhook. Penerima menghitung hash yang sama atas body yang diterimanya, membandingkannya, dan menolak apa pun yang tidak cocok.

Ini adalah secret milik toko sendiri, jadi berbeda dengan tanda tangan Meta pada pesan WhatsApp masuk, tanda tangan ini bisa divalidasi. Bandingkan dalam waktu konstan, dan hitung hash dari body mentah sebelum framework mengurainya, karena JSON yang dikodekan ulang menghasilkan hash yang berbeda.

Balas dengan cepat memakai 2xx. WooCommerce menganggap setiap respons selain 2xx, 301, atau 302 sebagai kegagalan, dan setelah lebih dari lima kegagalan berturut-turut webhook dinonaktifkan. Penerima yang mati saat deploy, atau lambat karena menunggu Meta sebelum menjawab, bisa mematikan pesan toko tanpa ada yang menyadarinya.

Apa yang bisa dikirim toko, dan kapan?

Template yang sudah disetujui, setiap kali toko yang menulis lebih dulu. Jendela layanan pelanggan 24 jam dari Meta hanya terbuka saat pelanggan mengirim pesan ke nomor tersebut, sehingga konfirmasi pesanan atau pembaruan pengiriman diinisiasi oleh bisnis dan teks bebas ditolak. Buat template utility untuk setiap pembaruan, tunggu persetujuan, lalu kirim berdasarkan nama dan bahasa dengan nomor pesanan serta detail lain sebagai parameter.

Meta juga mewajibkan opt-in: pelanggan memberikan nomornya dan setuju dihubungi bisnis ini lewat WhatsApp. Kotak centang saat checkout yang disimpan pada pesanan adalah catatan paling sederhana untuk itu, dan penerima sebaiknya memeriksanya sebelum mengirim.

Setelah pelanggan membalas, percakapan berjalan sebagai Coexistence biasa. Balasan muncul di aplikasi WhatsApp Business pada ponsel toko, jendela terbuka untuk teks bebas, dan tim menjawab dari aplikasi seperti biasa.

Kesalahan umum

• Memanggil Cloud API sebelum menjawab WooCommerce. Pengiriman yang lambat atau gagal dihitung sebagai kegagalan webhook, yang dinonaktifkan setelah lebih dari lima kegagalan.
• Menghitung hash dari JSON yang sudah diurai, bukan dari body mentah. Tanda tangan tidak pernah cocok dan setiap pengiriman yang asli ditolak.
• Mengirim pada setiap pengiriman order.updated. Topik ini tidak terikat pada satu status, jadi tanpa melacak transisi mana yang sudah dikirimi pesan, pelanggan menerima pesan ganda.

Pertanyaan yang sering diajukan

Lanjut membaca