Platform WhatsApp Business > Cloud API > Panduan

Membagikan Produk dengan Pelanggan

Anda memiliki banyak cara untuk membagikan produk dengan pelanggan Anda:

Pesan Katalog — Pesan bentuk bebas yang berisi tombol yang, jika diketuk, menampilkan katalog produk Anda di WhatsApp.
Pesan Katalog — Pesan template yang berisi tombol yang ketika diketuk, menampilkan katalog produk Anda di WhatsApp.
Pesan Tautan Katalog—Pesan bentuk bebas yang berisi gambar mini katalog dan tautan ke seluruh katalog produk Anda.
Pesan Produk—Pesan bentuk bebas yang berisi informasi tentang satu produk atau hingga 30 produk dari katalog produk Anda.
Pesan Template Multiproduk — Pesan template berisi informasi tentang maksimal 30 produk dari katalog ecommerce Anda, yang ditata dalam maksimal 10 bagian, dalam satu pesan.

Pesan Katalog

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.

Persyaratan

Anda harus memiliki stok yang diunggah ke Meta di katalog ecommerce yang terhubung ke Akun WhatsApp Business Anda.

Sintaksis Permintaan

Gunakan endpoint Nomor Telepon WhatsApp Business > Pesan untuk mengirim pesan katalog.

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Isi Posting

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<TO>",
  "type": "interactive",
  "interactive" : {
    "type" : "catalog_message",
    "body" : {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "catalog_message",
      
      /* Parameters object is optional */
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

    /* Footer object is optional */
    "footer": {
      "text": "<FOOTER_TEXT>"
  }
}

Properti

Placeholder	Deskripsi	Contoh Nilai
`<BODY_TEXT>` String	Wajib. Teks yang akan muncul di body pesan. Maksimal 1.024 karakter.	`Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase.`
`<FOOTER_TEXT>` String	Opsional. Teks yang akan muncul di footer pesan. Maksimal 60 karakter.	`Best grocery deals on WhatsApp!`
`<THUMBNAIL_PRODUCT_RETAILER_ID>` String	Opsional. Nomor SKU item. Dilabeli sebagai ID Konten di Commerce Manager. Gambar mini item ini akan digunakan sebagai gambar judul pesan. Jika objek `parameters` diabaikan, gambar produk dari item pertama di katalog Anda akan digunakan.	`2lc20305pt`
`<TO>` String	Nomor telepon pelanggan.	`+16505551234`

Contoh Permintaan

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "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!"
    }
  }
}'

Contoh Tanggapan

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

Pesan Template Katalog

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 dalam pesan template.

Pesan Tautan Katalog

Anda dapat mengirim tautan ke katalog seluruh produk Anda dengan menyusun tautan wa.me dan menyertakannya dalam pesan teks standar. Saat mengirim pesan teks, Anda 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 Anda 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 Anda, termasuk kode negara, ke akhir string berikut:

https://wa.me/c/

Contoh:

https://wa.me/c/15555455657

Pesan Produk

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:

Ringkasan

Pelanggan yang menerima pesan Multiproduk dan Satu Produk dapat melakukan 3 tindakan utama:

Lihat produk: Pelanggan dapat melihat daftar produk atau hanya satu produk. Setiap kali pelanggan mengeklik item tertentu, kami mengambil info terbaru produk dan menampilkan produk dalam format Halaman Detail Produk (PDP). Saat ini, PDP hanya mendukung gambar produk—video dan/atau GIF apa pun yang ditambahkan ke produk tidak akan ditampilkan dalam PDP.
Tambahkan produk ke keranjang belanja: Setiap kali pengguna menambahkan produk ke keranjang belanja, kami mengambil info terbaru item tersebut. Jika ada perubahan status pada salah satu item, kami menampilkan dialog yang berbunyi, "Satu atau beberapa item dalam keranjang belanja Anda telah diperbarui"—Lihat Info Terkini Produk untuk informasi selengkapnya. Keranjang belanja bertahan dalam utas obrolan antara Anda dan pelanggan sampai keranjang belanja dikirim kepada Anda—Lihat Pengalaman Keranjang Belanja untuk detailnya.
Mengirim keranjang belanja kepada Anda: Setelah menambahkan semua barang yang dibutuhkan, pelanggan dapat mengirimkan keranjang belanja mereka kepada Anda. Setelah itu, Anda dapat menentukan langkah berikutnya, seperti meminta info pengiriman atau memberikan opsi pembayaran.

Jika pelanggan memiliki beberapa perangkat yang terhubung ke akun mereka, 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:

iOS: 2.21.100 (Pesan Multiproduk) dan 2.21.210 (Pesan Satu Produk).
Android: 2.21.9.15 (Pesan Multiproduk) dan 2.21.19 (Pesan Satu Produk).
Web: Klien web yang mendukung fitur ini telah diluncurkan.

Jika versi aplikasi pelanggan tidak mendukung Pesan Multiproduk atau Satu Produk, aplikasi tersebut sebagai gantinya akan menerima pesan yang menjelaskan bahwa aplikasi tidak dapat menerima pesan karena menggunakan versi WhatsApp yang sudah lama. Kami juga akan mengirimi Anda notifikasi Webhooks yang menunjukkan pesan tidak dapat disampaikan karena pelanggan menggunakan versi WhatsApp versi lama.

Ekspektasi Perilaku untuk Pesan

Pesan Multiproduk dan Pesan Satu Produk bisa:

Diteruskan oleh satu pengguna ke pengguna lainnya.
Dibuka kembali oleh pengguna dalam percakapan yang sama.

Pesan Multiproduk dan Pesan Satu Produk tidak bisa:

Dikirim sebagai notifikasi. Pesan hanya dapat dikirim sebagai bagian dari percakapan yang ada.

Batasan

Tidak seperti pesan produk yang dikirim melalui aplikasi WhatsApp Business, pesan yang dikirim melalui Cloud API saat ini tidak menampilkan ikon keranjang belanja di tajuk utas obrolan.

Info Terkini seputar Produk

Anda mungkin perlu memperbarui properti item di katalog Anda. Tergantung properti yang diperbarui, inilah cara kami menangani pesan yang menyebutkan produk itu:

Properti yang Diperbarui	Proses Pembaruan
Harga, judul, deskripsi, dan gambar produk.	Anda mengirim pesan Multiproduk atau Satu Produk yang berisi produk A. Anda memperbarui properti produk A di katalog mereka. Layar yang menampilkan produk akan diperbarui segera setelah klien pelanggan mengetahui perubahan tersebut dari server.
Perubahan ketersediaan	Anda mengirim pesan Multiproduk atau Satu Produk yang berisi produk B kepada pelanggan. Anda menjual semua unit produk B yang tersedia. Kemudian, Anda memperbarui katalog Anda dengan mengatakan bahwa produk B tidak lagi tersedia Jika pelanggan sudah menambahkan produk B ke keranjang belanja, item tersebut akan dihapus dari keranjang belanja. Keranjang belanja menampilkan dialog yang berbunyi, "Satu atau beberapa item di keranjang belanja Anda telah diperbarui". Jika pelanggan belum menambahkan produk B ke keranjang belanja, Pesan Multiproduk atau Satu Produk sekarang menunjukkan item sebagai tidak tersedia.

Properti yang Diperbarui

Proses Pembaruan

Harga, judul, deskripsi, dan gambar produk.

Anda mengirim pesan Multiproduk atau Satu Produk yang berisi produk A.
Anda memperbarui properti produk A di katalog mereka.
Layar yang menampilkan produk akan diperbarui segera setelah klien pelanggan mengetahui perubahan tersebut dari server.

Perubahan ketersediaan

Anda mengirim pesan Multiproduk atau Satu Produk yang berisi produk B kepada pelanggan.
Anda menjual semua unit produk B yang tersedia. Kemudian, Anda memperbarui katalog Anda dengan mengatakan bahwa produk B tidak lagi tersedia
Jika pelanggan sudah menambahkan produk B ke keranjang belanja, item tersebut akan dihapus dari keranjang belanja. Keranjang belanja menampilkan dialog yang berbunyi, "Satu atau beberapa item di keranjang belanja Anda telah diperbarui".
Jika pelanggan belum menambahkan produk B ke keranjang belanja, Pesan Multiproduk atau Satu Produk sekarang menunjukkan item sebagai tidak tersedia.

Pengalaman Keranjang Belanja

Setelah melihat produk, pelanggan dapat menambahkan produk ke keranjang belanja dan mengirimkan keranjang belanja itu kepada Anda. Untuk tujuan perdagangan di WhatsApp, keranjang belanja:

Unik untuk utas obrolan pelanggan/bisnis di perangkat tertentu: Hanya satu keranjang belanja yang dibuat per utas obrolan antara Anda dan pelanggan, dan keranjang belanja yang sama tidak berlaku di beberapa perangkat. Setelah keranjang belanja dikirimkan, pelanggan dapat membuka keranjang belanja lain dengan Anda dan memulai prosesnya lagi.
Tidak memiliki tanggal kadaluwarsa: Keranjang belanja bertahan di utas obrolan sampai dikirimkan kepada Anda. Setelah terkirim, isi keranjang belanja dihapus.

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. Anda tidak dapat mengirim keranjang belanja kepada pelanggan.

Contoh pengalaman keranjang belanja dan ekspektasi perilaku untuk perubahan status item.

Manfaat Fitur Ini bagi Anda

Pesan Multiproduk dan Pesan Satu Produk 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 Anda.

Sederhana dan Efisien

Menggabungkan fitur ini dengan fitur navigasi seperti NLP, pencarian teks, atau Pesan Daftar dan Tombol Balas agar cepat menemukan apa yang dicari oleh pelanggan.

Pribadi

Diisi secara dinamis sehingga dapat dipersonalisasi sesuai pelanggan atau situasi. Contoh: Anda dapat menampilkan Pesan Multiproduk dari item yang paling sering dipesan oleh pelanggan.

Hasil Bisnis

