Template

Template digunakan dalam pesan template untuk membuka percakapan marketing, utilitas, dan autentikasi dengan pelanggan. Tidak seperti pesan bentuk bebas, pesan template adalah satu-satunya jenis pesan yang dapat dikirim kepada pelanggan yang belum mengirimi Anda pesan, atau yang belum mengirimi Anda pesan dalam 24 jam terakhir.

Template harus disetujui sebelum dapat dikirim dalam pesan template. Selain itu, template dapat dinonaktifkan secara otomatis berdasarkan masukan dan interaksi pelanggan. Setelah dinonaktifkan, template tidak dapat dikirim dalam pesan template hingga peringkat kualitasnya membaik atau tidak lagi melanggar kebijakan bisnis atau perdagangan kami.

Pembuatan

Gunakan API Pengelolaan Bisnis untuk membuat templat. Lihat Membuat dan Mengelola Template untuk mempelajari caranya. Atau, Anda dapat menggunakan Pengelola WhatsApp untuk membuat template secara manual.

Proses Persetujuan

Setelah Anda membuat template Anda, Anda dapat mengirimkannya agar mendapatkan persetujuan. Butuh waktu hingga 24 jam sampai keputusan persetujuan dibuat. Setelah keputusan dibuat, notifikasi akan muncul di Pengelola WhatsApp Anda dan kami akan mengirimkan email ke admin Pengelola Bisnis Anda. Selain itu, kami akan mengirimkan notifikasi Webhooks jika Anda berlangganan perubahan status template pesan. Lihat Memantau Perubahan Status.

Jika template pesan Anda disetujui, statusnya akan diatur ke Aktif - Kualitas tertunda dan Anda dapat mulai mengirimkannya kepada pelanggan. Jika ditolak, Anda dapat mengeditnya dan mengajukan ulang agar disetujui, atau mengajukan permintaan banding keputusan.

Contoh

Jika template Anda menggunakan variabel, Anda harus menyertakan contoh nilai variabel (aset media, string teks, dsb.) bersama pengajuan Anda. Hal ini memudahkan kami untuk memvisualisasikan bagaimana template Anda akan ditampilkan kepada pelanggan.

Untuk menyertakan contoh bersama pengajuan Anda di Pengelola WhatsApp, pertama-tama buat template, tambahkan variabel apa pun yang dibutuhkan, lalu klik tombol Tambahkan Contoh. Panel pratinjau akan me-render contoh aset media atau contoh nilai teks yang Anda berikan.


Jika menggunakan API kami untuk membuat template, sertakan properti examples untuk setiap objek komponen template dalam permintaan Anda yang menggunakan variabel.

Alasan Umum Penolakan

Pengajuan biasanya ditolak karena alasan berikut, jadi pastikan Anda menghindari kesalahan ini.

  • Parameter variabel tidak ada atau memiliki kurung kurawal yang tidak cocok. Format yang benar adalah {{1}}.
  • Parameter variabel berisi karakter khusus seperti #, $, atau %.
  • Parameter variabel tidak berurutan. Contoh: {{1}}, {{2}}, {{4}}, {{5}} didefinisikan tetapi {{3}} tidak ada.
  • Template berisi terlalu banyak parameter variabel yang relatif terhadap durasi pesan. Anda perlu mengurangi jumlah parameter variabel atau meningkatkan durasi pesan.
  • Template pesan tidak dapat diakhiri dengan parameter.
  • Template pesan berisi konten yang melanggar Kebijakan Perdagangan WhatsApp: Jika Anda menawarkan barang atau jasa untuk dijual, kami menganggap semua pesan dan media yang terkait dengan barang dan jasa Anda, termasuk deskripsi, harga, biaya, pajak, dan/atau pengungkapan hukum yang diwajibkan, sebagai transaksi. Transaksi harus sesuai dengan Kebijakan Perdagangan WhatsApp.
  • Template pesan berisi konten yang melanggar Kebijakan WhatsApps Business: Jangan meminta pengidentifikasi sensitif dari pengguna. Contoh: jangan meminta orang untuk membagikan nomor kartu pembayaran perorangan, nomor rekening keuangan, KTP, atau pengidentifikasi sensitif lainnya secara lengkap. Ini juga termasuk tidak meminta dokumen dari pengguna yang mungkin berisi pengidentifikasi sensitif. Meminta pengidentifikasi parsial (misalnya: 4 digit terakhir dari nomor jaminan sosial mereka) tidak masalah.
  • Konten tersebut berisi konten yang berpotensi mengganggu atau mengancam, seperti mengancam pelanggan dengan tindakan hukum atau mengancam akan mempermalukan mereka secara publik.
  • Template pesan adalah duplikat dari template yang sudah ada. Jika template dikirim dengan kata-kata yang sama di bagian isi dan catatan kaki dari template yang ada, template duplikat akan ditolak.

Notifikasi penolakan yang menyertakan alasan penolakan akan tampil di Beranda Dukungan Bisnis. Anda dapat melihat penolakan di Beranda Dukungan Bisnis dengan membuka Gambaran Umum Akun > (tombol) Lihat akun saya > (Akun Meta Business Anda) > (WABA Anda) > Template pesan yang ditolak. Info penolakan juga akan dikirim melalui email.

Anda dapat merujuk ke notifikasi Beranda Dukungan Bisnis untuk melihat nama dan bahasa dari template yang ada dengan konten yang sama sebagai template duplikat yang ditolak. Anda juga dapat memilih untuk mengedit template dan mengirimkan ulang.

Pemeriksaan ini tidak berlaku untuk template yang dikategorikan sebagai AUTHENTICATION.

Pengeditan

Anda dapat mengedit template menggunakan endpoint Pengelola WhatsApp atauTemplate Pesan. Perhatikan bahwa jika Anda mengedit template pesan dan mengirimkannya kembali untuk mendapatkan persetujuan, statusnya akan diatur ke Dalam Tinjauan dan tidak dapat dikirim kepada pelanggan sampai statusnya telah diatur ke Aktif.

Mengirim Template

Setelah template disetujui, (status template akan diatur ke ACTIVE), Anda boleh mulai mengirimkannya kepada pelanggan. Untuk mengirim template menggunakan Cloud API, lihat Mengirim Pesan Template. Untuk mengirim template menggunakan API Lokal, lihat <Pesan Template.

Perhatikan bahwa status template pesan dapat berubah secara otomatis dari ACTIVE menjadi PAUSED atau DISABLED berdasarkan masukan dan interaksi pelanggan. Untuk alasan ini, kami merekomendasikan Anda memantau perubahan status dan mengambil tindakan yang sesuai setiap kali template pesan yang Anda andalkan menjadi, atau terancam menjadi, dijeda atau dinonaktifkan.

Status

Template dapat memiliki status berikut.

  • Ditinjau: Menunjukkan bahwa template masih dalam tinjauan. Proses ini bisa memakan waktu hingga 24 jam.
  • Ditolak: Template telah ditolak selama proses tinjauan kami atau melanggar satu atau beberapa kebijakan kami. Lihat Banding.
  • Aktif - Kualitas tertunda: Template pesan belum menerima masukan kualitas atau informasi tingkat keterbacaan pesan dari pelanggan. Template pesan dengan status ini dapat dikirim kepada pelanggan. Lihat Peringkat Kualitas.
  • Aktif - Kualitas Tinggi: Template telah menerima sedikit atau tidak ada masukan negatif dari pelanggan. Template pesan dengan status ini dapat dikirim kepada pelanggan. Lihat Peringkat Kualitas.
  • Aktif - Kualitas Sedang: Template telah menerima masukan negatif dari beberapa pelanggan, atau tingkat keterbacaan pesan rendah, tetapi mungkin akan segera dijeda atau dinonaktifkan. Template pesan dengan status ini dapat dikirim kepada pelanggan. Lihat Peringkat Kualitas.
  • Aktif - Kualitas Rendah: Template telah menerima masukan negatif dari beberapa pelanggan, atau tingkat keterbacaan pesan rendah. Template pesan dengan status ini dapat dikirim kepada pelanggan tetapi terancam dijeda atau dinonaktifkan segera, jadi kami merekomendasikan Anda untuk mengatasi masalah yang dilaporkan pelanggan. Lihat Peringkat Kualitas.
  • Dijeda: Template telah dijeda karena adanya masukan negatif yang berulang dari pelanggan, atau tingkat keterbacaan pesan rendah. Template pesan dengan status ini tidak dapat dikirim kepada pelanggan. Lihat Penjedaan Template.
  • Dinonaktifkan: Template telah dijeda karena masukan negatif berulang dari pelanggan. Template pesan dengan status ini tidak dapat dikirim kepada pelanggan.
  • Banding Diajukan: Menunjukkan permintaan banding telah diajukan. Lihat Banding.

