Kami akan menghentikan On-Premises API. Lihat Proses Penghentian On-Premises API dokumen untuk detailnya, dan untuk mempelajari cara bermigrasi ke Cloud API generasi berikutnya.
We are making changes to the WhatsApp Business Platform pricing model. See Pricing Updates on the WhatsApp Business Platform.
Bisnis memiliki dua cara untuk membagikan produk kepada pelanggan:
Pesan katalog adalah pesan bentuk bebas yang memungkinkan Anda untuk memamerkan katalog produk Anda sepenuhnya di WhatsApp.
Pesan katalog menampilkan gambar judul gambar mini produk pilihan Anda, teks body khusus, header teks tetap, sub-header teks tetap, dan tombol Lihat katalog.
Ketika pelanggan mengetuk tombol Lihat katalog, katalog produk Anda muncul di WhatsApp.
Anda harus memiliki stok yang diunggah ke Meta di katalog ecommerce yang terhubung ke Akun WhatsApp Business Anda.
Gunakan endpoint Nomor Telepon WhatsApp Business > Pesan untuk mengirim pesan katalog.
POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<TO>", "type": "interactive", "interactive" : { "type" : "catalog_message", "body" : { "text": "<BODY_TEXT>" }, "action": { "name": "catalog_message", "parameters": { "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>" } }, /* Footer object is optional */ "footer": { "text": "<FOOTER_TEXT>" } }
Placeholder | Deskripsi | Contoh Nilai |
---|---|---|
String | Wajib. Teks yang akan muncul di body pesan. Maksimal 1.024 karakter. |
|
String | Opsional. Teks yang akan muncul di footer pesan. Maksimal 60 karakter. |
|
String | Wajib. Nomor SKU item. Dilabeli sebagai ID Konten di Commerce Manager. Gambar mini item ini akan digunakan sebagai gambar judul pesan. Jika objek |
|
String | Nomor telepon pelanggan. |
|
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "16505551234", "type": "interactive", "interactive": { "type": "catalog_message", "body": { "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase." }, "action": { "name": "catalog_message", "parameters": { "thumbnail_product_retailer_id": "2lc20305pt" } }, "footer": { "text": "Best grocery deals on WhatsApp!" } } }'
{ "messaging_product": "whatsapp", "contacts": [ { "input": "16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA" } ] }
Pesan template katalog adalah pesan template berisi tombol yang ketika diketuk, menampilkan katalog produk Anda di WhatsApp.
Untuk mengirim pesan template katalog, Anda memerlukan template katalog. Lihat dokumen Template Katalog kami untuk mempelajari cara membuat template ini dan cara mengirimkannya ke pesan template.
Bisnis dapat mengirim tautan ke katalog seluruh produknya dengan menyusun tautan wa.me dan menyertakannya dalam pesan teks standar. Saat mengirim pesan teks, bisnis dapat menggunakan preview_url
opsional yang diatur ke true
untuk membuat pesan me-render satu set gambar mini katalog produk dari setiap URL dalam string body
pesan.
Perhatikan bahwa jika bisnis menonaktifkan katalog, tautan wa.me dan tombol Lihat Katalog di pesan tautan katalog akan menampilkan pesan Tautan katalog tidak valid saat diketuk.
Untuk menyusun tautan wa.me, tambahkan nomor telepon bisnis, termasuk kode negara, ke akhir string berikut:
https://wa.me/c/
Contoh:
https://wa.me/c/15555455657
Pesan Multiproduk dan Pesan Satu Produk adalah jenis pesan interactive
.
Contoh pesan Multiproduk: | Contoh pesan Satu Produk: |
Menu terpicu saat pengguna mengeklik Mulai Belanja: | Contoh Halaman Detail Produk: |
Pengguna yang menerima pesan Multiproduk dan Satu Produk dapat melakukan 3 tindakan utama:
Jika pelanggan memiliki Beberapa perangkat yang terhubung ke akun WhatsApp yang sama, Pesan Multiproduk dan Satu Produk akan disinkronkan di antara perangkat. Namun, keranjang belanja bersifat lokal untuk setiap perangkat tertentu. Lihat Pengalaman Keranjang Belanja untuk detailnya.
Saat ini, jenis pesan ini dapat diterima di platform berikut:
2.21.100
(Pesan Multiproduk) dan 2.21.210
(Pesan Satu Produk).2.21.9.15
(Pesan Multiproduk) dan 2.21.19
(Pesan Satu Produk).Jika versi aplikasi penerima tidak mendukung Pesan Multiproduk atau Satu Produk, aplikasi tersebut malah akan menerima pesan yang menjelaskan bahwa aplikasi tidak dapat menerima pesan karena menggunakan versi WhatsApp yang sudah lama. Bisnis ini juga akan menerima notifikasi Webhooks yang menunjukkan bahwa pesan tersebut tidak dapat disampaikan karena penerima menggunakan versi WhatsApp yang sudah lama.
Pesan Multiproduk dan Pesan Satu Produk bisa:
Pesan Katalog, Pesan Multi-Produk, dan Pesan Produk Tunggal tidak boleh:
Bisnis mungkin perlu memperbarui properti item di katalog mereka. Tergantung pada properti yang diperbarui, inilah cara kami menangani pesan yang menyebutkan produk itu:
Properti yang Diperbarui | Proses Pembaruan |
---|---|
Harga, judul, deskripsi, dan gambar produk. |
|
Perubahan ketersediaan |
|
Setelah melihat produk, pelanggan dapat menambahkan produk ke keranjang belanja dan mengirimkan keranjang belanja itu kepada bisnis. Untuk tujuan perdagangan di WhatsApp, keranjang belanja:
Pelanggan dapat menambahkan hingga 99 unit dari setiap item katalog tunggal ke keranjang belanja, tetapi tidak ada batasan pada jumlah item berbeda yang dapat ditambahkan ke keranjang belanja.
Setelah keranjang belanja terkirim, tidak bisa diedit. Pelanggan dapat mengirim keranjang belanja baru jika membutuhkan item baru, atau ingin mengubah pesanan mereka. Bisnis tidak dapat mengirim keranjang belanja kepada pelanggan.
Pesan Multiproduk dan Produk Tunggal cocok untuk pengalaman pengguna yang sederhana dan dipersonalisasikan, menjadi pengalaman yang lebih baik untuk memandu pelanggan ke subset item yang paling relevan bagi mereka, daripada menelusuri stok lengkap bisnis.
Menggabungkan fitur dengan fitur navigasi seperti NLP, pencarian teks, atau Pesan Daftar dan Tombol Balas agar cepat menemukan apa yang dicari oleh pelanggan.
Diisi secara dinamis sehingga dapat dipersonalisasi sesuai pelanggan atau situasi. Contoh: Anda dapat menampilkan Pesan Multiproduk dari item yang paling sering dipesan oleh pelanggan.
Saluran kinerja untuk mendorong pesanan, selama pengujian, konversi bisnis rata-rata 7% dari Pesan Multiproduk yang dikirim ke keranjang belanja yang diterima.
Pesan interaktif tidak memerlukan template atau persetujuan terlebih dahulu. Pesan dibuat secara real-time dan akan selalu mencerminkan detail, harga, dan level stok terbaru item.
Pesan Multiproduk paling baik digunakan untuk memandu pelanggan ke bagian tertentu dari stok bisnis, seperti:
Pesan Satu Produk Tunggal paling baik digunakan untuk memandu pelanggan ke satu item tertentu dari stok bisnis, menawarkan tanggapan cepat dari serangkaian opsi terbatas, seperti:
Kedua fitur juga dapat digunakan sebagai bagian dari alur agen manusia, tetapi Anda perlu membuat fitur untuk memungkinkan agen manusia membuat Pesan Multiproduk atau Pesan Satu Produk di utas.
Sebelum mengirim setiap pesan, Anda perlu mendapatkan ID WhatsApp penerima Anda dengan panggilan ke node /contacts
.
Kami merekomendasikan pengaturan Webhooks untuk menerima status pesan dan notifikasi pesan masuk. Dengan cara ini, Anda dapat melacak: apakah pesan terkirim dan jawaban dari pelanggan.
Untuk mengirim Pesan Satu Produk, susun objek interactive
dari jenis product
dengan komponen berikut:
Objek | Deskripsi |
---|---|
| Opsional. Objek body. Lihat semua opsi untuk objek |
| Opsional. Objek footer. Lihat semua opsi untuk objek |
| Wajib. Kolom tindakan harus menyertakan:
|
Pada akhirnya, objek interaktif harus terlihat seperti ini:
"interactive": { "type": "product", "body": { "text": "text-body-content" }, "footer": { "text": "text-footer-content" }, "action": { "catalog_id": "catalog-id", "product_retailer_id": "product-SKU-in-catalog" } }
Untuk mengirim Pesan Multiproduk, susun objek interactive
dari jenis product_list
dengan komponen berikut:
Objek | Deskripsi |
---|---|
| Wajib.
|
| Wajib. Objek |
| Opsional. Objek |
| Wajib. Kolom tindakan harus menyertakan:
Di dalam tiap bagian, Anda dapat menyertakan hal berikut:
Tiap objek produk berisi |
Pada akhirnya, objek interactive
harus terlihat seperti ini:
"interactive": { "type": "product_list", "header":{ "type": "text", "text": "text-header-content" }, "body":{ "text": "text-body-content" }, "footer":{ "text":"text-footer-content" }, "action":{ "catalog_id":"catalog-id", "sections": [ { "title": "the-section-title", "product_items": [ { "product_retailer_id": "product-SKU-in-catalog" }, { "product_retailer_id": "product-SKU-in-catalog" }, ... ]}, { "title": "the-section-title", "product_items": [ { "product_retailer_id": "product-SKU-in-catalog" } ... ]}, ... ] }, }
Jika tidak ada item yang disediakan dalam panggilan API di atas yang cocok dengan produk dari katalog Facebook bisnis tersebut, pesan kesalahan dikirim dan Pesan Multiproduk atau Satu Produk tidak dikirim kepada pengguna.
Untuk Pesan Multiproduk, setidaknya satu item dari daftar produk harus sesuai dengan item dari Katalog Facebook bisnis tersebut. Dalam hal ini:
Setelah objek interaktif selesai, tambahkan parameter lain yang menyusun pesan: recipient_type
, to
, dan type
. Jangan lupa untuk mengatur type
ke interactive
.
{ "recipient_type": "individual", "to" : "whatsapp-id", // WhatsApp ID of the recipient "type": "interactive", "interactive":{ // The interactive object } }
Lihat parameter yang umum untuk semua jenis pesan di sini.
POST
ke /messages
Kirim panggilan POST
ke endpoint /messages
dengan objek JSON
yang disusun di Langkah 1 dan 2. Jika pesan berhasil dikirim, Anda mendapatkan tanggapan berikut:
{ "messages": [{ "id": "{message-id}" }] }
Untuk mengirim pesan template multiproduk, Anda memerlukan template pesan multiproduk. Lihat dokumen Template Pesan Multiproduk kami untuk mempelajari cara membuat template ini dan cara mengirimkannya dalam pesan template.