Saluran kinerja untuk mendorong pesanan, selama pengujian, konversi bisnis rata-rata 7% dari Pesan Multiproduk yang dikirim ke keranjang belanja yang diterima.

Tidak Ada Template

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.

Kapan Sebaiknya Digunakan

Pesan Multiproduk paling baik digunakan untuk memandu pelanggan ke bagian tertentu dari stok Anda, seperti:

Berbelanja melalui percakapan. Contoh: menggunakan fungsi pencarian untuk memungkinkan pelanggan mengetik daftar belanja dan mengirim kembali pesan Multiproduk sebagai tanggapan.
Menavigasi ke kategori tertentu. Contoh: pakaian olahraga.
Promo yang dipersonalisasi atau rekomendasi.
Memesan ulang item yang sudah pernah dipesan. Contoh: pengguna dapat memesan ulang pesanan reguler mereka jika kurang dari 30 item.

Pesan Satu Produk paling baik digunakan untuk memandu pelanggan ke satu item tertentu dari stok Anda, menawarkan tanggapan cepat dari serangkaian opsi terbatas, seperti:

Menanggapi permintaan spesifik pelanggan.
Memberikan rekomendasi.
Memesan ulang item sebelumnya.

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.

Memulai

Sebelum mengirim pesan produk, ikuti cara memulai yang paling sesuai dengan kebutuhan Anda:

Semua panggilan API yang disebutkan dalam panduan ini harus diautentikasi dengan token akses. Developer dapat mengautentikasi panggilan API dengan token akses yang dibuat di panel Dasbor Aplikasi > WhatsApp > Pengaturan API. Mitra Solusi harus mengautentikasi diri sendiri dengan token akses dengan izin whatsapp_business_messaging.

Langkah 1: Susun Objek Interaktif

Pesan Satu-Produk

Untuk mengirim Pesan Satu Produk, susun objek interactive dari jenis product dengan komponen berikut:

Komponen Wajib	Komponen Opsional
Objek Tindakan—Harus mencakup catalog_id dan product_retailer_id.	Objek Body Objek Footer

Lihat Pesan, Objek Interaktif untuk informasi lengkapnya. Pada akhir proses, objek interaktif harus terlihat seperti ini:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "product_retailer_id": "ID_TEST_ITEM_1"
    }
  }
}

Pesan Multiproduk

Untuk mengirim Pesan Multiproduk, susun objek interactive dari jenis product_list dengan komponen berikut:

Komponen Wajib	Komponen Opsional
Objek Header—Jenis Header harus diatur ke teks. Jangan lupa untuk menambahkan objek teks dengan konten yang diinginkan. Objek Isi Objek Tindakan—Harus mencakup catalog_id dan bagian. Bagian harus berupa array objek yang mendeskripsikan setiap bagian menggunakan judul dan produk_items. Setiap nilai product_items bagian harus berupa array yang mendeskripsikan setiap produk di bagian menggunakan product_retailer_id dan nomor SKU produk.	Objek Footer

Komponen Wajib

Komponen Opsional

Objek Header—Jenis Header harus diatur ke teks. Jangan lupa untuk menambahkan objek teks dengan konten yang diinginkan.
Objek Isi
Objek Tindakan—Harus mencakup catalog_id dan bagian.
- Bagian harus berupa array objek yang mendeskripsikan setiap bagian menggunakan judul dan produk_items.
  - Setiap nilai product_items bagian harus berupa array yang mendeskripsikan setiap produk di bagian menggunakan product_retailer_id dan nomor SKU produk.

Objek Footer

Lihat Pesan, Objek Interaktif untuk informasi lengkapnya. Pada akhir proses, objek interaktif harus terlihat seperti ini:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header":{
      "type": "text",
      "text": "HEADER_CONTENT"
    },
    "body": {
      "text": "BODY_CONTENT"
    },
    "footer": {
      "text": "FOOTER_CONTENT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "sections": [
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]

        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}

Item yang Tidak Ada

Jika tidak ada item yang disediakan dalam panggilan API di atas yang cocok dengan produk dari katalog Anda, 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 produk Anda. Dalam hal ini:

Pesan berhasil terkirim
Item tanpa ada yang cocok akan dihapus
Anda menerima pesan kesalahan yang meminta pembaruan katalog

Langkah 2: Tambahkan Parameter Pesan Umum

Setelah objek interaktif selesai, tambahkan parameter lain yang menyusun pesan: recipient_type, to, messaging_product, dan type. Jangan lupa mengatur type ke interactive.

curl -X  POST https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

Untuk semua parameter yang tersedia, lihat Referensi, Pesan.

Langkah 3: Kirim Permintaan ke Endpoint Pesan

Kirim permintaan POST ke endpoint /PHONE_NUMBER_ID/messages dengan objek JSON yang disusun di Langkah 1 dan 2. Jika pesan berhasil dikirim, Anda mendapatkan tanggapan berikut:

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

Pesan Template Multiproduk

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.

Platform WhatsApp Business | Cloud API | API Pengelolaan Bisnis