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.
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.
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.
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.
Pengajuan biasanya ditolak karena alasan berikut, jadi pastikan Anda menghindari kesalahan ini.
{{1}}
.#
, $
, atau %
.{{1}}
, {{2}}
, {{4}}
, {{5}}
didefinisikan tetapi {{3}}
tidak ada.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
.
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.
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.
Template dapat memiliki status berikut.
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.
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.
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.
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.
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.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
messages
dengan "status":"failed"
dan "code":"132015"
(pengguna Cloud API) atau "code":"2061"
(pengguna On-Premises API)message_template_quality_update
akan terpicu dengan perubahan kualitasLihat 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.
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.
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:
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.
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:
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.
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.
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:
/{whats_app_message_template_id}/unpause
. Perhatikan bahwa template yang dijeda selama Pacing Template harus dibatalkan jedanya secara manual (API atau Pengelola WhatsApp) sebelum dapat digunakan kembali.
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:
Banding akan ditinjau dan keputusan dibuat dalam 24 jam.