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.

Membagikan Produk kepada Pelanggan

Bisnis memiliki dua cara untuk membagikan produk kepada pelanggan:

  • Pesan Katalog — Pesan bentuk bebas yang berisi tombol yang, jika diketuk, menampilkan katalog produk Anda di WhatsApp.
  • Pesan Template Katalog — Pesan template yang berisi tombol yang jika diketuk akan menampilkan katalog produk Anda di WhatsApp.
  • Pesan Tautan Katalog — Pesan yang berisi gambar mini katalog dan tautan ke seluruh katalog produk Anda.
  • Pesan Produk — Pesan yang berisi informasi tentang satu produk atau maksimal 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, di 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 Postingan

{
  "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>"
  }
}

Properti

PlaceholderDeskripsiContoh 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

Wajib.


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

{
  "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 ke pesan template.

Pesan Tautan Katalog

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 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

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

  1. Melihat produk: Pelanggan dapat melihat daftar produk atau hanya satu produk. Setiap kali pengguna 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.
  2. Menambahkan produk ke keranjang belanja: Pengguna dapat menambahkan produk ke keranjang belanjanya, atau mengubah jumlah langsung dari daftar atau di halaman detail produk. 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 bisnis dan pelanggan sampai keranjang belanja dikirim ke bisnis—Lihat Pengalaman Keranjang Belanja untuk detailnya.
  3. Mengirim keranjang belanja ke bisnis: Setelah menambahkan semua item yang dibutuhkan, pelanggan dapat mengirim keranjang belanja mereka ke bisnis yang berkirim pesan dengan mereka. Setelah itu, bisnis dapat menentukan langkah berikutnya, seperti meminta info pengiriman atau memberikan opsi pembayaran.

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:

  • 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 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.

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 Katalog, Pesan Multi-Produk, dan Pesan Produk Tunggal tidak boleh:

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

Info Terkini seputar Produk

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 DiperbaruiProses Pembaruan

Harga, judul, deskripsi, dan gambar produk.

  1. Bisnis mengirimkan pesan Multiproduk atau Satu Produk yang berisi produk A.
  2. Bisnis ini memperbarui properti produk A di katalog mereka.
  3. Layar yang menampilkan produk akan diperbarui segera setelah klien pelanggan mengetahui perubahan tersebut dari server.

Perubahan ketersediaan

  1. Bisnis mengirimkan pesan Multiproduk atau Satu Produk yang berisi produk B kepada pelanggan.
  2. Bisnisnya menjual semua unit produk B yang tersedia. Kemudian, bisnis memperbarui katalog mereka mengatakan bahwa produk B tidak lagi tersedia
  3. 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".
  4. 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 bisnis. Untuk tujuan perdagangan di WhatsApp, keranjang belanja:

  • Unik untuk utas obrolan orang/bisnis di perangkat tertentu: Hanya satu keranjang belanja yang dibuat per utas obrolan antara pelanggan dan bisnis, dan keranjang belanja yang sama tidak berlaku di beberapa perangkat. Setelah keranjang belanja dikirimkan, pelanggan dapat membuka keranjang belanja lain dengan bisnis tersebut dan memulai prosesnya lagi.
  • Tidak memiliki tanggal kadaluwarsa: Keranjang belanja bertahan di utas obrolan sampai dikirimkan kepada bisnis. Setelah terkirim, 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 mereka. Bisnis 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 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.

Sederhana & Efisien

Menggabungkan fitur 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 bisnis, seperti:

  • Berbelanja dengan cara 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 dipesan sebelumnya. Contoh: pengguna dapat memesan ulang pesanan reguler mereka yang berjumlah kurang dari 30 item.

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:

  • 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 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.

Langkah 1: Susun Objek Interaktif

Pesan Satu Produk

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

ObjekDeskripsi

body

Opsional.

Objek body. Lihat semua opsi untuk objek body.

footer

Opsional.

Objek footer. Lihat semua opsi untuk objek footer.

action

Wajib.

Kolom tindakan harus menyertakan:

  • catalog_id: ID untuk katalog yang ingin digunakan dalam pesan ini. Mengambil ID ini melalui Commerce Manager.
  • product_retailer_id: Pengidentifikasi unik produk.

Lihat semua opsi untuk objek action.

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"
    }
}

Pesan Multiproduk

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

ObjekDeskripsi

header

Wajib.

type header harus diatur ke text. Jangan lupa untuk menambahkan objek text dengan konten yang diinginkan. Lihat semua kolom header yang tersedia.

body

Wajib.

Objek body. Lihat semua opsi untuk objek body.

footer

Opsional.

Objek footer. Lihat semua opsi untuk objek footer.

action

Wajib.

Kolom tindakan harus menyertakan:

  • catalog_id: ID untuk katalog yang ingin digunakan dalam pesan ini. Mengambil ID ini melalui Commerce Manager.
  • sections: Array objek bagian. Anda harus menyertakan setidaknya satu bagian.

Di dalam tiap bagian, Anda dapat menyertakan hal berikut:

  • title: Sertakan judul setiap bagian jika Anda berencana akan menggunakan beberapa.
  • product_items: Array objek produk yang akan ditampilkan.

Tiap objek produk berisi product_retailer_id, yang sesuai dengan pengidentifikasi unik produk. Mengambil ID ini melalui Commerce Manager. Lihat semua opsi untuk objek action.

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" }
                           ...
              ]},
               ...
       ]
     },  
    }

Item yang Kurang

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:

  • Pesan berhasil terkirim,
  • Item tanpa ada yang cocok akan dihapus, dan
  • Bisnis menerima pesan kesalahan meminta pembaruan katalog.

Langkah 2: Tambahkan Parameter Pesan Umum

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.

Langkah 3: Buat Panggilan 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}"
  }]
  }

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.