Template Pesan

Template pesan diperlukan untuk memulai percakapan marketing, utilitas, dan autentikasi. Percakapan ini bisa berupa pesan layanan pelanggan atau pengingat janji temu, pembaruan pembayaran atau pengiriman, pemberitahuan, dan banyak lagi.

Persyaratan

• Template pesan harus disetujui sebelum dapat digunakan untuk memulai percakapan. Pelajari selengkapnya.
• Untuk membuka percakapan marketing, utilitas, dan autentikasi dengan pelanggan, pelanggan harus telah ikut serta bersedia menerima pesan dari bisnis Anda. Pelajari selengkapnya.

Kategori Template yang Didukung

Lihat Kategori.

Terjemahan

Saat mengirim template pesan, Anda perlu menentukan bahasa menggunakan kolom language. Bisnis Anda bertanggung jawab atas semua terjemahan yang ingin Anda gunakan.

Bahasa yang Didukung

Paket Bahasa

Template pesan disimpan dalam paket bahasa. Paket bahasa adalah sekumpulan elemen template pesan untuk bahasa atau locale tertentu. Jika bisnis berisi setidaknya satu terjemahan untuk bahasa atau locale, paket untuk bahasa/locale itu dibuat.

Namespace template pesan adalah sekumpulan paket bahasa untuk bisnis tertentu.

Opsi Kebijakan Bahasa

Jika template pesan dikirim dengan kolom language: policy diatur ke deterministic, nilai default, WhatsApp menyampaikan template pesan dalam bahasa dan locale yang diminta. Lalu, perangkat meminta server untuk paket bahasa dari bahasa tertentu itu.

Ketika pesan ini disampaikan ke perangkat, perangkat melakukan hal berikut:

• Pemeriksaan Kebijakan/Kode - Karena "policy": "deterministic" dan "code": "en", apakah ada paket en dengan cache di perangkat?

  • Jika ya, lanjut ke Pemeriksaan Elemen.
  • Jika tidak, apakah paket en dapat ditemukan di server?

    • Jika ya, perbarui cache lokal dan buka Pemeriksaan Elemen.
    • Jika tidak, catat kesalahan, server mengembalikan kesalahan structure_unavailable melalui Webhook, dan tidak ada pesan yang di-render di perangkat.

• Pemeriksaan Elemen - Apakah ada elemen "element": "hello_world"?

  • Jika ya, buka paket parameter dan render pesan di perangkat.
  • Jika tidak:

    • Jika paket bahasa berasal dari cache lokal, unduh paket en terbaru dari server dan ulangi Pemeriksaan Elemen.
    • Jika paket bahasa baru-baru ini diunduh dari server, catat kegagalannya, server mengembalikan kesalahan structure_unavailable melalui Webhook, dan tidak ada pesan yang di-render di perangkat.

Pengaturan bahasa/lokale perangkat sepenuhnya diabaikan.

Masalah yang bisa muncul saat menggunakan kebijakan deterministic adalah jika yang Anda minta tidak ada. Pastikan:

• Namespace-nya benar
• Nama elemen sudah benar
• Terjemahan bahasa/locale ada untuk elemen itu
• Bahwa jumlah parameter yang dikirim sesuai dengan yang ditentukan dalam template pesan

Pelokalan

Template Pesan memberikan dukungan pelokalan langsung dengan melokalkan pesan sesuai dengan pengaturan lokale perangkat.

Parameter yang Bisa Dilokalkan

Template memiliki parameter yang secara dinamis dimasukkan ke dalam pesan. Untuk contoh yang digunakan dalam dokumen ini, template pesan terlihat seperti ini:

"You made a purchase for {{1}} using a credit card ending in {{2}}."

Untuk "namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e" dengan "element_name": "purchase_with_credit_card", nilai pertama yang Anda daftarkan menggantikan variabel {{1}} dalam pesan template dan nilai kedua yang Anda daftarkan menggantikan variabel {{2}}.

Beberapa dari parameter ini (contoh: date_time atau currency) dapat dilokalkan sehingga ditampilkan dengan tepat berdasarkan bahasa pelanggan dan preferensi lokal. Jika perangkat tidak berhasil melokalkan parameter, default-nya adalah fallback_value.

Jika Anda perlu menentukan mata uang dan tanggal selain fallback_value, gunakan objek currency dan date_time. Ini memungkinkan klien untuk melokalkan data secara optimal sebaik mungkin, hanya kembali ke default fallback_value jika tidak bisa melokalkan data.

Opsi localizable_params ditunjukkan dalam tabel di bawah:

Parameter

Objek currency

Klien API WhatsApp Business akan mencoba memformat mata uang berdasarkan pelokalan yang ditetapkan.

Contoh

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

Objek date_time

Klien API WhatsApp Business akan mencoba memformat tanggal/waktu berdasarkan pelokalan yang ditetapkan. Format tanggal dan waktu yang didukung antara lain:

• Waktu Komponen — Waktu disusun dari beberapa komponen (yaitu, hari, bulan, jam, dsb.) Waktu yang ditetapkan akan sama, tanpa mempertimbangkan zona waktu tempat klien berada.
• Waktu Unix — Waktu yang ditampilkan bergantung pada zona waktu tempat klien berada.

DateTime

DateTimeComponent

Contoh

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

Langkah Berikutnya

Dokumen ini berisi informasi referensi tentang template pesan. Untuk panduan cara untuk membuat dan mengirim template, lihat Mengirim Template Pesan. Untuk semua parameter yang dapat digunakan dalam template pesan, lihat Pesan, Template Pesan.

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager