# Template utility WhatsApp Template utility menindaklanjuti sesuatu yang sudah dilakukan penerima: pesanan, pembayaran, reservasi, atau proses masuk. Katalog Bird menyediakan delapan template, termasuk `bird_signin_alert` dan `bird_delivery_update`. Ambil kategori slug dari daftar template, bukan dari namanya: `bird_signin_alert` terlihat seperti template authentication padahal bukan, itu utility. ## Sebelum Anda mengirim Pilih template dari katalog terkelola atau buat sendiri di akun bisnis Anda yang terhubung. Mengirim template katalog bawaan Bird tidak memerlukan verifikasi dari Anda, sama seperti authentication. Membuat template utility Anda sendiri juga tidak memerlukannya: tidak seperti authentication, persyaratan verifikasi bisnis Meta tidak pernah berlaku untuk utility, jadi Anda dapat membuat dan mengedit template utility di workspace yang belum diverifikasi. Lihat [Verifikasi bisnis WhatsApp](/docs/knowledge-base/whatsapp/business-verification) untuk mengetahui apa saja yang dibuka oleh verifikasi di tempat lain. `to` dapat berupa nomor telepon E.164 atau ID pengguna cakupan bisnis. Template utility tidak membawa tombol OTP, jadi tidak memerlukan penerima khusus nomor telepon seperti authentication. Setiap template utility katalog terkelola didaftarkan hanya dalam `en`, dengan `on_missing_language: fail`. Meminta bahasa yang tidak tersedia di katalog akan menggagalkan pengiriman, bukan beralih ke bahasa Inggris atau bahasa lain. ## Mengirim template utility `POST /v1/whatsapp/messages` dengan objek `template` yang menentukan slug katalog: **TypeScript** ```typescript const msg = await bird.whatsapp.send({ to: "+16505551234", template: { slug: "bird_order_confirmation", language: "en", components: [ { type: "body", parameters: [ { type: "text", name: "ref", text: "A1B2C3D4" }, { type: "text", name: "amount", text: "USD 49.99" }, ], }, ], }, }); console.log(msg.id, msg.status); ``` Examples: [TypeScript](/id-id/dokumentasi/guides/whatsapp/templates/utility.ts.md) · [Python](/id-id/dokumentasi/guides/whatsapp/templates/utility.py.md) · [Go](/id-id/dokumentasi/guides/whatsapp/templates/utility.go.md) · [PHP](/id-id/dokumentasi/guides/whatsapp/templates/utility.php.md) · [CLI](/id-id/dokumentasi/guides/whatsapp/templates/utility.cli.md) · [MCP](/id-id/dokumentasi/guides/whatsapp/templates/utility.mcp.md) · [cURL](/id-id/dokumentasi/guides/whatsapp/templates/utility.curl.md) Seperti template terkelola lainnya, jangan sertakan `from`: Bird memilih nomor pengirim berdasarkan kategori dan wilayah, dan mengisinya akan mengembalikan `422` [`E15018`](/docs/api/errors/E15018) `WhatsAppSenderNotAllowed`. Pembuatan dan pengiriman template utility sendiri mengikuti mekanisme yang sama dengan pengiriman template buatan sendiri lainnya; lihat [Mengirim dengan template](/docs/guides/whatsapp/templates#sending-with-a-template) untuk kontrak umumnya. ## Mengisi variabel Parameter utility bersifat bernama, kebalikan dari kode posisional tunggal milik authentication. Setiap parameter membawa `name`, dan urutan parameter bernama di dalam array tidak memiliki arti. Kirim satu entri `components` untuk setiap blok yang benar-benar memiliki placeholder; body tanpa variabel tidak memerlukan entri `components` sama sekali. Tombol URL adalah satu-satunya pengecualian: variabelnya selalu posisional `{{1}}`, dan pengiriman membawa nilai mentah, bukan alamat lengkap: ```json { "type": "button", "parameters": [{ "type": "text", "text": "A-4192" }] } ``` Untuk aturan bersama tentang komponen, `sub_type`, dan bagaimana `components` pengiriman disejajarkan dengan placeholder yang dideklarasikan template, lihat [Mengirim dengan template](/docs/guides/whatsapp/templates#sending-with-a-template) dan [Komponen dan parameter](/docs/guides/whatsapp/sending-whatsapp#components-and-parameters). ## Biaya Template utilitas yang tersampaikan ke penerima dalam jendela layanan pelanggan yang masih terbuka dapat memenuhi syarat tarif gratis Meta. Biaya pengiriman Bird dikenakan saat pemrosesan pesan, sebelum pesan diteruskan ke Meta. Callback pesan tersampaikan atau dibaca yang datang kemudian menentukan apakah biaya Meta berlaku. Periksa kedua komponen saat memperkirakan total biaya. Lihat [Biaya dan penagihan](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) untuk kapan pengiriman dikenakan biaya, dan [Harga WhatsApp](/products/whatsapp/pricing) untuk tarifnya. ## Hal yang perlu diperhatikan - **Meta dapat mengkategorikan ulang template utility menjadi marketing atas inisiatifnya sendiri**, dan pesan tetap terkirim dengan harga baru yang lebih tinggi. Bisnis yang sudah pernah diperingatkan Meta karena kesalahan kategorisasi tidak mendapat pemberitahuan terlebih dahulu sejak April 2025; perubahan langsung berlaku. Jauhkan bahasa promosi, penawaran, atau upsell dari teks template utility Anda, karena itulah yang memicu perpindahan tersebut. Lihat [Panduan template](/docs/knowledge-base/whatsapp/template-guidelines) untuk mengetahui apa yang dianggap promosi. - **Header `gif` atau tombol `copy_code` ditolak di luar marketing.** Keduanya adalah komponen khusus marketing; mendeklarasikan salah satunya pada template utility akan gagal. - **Pengiriman dengan template buatan sendiri tidak diperiksa jumlah parameternya sebelum dikenakan biaya.** Kirim jumlah parameter yang salah pada template buatan Anda sendiri dan permintaan pengiriman diterima serta dikenakan biaya, lalu ditolak oleh Meta. Pengiriman katalog terkelola tidak memiliki celah ini. - **Pengirim di WhatsApp Business Account yang salah ditolak sebelum biaya apa pun.** `from` harus berada di akun yang sama dengan template; jika tidak, pengiriman gagal `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch`. ## Langkah selanjutnya - [Template WhatsApp](/docs/guides/whatsapp/templates): menelusuri katalog dan ketentuan umum pengiriman menggunakan template - [Template autentikasi](/docs/guides/whatsapp/templates/authentication): kode verifikasi sekali pakai dan persyaratan verifikasi untuk membuatnya - [Template marketing](/docs/guides/whatsapp/templates/marketing): pengiriman promosi dan akun yang Anda butuhkan untuk membuatnya ## Related resources - [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video) - [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer) - [WhatsApp message builder](/tools/whatsapp-message-builder) (tool) - [WhatsApp](/products/whatsapp) (product) [Get an implementation brief](/learn/workspace?topic=whatsapp)