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);msg = client.whatsapp.send(
to="+14155550100",
template="bird_otp",
language="en",
parameters={"code": "481920"},
)
print(msg.id, msg.status)package main
import (
"context"
"fmt"
"log"
"os"
bird "github.com/messagebird/bird-sdk-go"
"github.com/messagebird/bird-sdk-go/option"
)
func main() {
client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
if err != nil {
log.Fatal(err)
}
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+14155550100",
Template: "bird_otp",
Language: "en",
Parameters: map[string]any{"code": "481920"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+14155550100',
template: 'bird_otp',
language: 'en',
parameters: ['code' => '481920'],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--language en \
--parameters '{"code":"481920"}' \
--template bird_otp \
--to +14155550100curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+14155550100",
"template": {
"slug": "bird_otp",
"language": "en",
"parameters": {
"code": "481920"
}
}
}'Empat aturan berlaku khusus untuk kategori ini:
- Hilangkan
from. Template yang dikelola Bird memilih pengirimnya sendiri berdasarkan kategori dan wilayah, sehingga menetapkanfromakan menghasilkan422E15018WhatsAppSenderNotAllowed. Ini kebalikan dari pengiriman bebas format, yang mewajibkanfrom. Perhatikan perbedaan ini jika Anda datang dari halaman pesan interaktif. toharus berupa nomor telepon E.164. Template autentikasi tidak dapat dikirim ke ID pengguna yang terikat pada bisnis; pengiriman seperti itu menghasilkan422E15014WhatsAppRecipientNotSupportedForTemplate.- Kode dimasukkan ke
parameters.code. Kode ini mengisi placeholder di isi pesan dan tombol salin kode. Sebaliknya, pengirimancomponentsmenerima tepat satu parameter isi posisional, yaitu kode tersebut. Tanpa parameter, atau dengan parameter bernama, pengiriman menghasilkan422E15003WhatsAppTemplateParameterMismatch. - 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:
{ "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_otpdanbird_otp_authiflydikirim 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 ditolak422E15063WhatsAppDestinationRestrictedsebelum 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 ditolak422E15023WhatsAppSenderWABAMismatchsebelum 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
422E15024WhatsAppTemplateContentNotDuplicable. Sebagai gantinya, buat template baru dengan rekomendasi keamanan dan masa kedaluwarsa kodenya sendiri.
Langkah berikutnya
- Template WhatsApp: menjelajahi katalog dan kontrak bersama untuk pengiriman berbasis template
- Template utilitas: pembaruan pesanan, pengingat janji temu, dan pemberitahuan akun
- Verifikasi bisnis WhatsApp: cara kerja verifikasi dan fitur lain yang dibukanya
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.