Membuat template WhatsApp
Buat template di WhatsApp Business Account yang sudah terhubung agar Anda dapat mengirim pesan dengan kata-kata Anda sendiri. Ringkasan ini membahas draf, bahasa, pengajuan, dan peninjauan. Pilih kategori untuk panduan pembuatannya:
- Authentication: kode verifikasi dengan teks bawaan Meta dan tombol salin kode.
- Utility: pembaruan pesanan, pengingat janji temu, dan pemberitahuan akun.
- Marketing: pesan promosi, carousel, dan harga maksimum.
Untuk menelusuri dan mengirim template yang sudah ada, lihat Template WhatsApp.
Tiga hal membentuk keseluruhan alur:
- Sebuah template menyimpan versi, dan sebuah versi menyimpan satu entri per bahasa. Setiap pengiriman menggunakan bahasa yang disetujui dari sebuah versi.
- Konten ditulis ke draf. Sebuah template memiliki paling banyak satu draf terbuka, dan tidak ada isinya yang sampai ke WhatsApp sampai Anda mengajukannya.
- Persetujuan diberikan per bahasa. Satu bahasa bisa disetujui sementara bahasa lain pada versi yang sama ditolak.
Sebelum Anda mulai
Anda memerlukan nomor milik sendiri yang sudah terhubung, karena itulah yang memberikan workspace Anda WhatsApp Business Account untuk menulis template. Akun yang belum Anda hubungkan akan ditolak, begitu juga mengedit template bird_ bawaan Bird: template tersebut berada di akun milik Bird, jadi duplikasikan ke akun Anda sebagai gantinya.
Membuat template authentication juga memerlukan bisnis terverifikasi; utility dan marketing tidak. Lihat Authentication templates untuk persyaratan tersebut.
Buat template di halaman Approved templates, dengan bird CLI, atau melalui server MCP.
Di dashboard
New template menawarkan dua cara. Start with a template membuka galeri, rute tercepat: pilih template yang sudah hampir sesuai kebutuhan Anda, termasuk milik Bird, dan salinannya masuk ke akun Anda sebagai draf terbuka.

Start from scratch meminta kategori, nama, dan bahasa default sebelum membuka editor. Untuk template pemasaran, Anda juga memilih jenis pesan. Nama menjadi slug. Anda dapat mengubah slug di Settings hingga pengajuan pertama; kategori ditetapkan saat template dibuat.

