Sign inGet Started

Template autentikasi WhatsApp

Template autentikasi mengirimkan kode verifikasi sekali pakai. Meta menyediakan teksnya saat Anda membuat template. Saat mengirimnya, berikan kode sebagai parameter body.

Sebelum mengirim

Pilih apakah akan menggunakan template yang dikelola Bird atau membuat template di akun bisnis Anda sendiri.

Mengirim template katalog siap pakai dari Bird, yaitu bird_otp dan bird_otp_authifly, tidak memerlukan verifikasi dari Anda. Template tersebut berada di WhatsApp Business Account milik Bird sendiri, dan jalur pengiriman terkelola tidak pernah memeriksa status verifikasi bisnis Anda.

Jika akun bisnis yang terhubung melaporkan not_verified, Bird menolak pembuatan atau duplikasi template autentikasi dengan 412 E15043 WhatsAppTemplateBusinessNotVerified. Periksa akun yang terhubung dan status sinkronisasi terbarunya. Lihat verifikasi bisnis WhatsApp untuk proses verifikasi dan penanganan status.

Syarat ini tidak memengaruhi pembuatan template utilitas dan pemasaran; Anda tetap dapat membuat dan mengedit template tersebut apa pun status verifikasi Anda.

Buat template di dashboard, dengan bird CLI, atau melalui server MCP. Lihat Membuat template autentikasi untuk alur lengkapnya.

Mengirim kode verifikasi

POST /v1/whatsapp/messages dengan objek template yang menyebutkan slug katalog:

const msg = await bird.whatsapp.send({
  to: "+14155550100",
  template: {
    slug: "bird_otp",
    language: "en",
    parameters: { code: "481920" },
  },
});
console.log(msg.id, msg.status);

Empat aturan berlaku khusus untuk kategori ini:

  • Hilangkan from. Template yang dikelola Bird memilih pengirimnya sendiri berdasarkan kategori dan wilayah, sehingga menetapkan from akan menghasilkan 422 E15018 WhatsAppSenderNotAllowed. Ini kebalikan dari pengiriman bebas format, yang mewajibkan from. Perhatikan perbedaan ini jika Anda datang dari halaman pesan interaktif.
  • to harus berupa nomor telepon E.164. Template autentikasi tidak dapat dikirim ke ID pengguna yang terikat pada bisnis; pengiriman seperti itu menghasilkan 422 E15014 WhatsAppRecipientNotSupportedForTemplate.
  • Kode dimasukkan ke parameters.code. Kode ini mengisi placeholder di isi pesan dan tombol salin kode. Sebaliknya, pengiriman components menerima tepat satu parameter isi posisional, yaitu kode tersebut. Tanpa parameter, atau dengan parameter bernama, pengiriman menghasilkan 422 E15003 WhatsAppTemplateParameterMismatch.
  • Jendela layanan pelanggan tidak diperlukan. Pengiriman template tidak dibatasi jendela layanan. Karena itulah template kode verifikasi ada: template ini harus menjangkau orang yang belum pernah mengirim pesan kepada Anda.

Baca bahasa yang tersedia untuk bird_otp atau bird_otp_authifly dari katalog template. Jika bahasa yang Anda minta tidak tersedia, pengiriman gagal dan tidak diganti dengan bahasa lain.

Tombol salin kode

Meta menulis sendiri isi template autentikasi sebagai preset dengan satu placeholder kode, jadi Anda memberikan flag, bukan teks. Pengiriman parameters mengisi tombol dari code. Pada pengiriman components, komponen tombol bersifat opsional: jika Anda tidak menyertakannya, Bird menambahkannya untuk Anda dengan kode yang sama seperti di isi pesan. Anda juga dapat menyertakannya sendiri:

Contoh kode
{ "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }

Dalam kedua cara, tepat satu tombol sampai ke WhatsApp, yaitu tombol salin kode: mengetuknya menyalin kode ke papan klip. Bird hanya mendukung copy_code. Dua perilaku tombol lain yang didokumentasikan Meta untuk template autentikasi, yaitu isi otomatis sekali ketuk dan tanpa ketuk, tidak tersedia di Bird.

Pembuatan tombol template mengikuti bentuk yang sama: satu tombol otp, dan template tidak menerima jenis tombol lain. Alih-alih menulis teks, Anda memberikan add_security_recommendation (boolean yang ditampilkan di isi pesan) dan code_expiration_minutes (1 hingga 90, ditampilkan di footer).

Yang diizinkan Meta dalam template autentikasi

Meta menetapkan struktur template autentikasi dan meninjau isinya: tidak boleh ada URL, media, atau emoji di bagian mana pun template, dan parameter kode dibatasi 15 karakter. Kategori ini juga mengubah cara WhatsApp mengirimkan pesan, yaitu hanya ke perangkat utama penerima. Lihat Pedoman template untuk struktur tetap, batas karakter, dan proses peninjauan selengkapnya.

Biaya

Harga ditentukan oleh kategori dan negara tujuan. Lihat tarif autentikasi internasional WhatsApp untuk mengetahui bagaimana pengiriman ke negara selain lokasi utama Anda dapat mengubah harga, dan Biaya dan penagihan untuk mengetahui kapan pengiriman dikenai biaya. Angka tarif tercantum di harga WhatsApp.

Hal yang perlu diperhatikan

  • Template stok Bird tidak terkirim ke sembilan negara. bird_otp dan bird_otp_authifly dikirim dari WhatsApp Business Account milik Bird sendiri, dan akun tersebut tidak mengirimkan pesan autentikasi ke Mesir, India, Indonesia, Malaysia, Nigeria, Pakistan, Arab Saudi, Afrika Selatan, atau Uni Emirat Arab. Pengiriman seperti itu ditolak 422 E15063 WhatsAppDestinationRestricted sebelum ada biaya yang dikenakan. Template yang Anda buat di akun Anda sendiri dan dikirim dari nomor Anda sendiri menjangkau negara-negara ini secara normal. Verify juga menjangkaunya dengan memindahkan kode verifikasi ke kanal lain secara otomatis.
  • Pengiriman template buatan Anda memerlukan from, dan pengirim tersebut harus berada di WhatsApp Business Account yang sama dengan template. Pengirim di akun lain ditolak 422 E15023 WhatsAppSenderWABAMismatch sebelum ada biaya yang dikenakan.
  • Hanya bahasa yang versinya sudah disetujui dan aktif yang dapat dikirim. Bahasa berstatus draf, tertunda, ditolak, atau dijeda tidak dapat dikirim.
  • Meta dapat mengubah kategori template atas inisiatifnya sendiri. Anda tidak dapat menolaknya, dan perubahan ini ikut mengubah aturan harga dan pengiriman yang mengikuti kategori.
  • Kategori template dan kategori bahasanya bisa berbeda. Lihat template WhatsApp untuk mengetahui cara jalur pengiriman menyelesaikan perbedaan ini.
  • Template autentikasi yang diimpor tidak dapat diduplikasi. Bird tidak dapat membaca kembali salinan yang dibuat oleh WhatsApp menjadi pengaturan dasar untuk template baru; hal ini menghasilkan 422 E15024 WhatsAppTemplateContentNotDuplicable. Sebagai gantinya, buat template baru dengan rekomendasi keamanan dan masa kedaluwarsa kodenya sendiri.

Langkah berikutnya