Anda dapat melihat status template dengan membuka Pengelola WhatsApp> Ringkasan, arahkan mouse ke ikon koper (Fitur Akun) dan mengeklik Template pesan. Jika Anda memiliki beberapa akun WhatsApp Business, pilih akun yang status template-nya ingin Anda lihat dari daftar akun di menu pilihan di pojok kanan atas.

Pacing Template

Mulai tanggal 30 April 2024, pacing template berlaku untuk template marketing dan utilitas.

Pacing template adalah mekanisme yang memberikan waktu bagi pelanggan untuk menyediakan masukan awal pada template. Hal ini mengidentifikasi dan menjeda template yang telah menerima masukan atau interaksi yang buruk, sehingga memberi Anda cukup waktu untuk menyesuaikan kontennya sebelum dikirim ke pelanggan yang terlalu banyak, dengan demikian mengurangi kemungkinan masukan negatif yang berdampak pada bisnis Anda.

Pacing template valid untuk template marketing dan utilitas. Template yang baru dibuat, template dijeda yang tidak dijeda lagi, dan template yang mungkin telah dibuat sebelumnya tetapi tidak memiliki peringkat kualitas GREEN yang berpotensi mengalami pacing. Riwayat kualitas template — contoh, kualitas rendah yang menghasilkan jeda template — adalah salah satu alasan utama untuk pacing template dan Anda mungkin melihat template lain yang di-pacing.

Saat template di-pacing, pesan akan dikirim secara normal sampai ambang batas yang tidak ditentukan tercapai. Setelah batas ini tercapai, pesan berikutnya menggunakan template itu akan ditahan untuk memberikan cukup waktu bagi masukan pelanggan. Setelah kami menerima sinyal berkualitas baik, pesan berikutnya yang menggunakan template itu akan diskalakan ke seluruh pemirsa target. Jika kami menerima sinyal kualitas buruk, pesan berikutnya yang menggunakan template itu akan dibatalkan, sehingga memberi Anda kesempatan untuk menyesuaikan konten, penargetan, dll.

Pacing Template Utilitas

Template utilitas hanya mengalami pacing jika Anda telah menjeda template utilitas. Setelah template utilitas dijeda, template yang baru dibuat, template yang dijeda tetapi tidak dijeda lagi, dan template yang mungkin telah dibuat sebelumnya tetapi tidak memiliki peringkat kualitas HIJAU, berpotensi mengalami pacing selama 7 hari ke depan.

Perilaku API

Tanggapan segera dari endpoint pesan akan menunjukkan apakah pesan telah dikirim atau ditahan dengan properti message_status yang baru di objek messages. Tanggapan ini akan tersedia di semua versi API.

  • Cloud API akan selalu mencakup properti message_status yang akan memiliki nilai accepted untuk pesan yang diproses, dan held_for_quality_assessment untuk pesan yang ditahan. Pesan yang diterima akan memicu Webhooks sent dan delivered saat benar-benar dikirim (ini adalah perilaku yang sama yang ada sebelum melakukan pacing). Contoh tanggapan lengkap dapat ditemukan di dokumen Cloud API.
  • On-Premises API akan mencakup properti message_status dengan nilai ”Message has been held because quality assessment is pending” jika pesan ditahan. Pesan yang dikirim tidak akan menyertakan properti. Contoh tanggapan lengkap dapat ditemukan di <dokumen On-Premises API.

Jika masukan positif dan mengubah peringkat kualitas template menjadi berkualitas tinggi, pesan yang ditahan akan dirilis dan dikirim secara normal. message_template_quality_update akan mengirimkan pembaruan kualitas dan Webhooks messages akan mengirim pembaruan yang terkirim dan tersampaikan.

Jika masukannya negatif dan mengubah kualitas template menjadi berkualitas rendah:

  • status template akan diatur ke PAUSED
  • message_template_status_update akan dikirimkan dengan nilai eventpaused
  • Setiap pesan yang ditahan akan dilepaskan dan memicu Webhooks messages dengan "status":"failed" dan "code":"132015" (pengguna Cloud API) atau "code":"2061" (pengguna On-Premises API)
  • Webhooks message_template_quality_update akan terpicu dengan perubahan kualitas
  • Admin bisnis pemilik Akun WhatsApp Business akan diberitahu tentang pesan yang gagal melalui notifikasi Meta Business Suite, banner Pengelola WhatsApp, dan email

Lihat Menjeda Template untuk mempelajari cara berhenti menjeda template yang telah dijeda akibat pacing.

Perhatikan bahwa kami memiliki batasan internal untuk memastikan bahwa kami mengevaluasi dan membuat keputusan yang tepat dalam waktu yang wajar untuk menghindari dampak pada kampanye yang sensitif terhadap waktu. Tujuan kami adalah bahwa bahkan jika ada pacing, pesan kampanye dengan throughput tertinggi masih terkirim dalam waktu satu jam (persentil ke-99).

Jadi, jika batasan internal kita tercapai sebelum template menerima masukan yang cukup untuk mengubah kualitasnya menjadi tinggi atau rendah, pesan yang ditahan akan dirilis secara normal bersama dengan Webhooks messages yang sesuai.

Memantau Perubahan Status

Status template dapat berubah secara otomatis, berdasarkan keputusan tinjauan, hasil banding, atau perubahan pada peringkat kualitasnya. Ketika status template berubah, Anda akan diberi tahu dengan notifikasi Pengelola WhatsApp, email, dan notifikasi Webhooks.

Karena Anda hanya dapat mengirim template pesan kepada pelanggan dengan status Aktif, kami sangat merekomendasikan Anda untuk berlangganan kolom message_template_status_update webhook, yang akan memberi tahu Anda tentang perubahan status apa pun pada salah satu template Anda. Lihat Pengaturan Webhooks untuk mempelajari cara berlangganan kolom ini, dan Pembaruan Template Pesan untuk contoh muatan Webhooks.

Jika Anda telah mengatur Webhooks dan melihat bahwa template pesan yang diberikan menurun kualitasnya, buka Pengelola WhatsApp> Template pesan dan arahkan mouse ke template pesan yang dimaksud. Tooltip akan muncul dan menampilkan informasi tentang sifat masalahnya. Berdasarkan informasi ini, Anda mungkin ingin mengedit template dan mengajukannya untuk persetujuan ulang, menggunakan template yang berbeda, atau mengubah logika bisnis aplikasi Anda. Jika Anda mengedit template pesan dan disetujui ulang, peringkat kualitasnya akan meningkat secara bertahap selama template dikirim kepada pelanggan dan tidak sering menerima masukan negatif atau tingkat keterbacaan pesan rendah.

Peringkat Kualitas

Setiap template pesan memiliki peringkat kualitas berdasarkan penggunaan, masukan dan interaksi pelanggan. Peringkat template pesan akan muncul di Pengelola WhatsApp setiap kali template berstatus Aktif, dan akan ditampilkan setelah tanda hubung dalam status template pesan:

  • Aktif - Kualitas tertunda (disorot dengan warna hijau)
  • Aktif - Kualitas tinggi (disorot dengan warna hijau)
  • Aktif - Kualitas sedang (disorot dengan warna kuning)
  • Aktif - Kualitas rendah (disorot dengan warna merah)

Template pesan yang disetujui dimulai dengan peringkat Kualitas tertunda. Jika templat pesan terus menerima masukan negatif atau interaksi rendah, pada akhirnya, hal tersebut akan menyebabkan perubahan pada status template. Selama template pesan berstatus Aktif, terlepas dari peringkat kualitas, template dapat dikirim kepada pelanggan. Namun, begitu status template pesan berubah menjadi status lain, template tidak dapat dikirim kepada pelanggan sampai statusnya kembali aktif.

Anda dapat diberi tahu tentang perubahan peringkat kualitas template dengan berlangganan kolom message_template_quality_update.

Lihat Pembaruan Kualitas Template Pesan untuk contoh payload Webhooks.

Menjeda Template

Jika template mencapai peringkat kualitas terendah (berstatus Aktif - Kualitas rendah), template akan secara otomatis dijeda untuk jangka waktu tertentu guna melindungi peringkat kualitas nomor telepon yang telah menggunakan template. Durasi jeda adalah sebagai berikut:

  • Kejadian ke-1: Dijeda selama 3 jam
  • Kejadian ke-2: Dijeda selama 6 jam
  • Instance ke-3: Dinonaktifkan

Ketika template pesan dijeda (berstatus Dijeda), template tidak dapat dikirim kepada pelanggan, jadi Anda harus menghentikan kampanye pesan otomatis apa pun yang bergantung pada template tersebut. Meskipun Anda tidak akan dikenakan biaya karena mencoba mengirim template pesan yang dijeda kepada pelanggan, dan upaya tersebut tidak akan dihitung terhadap batas berkirim pesan Anda, API akan menolak upaya ini. Anda hanya boleh melanjutkan kampanye ini bila status template telah diatur menjadi Aktif lagi.