Editor menulis satu bahasa pada satu waktu. Daftar bahasanya menampilkan status peninjauan setiap bahasa, dan pratinjau ponsel merender konten Anda dengan nilai contoh. Ikuti panduan authentication, utility, atau marketing untuk kontrol yang tersedia bagi kategori Anda.
Save as draft menyimpan pekerjaan Anda tanpa menghubungi WhatsApp. Submit for review menetapkan versi dan mengirimkannya ke WhatsApp.
Dua cara untuk memulai
Duplikasi template yang sudah ada
Duplikasi membawa konten sumber sebagai draf terbuka dan tidak memanggil WhatsApp sama sekali, jadi tidak ada yang diajukan sampai Anda memilih untuk melakukannya. Dua hal tentang salinan yang perlu Anda ketahui sebelum membuatnya:
- Kategori diwariskan dan tidak bisa diubah. Jika Anda memerlukan kategori berbeda, mulai dari awal.
- Anda bisa mempersempit bahasa, tidak bisa menambahkannya. Template katalog dengan 70 bahasa tidak harus menjadi 70 bahasa milik Anda: pilih subset yang benar-benar akan Anda kelola. Meminta bahasa yang tidak dimiliki sumber ditolak dengan
E15060, dan respons menyebutkan bahasa mana yang tidak cocok. Tambahkan bahasa lain ke salinan setelahnya.
Mulai dari awal
Kategori ditetapkan saat pembuatan; slug ditetapkan setelah pengajuan pertama. Sebelum mengajukan, Anda dapat memperbaiki slug di Settings. WhatsApp menentukan nama templatenya dari slug. Untuk mengubah slug setelah pengajuan atau menggunakan kategori lain, buat template baru. Awalan bird_ dikhususkan untuk katalog Bird. Kategori pilihan Anda belum tentu menentukan harga pengiriman: Meta menerapkan kategorinya sendiri per bahasa dan dapat mengubahnya, dan harga mengikuti kategori Meta.
Menulis setiap bahasa
Setiap variabel memerlukan nilai contoh. Meta meninjau pesan dengan nilai-nilai tersebut sudah terisi. Contoh yang hilang menghalangi pengajuan. Sediakan sendiri teks dan contoh untuk setiap bahasa; Meta tidak menerjemahkannya. Lihat dasar-dasar template Meta.
Untuk bahasa marketing, tetapkan harga maksimum di editor atau dengan optimization_spec. Panduan marketing membahas satuan harga, penggantian per negara, estimasi, dan pengali per pesan.
Tetapkan berapa lama WhatsApp mencoba lagi pengiriman pesan. WhatsApp mencoba lagi pesan yang tidak dapat dikirimkan selama time to live bahasa tersebut, lalu membuangnya. Pilih durasi di Time to live, atau pilih opsi default: Default · 10 min untuk authentication, atau Default · 30 days untuk utility dan marketing. Batas ini mulai berjalan setelah kami menyerahkan pesan ke Meta. Melalui API, tetapkan message_send_ttl_seconds dalam detik, kirim null untuk kembali ke default, atau hilangkan kolom tersebut untuk mempertahankan nilai saat ini. Rentangnya bergantung pada kategori:
| Kategori | Rentang |
|---|---|
| Authentication | 30 detik–15 menit |
| Utility | 30 detik–12 jam |
| Marketing | 12 jam–14 hari |
Perubahan yang hanya menyangkut time to live tidak memerlukan peninjauan baru. Pada template marketing, pengaturan ini berlaku selama akun bisnis terdaftar di Marketing Messages.
Periksa, lalu ajukan
Periksa konten dan contoh variabel untuk setiap bahasa, lalu pilih Submit for review untuk mengirim draf tersimpan ke Meta. Perbaiki kesalahan validasi sebelum mengirim.
Hanya bahasa yang kontennya berbeda dari salinan yang disetujui yang memerlukan peninjauan konten. Untuk bahasa yang sudah cocok, persetujuan sebelumnya tetap berlaku. Perubahan harga marketing diterapkan secara terpisah. Pengajuan tanpa perubahan konten maupun harga langsung selesai tanpa perlu polling. Tidak ada draf pengganti yang terbuka setelahnya: putaran edit berikutnya dimulai dengan membuat draf lagi.
Memantau peninjauan
Persetujuan datang kemudian dan per bahasa. pending_version_id template tetap aktif selama ada bahasa yang belum terselesaikan, dan daftar per bahasa membawa setiap keputusan:
- Bahasa berstatus
approveddapat digunakan untuk mengirim pesan.available_languagespada template memuat tepat daftar bahasa yang dapat dipilih untuk pengiriman saat ini. - Bahasa berstatus
rejectedatausubmit_failedmemerlukan perhatian pada kesalahan bahasa tersebut sebelum Anda coba lagi. Perbaiki konten pada draf baru jika diperlukan. - Bahasa berstatus
pausedtidak dapat digunakan untuk mengirim. Tinjau konten dan audiensnya; Meta dapat melanjutkan jeda sementara. Anda juga dapat mengedit dan mengajukan ulang bahasa yang dijeda. Lihat panduan penjedaan template Meta. disabled,limit_exceeded,in_appealtidak dapat diedit. Periksa kesalahan bahasa tersebut dan ikuti tindakan yang ditampilkan Meta di WhatsApp Manager. Jika banding sedang diproses, periksa statusnya untuk mengetahui keputusan.
status template itu sendiri adalah agregat: active berarti setidaknya satu bahasa bisa dikirim, bukan semuanya.
Mengirim template yang Anda buat
Template yang Anda buat dikirim melalui endpoint yang sama seperti template lainnya, dengan satu perbedaan dari katalog Bird: Anda harus menyebutkan from, dan nomor tersebut harus berada di WhatsApp Business Account yang sama dengan template. Pengirim di akun berbeda ditolak 422 E15023 sebelum ada biaya yang dikenakan.
Sebuah template bisa mewajibkan bahasa penerima melalui language_source_required. Jika tidak, on_missing_language mengontrol apakah resolusi gagal atau bisa menggunakan bahasa dasar yang disetujui atau default_language. Uji kebijakan yang dikonfigurasi terhadap available_languages yang disetujui pada template; default yang belum disetujui tidak bisa dikirim. Nilai yang Anda berikan harus mengisi placeholder bahasa mana pun yang benar-benar ter-resolve, jadi baca konten bahasa tersebut sebelum mengirim. Lihat Mengirim pesan WhatsApp untuk payload lengkapnya.
Hal-hal yang perlu diperhatikan
- Periksa versi aktif sebelum mengirim. Daftar versi diurutkan dari yang terbaru dan menyertakan draf terbuka, jadi baris teratas sering kali berupa draf atau versi yang masih dalam peninjauan. Template menyebutkan versi yang aktif sebagai
live_version_id; template tanpa versi aktif sama sekali tidak bisa dikirim. - Bahasa yang sedang ditinjau menolak penulisan. WhatsApp menahannya sampai peninjauan selesai, jadi edit selama
pendinggagal alih-alih diantrikan. - Baris daftar tidak memuat konten. Listing template menemukan template dan menampilkan status siklus hidupnya; membaca isi sebenarnya memerlukan pembacaan versi.
- Penghapusan tidak bisa dibatalkan. Membuang bahasa, menghapus draf, dan menghapus template semuanya memerlukan konfirmasi eksplisit, dan menghapus template menghentikan semua pengiriman dengan slug tersebut.
Langkah berikutnya
- Template WhatsApp: katalog, kategori, dan kontrak pengiriman berbasis template bersama
- Pedoman template: hal yang dicari peninjauan Meta
- Mengirim pesan WhatsApp: payload pengiriman lengkap
- API template: membuat template secara terprogram
- Membuat dan mengirimkan template WhatsApp: video yang membuat template utility dan carousel marketing
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.