Anda mungkin ingin mengedit template yang dijeda jika Anda merasa bahwa mengedit kontennya akan mengurangi jumlah masukan negatif yang mungkin diterimanya dan meningkatkan interaksi pengguna. Perlu diingat, bagaimanapun, bahwa begitu Anda mengedit template pesan dan mengajukan ulang untuk mendapatkan persetujuan, statusnya akan berubah menjadi Sedang Ditinjau dan tidak dapat dikirim kepada pelanggan lagi sampai template disetujui ulang dan statusnya diatur menjadi Aktif.

Anda mungkin juga ingin membuat perubahan pada logika bisnis Anda (penargetan, parameter penayangan, dsb.) jika Anda merasa itu berkontribusi terhadap masukan negatif atau interaksi rendah.

Menjeda pada awalnya tidak akan memengaruhi nomor telepon bisnis yang menjadi asal pengiriman template, atau menyebabkan batas pesan nomor telepon menurun. Template pesan berkualitas tinggi lainnya dapat terus dikirim dari nomor telepon tersebut. Namun, jika bisnis secara konsisten mengirimkan template pesan yang mencapai status Kualitas rendah, nomor telepon pada akhirnya akan terpengaruh.

Notifikasi Jeda

Ketika template pesan telah dijeda, kami akan memberi tahu Anda melalui notifikasi Pengelola WhatsApp, email, dan Webhooks jika Anda berlangganan Webhooks perubahan template pesan. Lihat Memantau Perubahan Status untuk informasi pengaturan Webhooks dan Contoh - Template Dijeda untuk contoh payload Webhooks.

Membatalkan jeda

Jeda template akan batal dengan sendirinya setelah memenuhi durasi jeda yang dijelaskan di atas. Setelah tidak dijeda, status template akan diatur ke Aktif dan Anda dapat mulai mengirimkannya kepada pelanggan lagi. Jika Anda tidak menghentikan kampanye berkirim pesan otomatis apa pun yang mengandalkan template yang dijeda, kampanye tersebut akan mulai berfungsi kembali. Namun, kami merekomendasikan Anda untuk menghentikan kampanye apa pun yang mengandalkan template yang telah dijeda sampai template tidak dijeda lagi, karena API kami tetap akan menolak permintaan Anda.

Peringkat kualitas template juga akan direset ke nilai berdasarkan masukan pelanggan terbaru yang telah diterima template.

Serupa dengan notifikasi jeda, kami akan memberi tahu Anda melalui notifikasi Pengelola WhatsApp, email, dan Webhooks setelah status template telah diatur ke Aktif.

Berlaku untuk bisnis di Brasil, Kolombia, dan Singapura, mulai 12 September 2023. Berlaku untuk semua bisnis mulai 12 Oktober 2023.

Dengan diperkenalkannya Pacing Template, kami juga memperkenalkan kemampuan untuk berhenti menjeda template yang dijeda melalui:

  • API dengan membuat permintaan POST ke /{whats_app_message_template_id}/unpause.
  • Pengelola WhatsApp dengan mengeklik tautan 'batalkan jeda secara manual' yang disorot dalam tangkapan layar di bawah ini.

Perhatikan bahwa template yang dijeda selama Pacing Template harus dibatalkan jedanya secara manual (API atau Pengelola WhatsApp) sebelum dapat digunakan kembali.

Pengajuan Banding

Jika pengajuan Anda ditolak, Anda dapat mengajukan banding. Harap diperhatikan bahwa banding harus menyertakan contoh. Jika template yang disetujui telah dinonaktifkan, Anda juga dapat mengeditnya dan mengajukan ulang untuk mendapatkan persetujuan.

Di Pengelola WhatsApp:

  1. Arahkan mouse ke ikon koper (Fitur akun) dan klik Template pesan.
  2. Jika Anda memiliki beberapa Akun WhatsApp Business, gunakan menu pilihan di pojok kanan atas untuk memilih akun yang template-nya ingin dikelola.
  3. Temukan template pesan yang ingin Anda edit, lalu klik.
  4. Edit konten template.
  5. Klik tombol Tambahkan Contoh dan tambahkan contoh nilai variabel dan gambar.
  6. Klik Kirim.

Banding akan ditinjau dan keputusan dibuat dalam 24 jam.

Pelajari Selengkapnya