

**Pemberitahuan akhir dukungan:** Pada 30 Oktober 2026, AWS akan mengakhiri dukungan untuk Amazon Pinpoint. Setelah 30 Oktober 2026, Anda tidak akan lagi dapat mengakses konsol Amazon Pinpoint atau sumber daya Amazon Pinpoint (titik akhir, segmen, kampanye, perjalanan, dan analitik). Untuk informasi selengkapnya, lihat [Amazon Pinpoint akhir dukungan.](https://docs.aws.amazon.com/console/pinpoint/migration-guide) **Catatan:** APIs terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh AWS End User Messaging.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Templat pesan Amazon Pinpoint
<a name="messages-templates"></a>

Jika Anda sering mendesain dan mengirim jenis pesan tertentu, seperti buletin mingguan atau pengingat janji temu, Anda dapat membuat dan menyimpannya sebagai templat pesan. Anda kemudian dapat menggunakan template sebagai titik awal setiap kali Anda perlu mengirim jenis pesan itu, alih-alih merancang dan menulis pesan lagi.

*Template pesan* adalah sekumpulan konten dan pengaturan yang dapat Anda buat, simpan, lalu gunakan kembali dalam pesan yang Anda kirim untuk proyek Amazon Pinpoint mana pun. Saat Anda membuat templat, Anda menentukan konten yang ingin Anda gunakan kembali di berbagai komponen pesan yang didasarkan pada templat. 

Komponen-komponen ini disebut sebagai *bagian template*. Mereka dapat berisi teks statis, konten yang dipersonalisasi, gambar, dan elemen desain lainnya, tergantung pada jenis template. Bagian template juga dapat berisi pengaturan khusus saluran. Misalnya, bagian templat dalam templat pemberitahuan push dapat menentukan suara khusus untuk diputar atau gambar yang akan ditampilkan saat penerima menerima pemberitahuan push yang didasarkan pada templat.

Saat membuat pesan, Anda dapat memilih templat yang akan digunakan untuk pesan tersebut. Jika Anda memilih template, Amazon Pinpoint mengisi pesan dengan konten dan pengaturan dalam template.

Anda dapat mendesain jenis templat pesan berikut di Amazon Pinpoint:
+ **Templat email** untuk pesan email yang Anda kirim dari kampanye atau perjalanan, atau ke audiens terbatas sebagai pesan langsung atau uji coba.
+ **Templat pemberitahuan push** untuk pemberitahuan push yang Anda kirim dari kampanye, atau ke audiens terbatas sebagai pesan langsung atau uji coba.
+ **Template SMS** untuk pesan teks SMS yang Anda kirim dari kampanye, atau ke audiens terbatas sebagai pesan langsung atau tes.
+ **Templat suara** untuk pesan suara yang Anda kirim sebagai pesan langsung atau uji coba.

Selain mendukung beberapa jenis templat pesan, Amazon Pinpoint mendukung pembuatan versi untuk templat pesan. Versioning menyediakan cara bagi Anda untuk merancang dan mengubah template dari waktu ke waktu, sementara juga membuat dan memelihara riwayat template. Pembuatan versi juga menyediakan cara bagi Anda untuk menentukan versi template mana yang dapat digunakan dalam pesan. Untuk mempelajari lebih lanjut tentang versi templat, lihat[Mengelola versi templat pesan](message-templates-versioning.md).

Topik dalam Bab ini menjelaskan cara membuat dan mengelola template pesan untuk akun Amazon Pinpoint Anda.

**Topics**
+ [

# Membuat template email
](message-templates-creating-email.md)
+ [

# Membuat templat dalam aplikasi
](message-templates-creating-inapp.md)
+ [

# Membuat template pemberitahuan push
](message-templates-creating-push.md)
+ [

# Membuat template SMS
](message-templates-creating-sms.md)
+ [

# Membuat template suara
](message-templates-creating-voice.md)
+ [

# Menambahkan konten yang dipersonalisasi ke templat pesan
](message-templates-personalizing.md)
+ [

# Menggunakan pembantu template pesan
](message-template-helpers.md)
+ [

# Mengelola template pesan
](message-templates-managing.md)
+ [

# Mengelola versi templat pesan
](message-templates-versioning.md)

# Membuat template email
<a name="message-templates-creating-email"></a>

*Template email* adalah jenis template pesan yang berisi konten dan pengaturan yang ingin Anda buat, simpan, dan gunakan kembali dalam pesan email yang Anda kirim untuk proyek Amazon Pinpoint Anda. Anda dapat menggunakan template email dalam semua jenis pesan email yang Anda buat dan kirim menggunakan Amazon Pinpoint.

Saat Anda membuat template email, Anda menentukan konten dan pengaturan yang ingin Anda gunakan kembali di berbagai komponen pesan email yang didasarkan pada template. Komponen-komponen ini, disebut sebagai *bagian template*, dapat berupa subjek pesan, badan pesan, atau keduanya. Konten dapat berupa teks statis, konten yang dipersonalisasi, gambar, atau elemen desain lainnya. Bagian template juga dapat berupa pengaturan, seperti badan pesan yang akan digunakan jika aplikasi email penerima tidak menampilkan konten HTML.

Saat Anda membuat pesan email yang didasarkan pada templat, Amazon Pinpoint mengisi pesan dengan konten dan setelan yang Anda tentukan dalam templat. 

**Untuk membuat template email**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pilih **Buat templat**.

1. Di bawah **Saluran**, pilih **Email**.

1. Di bawah **rincian Template****, untuk nama Template**, masukkan nama untuk template. Nama harus dimulai dengan huruf atau angka. Ini dapat berisi hingga 128 karakter. Karakter dapat berupa huruf, angka, garis bawah (\$1), atau tanda hubung (‐).

1. (Opsional) Untuk **deskripsi Versi**, masukkan deskripsi singkat dari template. Deskripsi dapat berisi hingga 500 karakter.

1. Di bawah **Detail email**, gunakan opsi berikut untuk menentukan konten pesan yang menggunakan templat:
   + Untuk **Subjek**, masukkan teks yang ingin Anda tampilkan di baris subjek pesan.
   + Untuk **Pesan**, masukkan konten yang ingin Anda tampilkan di badan pesan.
**Tip**  
Untuk isi pesan, Anda dapat memasukkan konten dengan menggunakan tampilan HTML atau Desain. Dalam tampilan HTML, Anda dapat memasukkan konten HTML secara manual, termasuk pemformatan, tautan, dan fitur lain yang ingin Anda sertakan dalam pesan. Dalam tampilan Desain, Anda dapat menggunakan editor teks kaya untuk memasukkan konten. Gunakan bilah alat pemformatan untuk menerapkan pemformatan dan menambahkan tautan dan fitur lainnya ke konten. Untuk beralih tampilan, pilih **HTML** atau **Desain** dari pemilih tampilan di atas editor pesan.  
Anda juga dapat menyertakan konten yang dipersonalisasi dalam subjek dan isi template. Untuk melakukannya, tambahkan variabel pesan yang merujuk ke atribut tertentu yang dibuat oleh Anda atau Amazon Pinpoint, seperti atribut yang menyimpan nama depan pengguna. Dengan menggunakan variabel pesan, Anda dapat menampilkan konten yang berbeda untuk setiap penerima pesan yang menggunakan template. Untuk menggunakan variabel pesan, pilih nama atribut yang ada dari **pencari Atribut**. Amazon Pinpoint membuat variabel pesan untuk atribut dan menyalinnya ke clipboard Anda. Tempel variabel di lokasi yang Anda inginkan. Untuk informasi selengkapnya, lihat [Menambahkan konten yang dipersonalisasi ke templat pesan](message-templates-personalizing.md).

1. 
**catatan**  
Anda harus mengatur peran pengiriman orkestrasi email sebelum dapat menggunakan header email. Untuk informasi selengkapnya, lihat [Membuat peran pengiriman orkestrasi email di Amazon Pinpoint](channels-email-orchestration-sending-role.md).

   Di bawah **Header**, pilih **Tambahkan header baru**, untuk menambahkan hingga 15 header untuk pesan email. Untuk daftar header yang didukung, lihat [bidang header Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/header-fields.html) di [Panduan Pengembang Layanan Email Sederhana Amazon](https://docs.aws.amazon.com//ses/latest/dg/Welcome.html).
   + Untuk **Nama**, masukkan nama header.
   + Untuk **Nilai**, masukkan nilai header.

   (Opsional) Untuk menambahkan tautan berhenti berlangganan sekali klik, ke email promosi, tambahkan dua header berikut:

   1. Buat header dengan `List-Unsubscribe` for **Name** dan atur **Value** ke tautan berhenti berlangganan Anda. Tautan harus mendukung permintaan HTTP POST untuk memproses permintaan berhenti berlangganan penerima.

   1. Buat header dengan `List-Unsubscribe-Post` for **Name** dan atur **Value** ke`List-Unsubscribe=One-Click`.

1. (Opsional) Di bawah **versi teks biasa**, masukkan konten yang ingin Anda tampilkan di badan pesan yang menggunakan templat dan dikirim ke penerima yang aplikasi emailnya tidak menampilkan konten HTML.

1. Jika Anda menambahkan konten yang dipersonalisasi ke template menggunakan variabel pesan, tentukan nilai default untuk setiap variabel. Jika Anda melakukan ini, Amazon Pinpoint menggantikan variabel dengan nilai yang Anda tentukan, jika nilai yang sesuai tidak ada untuk penerima. Kami menyarankan Anda melakukan ini untuk setiap variabel dalam template.

   Untuk menentukan nilai default untuk variabel, perluas bagian **Nilai atribut Default**. Kemudian masukkan nilai default yang ingin Anda gunakan untuk setiap variabel. Jika Anda tidak menentukan nilai default dan nilai tidak ada untuk penerima, Amazon Pinpoint tidak mengirim pesan.

1. Ketika Anda selesai memasukkan konten dan pengaturan untuk template, pilih **Buat**.

Untuk menguji template sebelum Anda menggunakannya dalam pesan email yang Anda kirim ke pengguna, Anda dapat [mengirim pesan pengujian](messages-email.md) yang menggunakan template. Jika Anda melakukan ini, pastikan bahwa Anda pertama kali menyelesaikan langkah 9 untuk menentukan nilai default untuk semua variabel dalam template. Jika tidak, pesan mungkin tidak dikirim atau mungkin tidak ditampilkan dengan benar.

## Menyertakan tautan berhenti berlangganan di templat pesan
<a name="message-templates-creating-email-optout"></a>

Menyertakan tautan berhenti berlangganan di email Anda adalah praktik terbaik, dan di beberapa negara itu merupakan persyaratan hukum. Di tautan berhenti berlangganan Anda, Anda dapat menyertakan atribut khusus,`ses:tags="unsubscribeLinkTag:value"`, di mana nilai *value* apa pun yang Anda tentukan. [Jika penerima mengklik tautan yang berisi atribut khusus ini, Amazon Pinpoint menghitungnya sebagai peristiwa opt-out untuk tujuan analitik (misalnya, dalam metrik tarif Opt-out pada halaman ikhtisar Analytics).](analytics-overview.md) Contoh berikut menunjukkan sintaks untuk jenis link:

```
<a ses:tags="unsubscribeLinkTag:optout" href="https://www.example.com/preferences">Unsubscribe</a>
```

Jika template Anda menyertakan link dengan atribut ini, Anda masih harus mengembangkan sistem untuk menangani permintaan opt-out. Untuk contoh sistem yang memproses permintaan opt-out, lihat solusi [Pusat Preferensi Amazon Pinpoint di AWS Pustaka](https://aws.amazon.com/solutions/implementations/amazon-pinpoint-preference-center/) Solusi.

**catatan**  
Solusi Amazon Pinpoint Preference Center sekarang menjadi panduan. Solusinya tidak dapat lagi digunakan tetapi diagram arsitektur dan kode telah dibiarkan sebagai referensi.

# Membuat templat dalam aplikasi
<a name="message-templates-creating-inapp"></a>

Template *dalam aplikasi adalah template* untuk pesan yang Anda kirim dari Amazon Pinpoint ke pengguna aplikasi Anda. Gunakan templat dalam aplikasi untuk membuat, menyimpan, dan menggunakan kembali setelan dan konten untuk pesan dalam aplikasi Anda.

Saat membuat templat dalam aplikasi, Anda menentukan pengaturan dan konten yang ingin digunakan kembali di badan pesan dalam aplikasi yang menggunakan templat tersebut. Saat Anda membuat pesan menggunakan templat, Amazon Pinpoint mengisi pesan dengan pengaturan dan konten yang Anda tentukan.

Pesan dalam aplikasi sangat dapat disesuaikan. Mereka dapat menyertakan tombol yang membuka situs web atau membawa pengguna ke bagian tertentu dari aplikasi Anda. Anda dapat mengonfigurasi warna latar belakang dan teks, memposisikan teks, dan menambahkan gambar ke notifikasi. Anda dapat mengirim satu pesan, atau membuat *korsel* yang berisi hingga lima pesan unik yang dapat digulir oleh pengguna Anda.

**Untuk membuat templat dalam aplikasi**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pilih **Buat templat**.

1. Di bawah **Saluran**, pilih **Pesan dalam aplikasi**.

1. Di bawah **rincian Template****, untuk nama Template**, masukkan nama untuk template. Nama harus dimulai dengan huruf atau angka. Ini dapat berisi hingga 128 karakter. Karakter dapat berupa huruf, angka, garis bawah (\$1), atau tanda hubung (‐).

1. (Opsional) Untuk **deskripsi Versi**, masukkan deskripsi singkat dari template. Deskripsi dapat berisi hingga 500 karakter.

1. Di bagian **Detail pesan dalam aplikasi**, di bawah **Tata Letak**, pilih jenis tata letak untuk templat pesan. Anda dapat memilih dari opsi berikut:
   + **Spanduk atas** — pesan yang muncul sebagai spanduk di bagian atas halaman.
   + **Spanduk bawah** — pesan yang muncul sebagai spanduk di bagian bawah halaman.
   + **Spanduk tengah** — pesan yang muncul sebagai pemberitahuan di tengah halaman.
   + **Layar penuh** — pesan yang mencakup seluruh layar.
   + **Modal** — pesan yang muncul di jendela di depan halaman.
   + **Carousel** - tata letak digulir hingga lima pesan unik.

1. Di bawah **Header**, konfigurasikan judul yang muncul di awal pesan. Jika Anda membuat pesan Carousel, Anda harus membuat pesan pertama untuk Carousel, yang mencakup header.

   1. Untuk **teks Header** untuk ditampilkan di spanduk. Anda dapat memasukkan hingga 64 karakter.

   1. Untuk **warna teks Header**, pilih warna teks untuk header. Anda dapat secara opsional memasukkan nilai RGB atau kode warna hex.

   1. Untuk **penyelarasan Header**, pilih apakah Anda ingin teks menjadi **Kiri**, **Tengah**, atau **Kanan** dibenarkan.

1. Di bawah **Pesan**, konfigurasikan isi pesan.

   1. Untuk **Pesan**, masukkan teks isi untuk pesan tersebut. Pesan dapat berisi hingga 150 karakter.

   1. Untuk **warna Teks**, pilih warna teks untuk badan pesan. Anda dapat secara opsional memasukkan nilai RGB atau kode warna hex.

   1. Untuk **perataan Teks**, pilih apakah Anda ingin teks menjadi **Kiri**, **Tengah**, atau **Kanan** dibenarkan.

1. (Opsional) Ubah warna latar belakang pesan. Di bawah **Latar Belakang**, pilih warna latar belakang untuk pesan. Anda dapat secara opsional memasukkan nilai RGB atau kode warna hex.

1. (Opsional) Tambahkan gambar ke pesan. Di bawah **URL gambar**, masukkan URL gambar yang ingin Anda tampilkan dalam pesan. Hanya file.jpg dan.png yang diterima. Dimensi gambar tergantung pada jenis pesan:
   + Untuk **Banner**, gambar harus 100 piksel kali 100 piksel, atau rasio aspek 1:1.
   + Untuk **Carousel**, gambar harus 300 piksel kali 200 piksel, atau rasio aspek 3:2.
   + Untuk pesan **Fullscreen**, gambar harus 300 piksel kali 200 piksel, atau rasio aspek 3:2.

1. (Opsional) Tambahkan tombol ke pesan. Di bawah **tombol Primer**, lakukan hal berikut:

   1. Pilih **Tambahkan tombol utama**.

   1. Untuk **teks Tombol**, masukkan teks yang akan ditampilkan pada tombol. Anda dapat memasukkan hingga 64 karakter.

   1. (Opsional) Untuk **warna teks Tombol**, pilih warna untuk teks tombol. Anda dapat secara opsional memasukkan nilai RGB atau kode warna hex.

   1. (Opsional) Untuk **warna Latar Belakang**, pilih warna latar belakang untuk tombol. Anda dapat secara opsional memasukkan nilai RGB atau kode warna hex.

   1. (Opsional) Untuk **radius Border**, masukkan nilai radius. Nilai yang lebih rendah menghasilkan sudut yang lebih tajam, sementara angka yang lebih tinggi menghasilkan sudut yang lebih bulat. 

   1. Di bawah **Tindakan**, pilih peristiwa yang terjadi saat pengguna mengetuk tombol:
      + **Tutup** - Menolak pesan.
      + **Buka URL** — Membuka situs web.
      + **Buka tautan dalam** — Membuka aplikasi atau membuka tempat tertentu di aplikasi. 

      Jika Anda ingin perilaku tombol berbeda untuk jenis perangkat yang berbeda, Anda dapat mengganti tindakan default. Di bawah **Tindakan**, gunakan tab untuk memilih jenis perangkat yang ingin Anda ubah perilaku tombolnya. Misalnya, pilih **iOS** untuk mengubah perilaku tombol untuk perangkat iOS. Selanjutnya, pilih **Ganti tindakan default**. Akhirnya, tentukan tindakan.

1. (Opsional) Tambahkan tombol sekunder ke pesan. Di bawah **tombol Sekunder**, pilih **Tambahkan tombol sekunder**. Ikuti prosedur pada langkah sebelumnya untuk mengkonfigurasi tombol sekunder.

1. (Opsional) Tambahkan data khusus ke pesan. Data kustom adalah pasangan nilai kunci yang dikirimkan bersama pesan Anda. Misalnya, Anda mungkin ingin meneruskan kode promosi bersama dengan pesan Anda. Jika mengirim pesan carousel, Anda dapat menambahkan data kustom ke setiap pesan carousel. Untuk menambahkan data kustom, lakukan hal berikut:

   1. Di bawah **Data kustom**, pilih **Tambahkan item baru**.

   1. Masukkan **Kunci**. Misalnya, ini mungkin*PromoCode*. 

   1. Masukkan **Nilai** untuk kunci. Anda *PromoCode* mungkin*12345*.

   1. Ketika pesan dikirim, kode *12345* disertakan dalam pesan Anda.

   1. Untuk menambahkan lebih banyak pasangan kunci-nilai, pilih **Tambahkan item baru**. Anda dapat menambahkan hingga 10 pasangan nilai kunci ke pesan. Setelah Anda selesai menambahkan data khusus, lanjutkan ke langkah berikutnya.

1. Jika pesan Anda adalah korsel, Anda dapat menambahkan hingga empat pesan unik lainnya. Untuk menambahkan pesan ke carousel, perluas bagian ikhtisar **Carousel**. Selanjutnya, pilih **Tambahkan pesan baru**. Ulangi langkah sebelumnya untuk mengonfigurasi pesan.

   Saat Anda menambahkan pesan ke korsel, halaman **Pratinjau** diperbarui dengan menampilkan ikon di bagian bawah halaman yang menunjukkan jumlah pesan yang disertakan dalam korsel.

   Gambar berikut menunjukkan korsel dengan dua pesan:  
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/channels-inapp-carousel.png)

1. Setelah selesai, pilih **Buat**.

# Membuat template pemberitahuan push
<a name="message-templates-creating-push"></a>

*Template pemberitahuan push adalah template* pesan yang berisi konten dan pengaturan yang dapat Anda gunakan dengan proyek Amazon Pinpoint Anda. Saat Anda menggunakan templat untuk mengirim pemberitahuan push, Amazon Pinpoint mengisi notifikasi dengan konten dan pengaturan yang Anda tentukan dalam templat.

Saat Anda membuat templat pemberitahuan push, Anda menentukan konten dan pengaturan yang ingin Anda gunakan kembali di berbagai komponen pemberitahuan push yang didasarkan pada templat. Komponen ini, disebut sebagai *bagian templat*, dapat berisi teks (seperti judul atau isi pemberitahuan) atau pengaturan (seperti suara khusus untuk diputar saat penerima menerima pemberitahuan).

Untuk menyesuaikan template untuk saluran notifikasi push tertentu, Anda dapat membuat beberapa set bagian template di setiap template—set default, dan secara opsional satu atau beberapa set khusus layanan. Set default berisi konten dan pengaturan yang ingin Anda gunakan secara default untuk saluran pemberitahuan push apa pun. Set khusus layanan berisi konten dan setelan apa pun yang ingin Anda gunakan untuk layanan notifikasi tertentu, seperti layanan Pemberitahuan Push Apple atau Firebase Cloud Messaging. Dengan menambahkan setelan khusus layanan ke templat, Anda dapat menyesuaikan notifikasi untuk menampilkan konten yang unik untuk setiap jenis perangkat penerima.

Anda juga dapat [membuat template yang berisi data pesan mentah](#message-templates-creating-push-raw). Opsi ini lebih canggih, tetapi sangat membantu jika Anda ingin menentukan pengaturan untuk saluran tertentu yang tidak ada dalam templat notifikasi push Amazon Pinpoint standar.

## Membuat template notifikasi push standar
<a name="message-templates-creating-push-standard"></a>

Selesaikan prosedur ini untuk menentukan konten pesan dasar, seperti judul, badan pesan, gambar, dan tindakan. Untuk menentukan konten pesan mentah, selesaikan prosedur [Membuat template pemberitahuan push dengan data pesan mentah](#message-templates-creating-push-raw) sebagai gantinya.

**Untuk membuat template pemberitahuan push**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pilih **Buat templat**.

1. Di bawah **Saluran**, pilih **Pemberitahuan push**.

1. Di bawah **rincian Template****, untuk nama Template**, masukkan nama untuk template. Nama harus dimulai dengan huruf atau angka. Ini dapat berisi hingga 128 karakter. Karakter dapat berupa huruf, angka, garis bawah (\$1), atau tanda hubung (‐).

1. (Opsional) Untuk **deskripsi Versi**, masukkan deskripsi singkat dari template. Deskripsi dapat berisi hingga 500 karakter.

1. Di bawah **rincian pemberitahuan Push**, lakukan hal berikut:
   + Untuk **jenis Pemberitahuan**, pilih **Pesan standar**.
   + Untuk **Judul**, masukkan judul yang ingin Anda tampilkan di atas badan pesan.
   + Untuk **Body**, masukkan teks yang ingin Anda tampilkan di badan pesan notifikasi.
**Tip**  
Anda dapat memasukkan konten yang dipersonalisasi dalam judul dan isi template. Untuk melakukan ini, tambahkan variabel pesan yang merujuk ke atribut tertentu, seperti atribut yang menyimpan nama depan pengguna. Dengan menggunakan variabel pesan, Anda dapat menampilkan konten yang berbeda untuk setiap penerima pemberitahuan push yang menggunakan template.   
Untuk menggunakan variabel pesan, pilih nama atribut yang ada dari **pencari Atribut**. Amazon Pinpoint membuat variabel pesan untuk atribut dan menyalinnya ke clipboard Anda. Tempel variabel di lokasi yang Anda inginkan. Untuk informasi selengkapnya, lihat [Menambahkan konten yang dipersonalisasi ke templat pesan](message-templates-personalizing.md).
   + Untuk **suara peringatan khusus**, masukkan nama file audio yang berisi suara khusus yang ingin Anda putar saat penerima menerima pemberitahuan push. Nama ini harus cocok dengan nama file audio di perangkat penerima.
   + Untuk **Tindakan**, pilih apa yang ingin dilakukan perangkat penerima jika penerima mengetuk notifikasi push:
     + **Buka aplikasi Anda** — Buka aplikasi Anda atau bawa ke latar depan jika dikirim ke latar belakang.
     + **Buka URL** — Buka browser default di perangkat penerima dan muat halaman web tertentu. Jika Anda memilih opsi ini, masukkan URL halaman web di kotak **URL Tujuan**.
     + **Buka tautan dalam** — Buka aplikasi Anda dan tampilkan antarmuka pengguna tertentu di aplikasi. Jika Anda memilih opsi ini, masukkan URL antarmuka di kotak **URL Tujuan**.

1. (Opsional) Untuk menyesuaikan template untuk layanan pemberitahuan push tertentu, pilih tab layanan yang sesuai di bawah **Sesuaikan konten untuk layanan push individual**. Kemudian pilih opsi yang Anda inginkan untuk layanan itu.

   Jika Anda memilih kotak centang **Ganti konten push default** pada tab untuk layanan, Amazon Pinpoint secara otomatis menggantikan konten default dan pengaturan yang Anda pilih pada langkah sebelumnya dengan opsi yang Anda pilih di tab. Jika Anda ingin menyimpan konten dan pengaturan default dan hanya menyesuaikan template untuk menggunakan pengaturan khusus saluran tambahan, jangan pilih kotak centang ini.  
**Apel**  
Gunakan opsi ini untuk menentukan konten dan pengaturan khusus untuk pemberitahuan push yang Anda kirim melalui saluran layanan (APNs) Apple Push Notification ke aplikasi yang berjalan di perangkat iOS.  
Selain konten dan pengaturan standar, Anda dapat menyertakan gambar atau video khusus dalam pemberitahuan push yang menggunakan templat. Untuk melakukan ini, masukkan URL untuk file gambar atau video di kotak **media iOS**. URL harus dapat diakses publik. Jika tidak, perangkat penerima tidak akan dapat menampilkan gambar atau video.   
**Google**  
Gunakan opsi ini untuk menentukan konten dan setelan khusus notifikasi push yang Anda kirim melalui channel Google Firebase Cloud Messaging (FCM) ke aplikasi yang berjalan di perangkat Android.  
Selain konten dan pengaturan standar, Anda dapat memilih opsi berikut untuk menampilkan gambar khusus dalam pemberitahuan push yang menggunakan templat:  
   + **Gambar Android** — Masukkan URL gambar yang akan ditampilkan di badan pemberitahuan push.
   + **Ikon Android** - Masukkan URL gambar ikon besar untuk ditampilkan dalam tampilan konten pemberitahuan push.
   + **Ikon kecil Android** - Masukkan URL gambar ikon kecil untuk ditampilkan di bilah status dan dalam tampilan konten pemberitahuan push.  
**Amazon**  
Gunakan opsi ini untuk menentukan konten dan pengaturan khusus untuk pemberitahuan push yang Anda kirim melalui saluran Amazon Device Messaging (ADM) ke aplikasi yang berjalan di perangkat Amazon, seperti tablet Kindle Fire.  
Selain konten dan pengaturan standar, Anda dapat memilih opsi berikut untuk menampilkan gambar khusus dalam pemberitahuan push yang menggunakan templat:  
   + **Gambar Android** — Masukkan URL gambar yang akan ditampilkan di badan pemberitahuan push.
   + **Ikon Android** - Masukkan URL gambar ikon besar untuk ditampilkan dalam tampilan konten pemberitahuan push.
   + **Ikon kecil Android** - Masukkan URL gambar ikon kecil untuk ditampilkan di bilah status dan dalam tampilan konten pemberitahuan push.  
**Baidu**  
Gunakan opsi ini untuk menentukan konten dan pengaturan khusus untuk pemberitahuan push yang Anda kirim melalui saluran Baidu ke aplikasi yang menggunakan platform Baidu Cloud Push.  
Selain konten dan pengaturan standar, Anda dapat memilih opsi berikut untuk menampilkan gambar khusus dalam pemberitahuan push yang menggunakan templat:  
   + **Gambar Android** — Masukkan URL gambar yang akan ditampilkan di badan pemberitahuan push.
   + **Ikon Android** - Masukkan URL gambar ikon besar untuk ditampilkan dalam tampilan konten pemberitahuan push.
   + **Ikon kecil Android** - Masukkan URL gambar ikon kecil untuk ditampilkan di bilah status dan dalam tampilan konten pemberitahuan push.

1. Jika Anda menambahkan konten yang dipersonalisasi ke template menggunakan variabel pesan, tentukan nilai default untuk setiap variabel. Jika Anda melakukan ini, Amazon Pinpoint menggantikan variabel dengan nilai yang Anda tentukan, jika nilai yang sesuai tidak ada untuk penerima. Kami menyarankan Anda melakukan ini untuk setiap variabel dalam template.

   Untuk menentukan nilai default untuk variabel, perluas bagian **Nilai atribut Default**. Kemudian masukkan nilai default yang ingin Anda gunakan untuk setiap variabel. Jika Anda tidak menentukan nilai default dan nilai tidak ada untuk penerima, Amazon Pinpoint tidak mengirim pesan.

1. Ketika Anda selesai memasukkan konten dan pengaturan untuk template, pilih **Buat**.

## Membuat template pemberitahuan push dengan data pesan mentah
<a name="message-templates-creating-push-raw"></a>

Selesaikan prosedur ini untuk menentukan payload pesan mentah secara manual. Anda hanya perlu menentukan payload pesan mentah jika Anda ingin menggunakan fitur layanan pemberitahuan push tertentu yang Amazon Pinpoint tidak mengizinkan Anda untuk mengonfigurasinya. Jika Anda tidak perlu menentukan konten pesan mentah, Anda harus menyelesaikan prosedur [Membuat template notifikasi push standar](#message-templates-creating-push-standard) sebagai gantinya.

Contoh kasus penggunaan yang mengharuskan Anda menggunakan template pesan mentah adalah saat Anda ingin mengirim pesan ke pengguna browser web Safari desktop. Dalam hal ini, Anda harus menyertakan atribut tertentu dalam payload pesan mentah. Untuk informasi selengkapnya, lihat [Mengirim pesan](https://docs.aws.amazon.com/push-notifications/latest/userguide/reference-send-message.html) di *Panduan Pengguna Push Pesan Pengguna AWS Akhir*.

**Untuk membuat template pemberitahuan push**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pilih **Buat templat**.

1. Di bawah **Saluran**, pilih **Pemberitahuan push**.

1. Di bawah **rincian Template****, untuk nama Template**, masukkan nama untuk template. Nama harus dimulai dengan huruf atau angka. Ini dapat berisi hingga 128 karakter. Karakter dapat berupa huruf, angka, garis bawah (\$1), atau tanda hubung (‐).

1. (Opsional) Untuk **deskripsi Versi**, masukkan deskripsi singkat dari template. Deskripsi dapat berisi hingga 500 karakter.

1. Di bawah **Rincian pemberitahuan push**, untuk **jenis Pemberitahuan**, pilih **Pesan mentah**. Editor pesan menampilkan garis besar kode yang akan digunakan untuk template. Di editor pesan, masukkan pengaturan yang ingin Anda gunakan untuk setiap layanan pemberitahuan push, termasuk pengaturan opsional apa pun—seperti gambar, suara, dan tindakan—yang ingin Anda tentukan untuk templat. Untuk informasi selengkapnya, lihat dokumentasi untuk layanan pemberitahuan push yang Anda gunakan.

1. Setelah selesai memasukkan konten pesan mentah, pilih **Buat**.

Untuk menguji template sebelum Anda menggunakannya dalam pemberitahuan push yang Anda kirim ke pengguna, Anda dapat [mengirim notifikasi pengujian](messages-mobile.md) yang menggunakan template. Jika Anda melakukan ini, pastikan bahwa Anda pertama kali menyelesaikan langkah 10 untuk menentukan nilai default untuk semua variabel dalam template. Jika tidak, pemberitahuan push mungkin tidak dikirim atau mungkin tidak ditampilkan dengan benar.

# Membuat template SMS
<a name="message-templates-creating-sms"></a>

*Template SMS* adalah jenis template pesan yang berisi konten dan pengaturan yang ingin Anda buat, simpan, dan gunakan kembali dalam pesan teks SMS yang Anda kirim untuk proyek Amazon Pinpoint Anda. Anda dapat menggunakan templat SMS dalam pesan teks yang Anda kirim dari kampanye, atau ke audiens terbatas sebagai pesan langsung atau uji coba.

Saat Anda membuat template SMS, Anda menentukan pengaturan dan konten yang ingin Anda gunakan kembali di badan pesan teks yang didasarkan pada templat. Saat Anda membuat pesan yang didasarkan pada templat, Amazon Pinpoint mengisi pesan dengan pengaturan dan konten yang Anda tentukan dalam templat.

**Untuk membuat template SMS**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pilih **Buat templat**.

1. Di bawah **Saluran**, pilih **SMS**.

1. Di bawah **rincian Template****, untuk nama Template**, masukkan nama untuk template. Nama harus dimulai dengan huruf atau angka. Ini dapat berisi hingga 128 karakter. Karakter dapat berupa huruf, angka, garis bawah (\$1), atau tanda hubung (‐).

1. (Opsional) Untuk **deskripsi Versi**, masukkan deskripsi singkat dari template. Deskripsi dapat berisi hingga 500 karakter.

1. Di bawah **detail SMS**, untuk **Pesan**, masukkan konten yang ingin Anda tampilkan di badan pesan yang menggunakan templat. Badan pesan dapat berisi hingga 1.600 karakter.
**Tip**  
Anda dapat memasukkan konten yang dipersonalisasi dalam tubuh template. Untuk melakukannya, tambahkan variabel pesan yang merujuk ke atribut tertentu yang dibuat oleh Anda atau Amazon Pinpoint, seperti atribut yang menyimpan nama depan pengguna. Dengan menggunakan variabel pesan, Anda dapat menampilkan konten yang berbeda untuk setiap penerima pesan yang menggunakan template.  
Untuk menggunakan variabel pesan, pilih nama atribut yang ada dari **pencari Atribut**. Amazon Pinpoint membuat variabel pesan untuk atribut dan menyalinnya ke clipboard Anda. Tempel variabel di lokasi yang Anda inginkan. Untuk informasi selengkapnya, lihat [Menambahkan konten yang dipersonalisasi ke templat pesan](message-templates-personalizing.md).

1. Jika Anda menambahkan konten yang dipersonalisasi ke template menggunakan variabel pesan, tentukan nilai default untuk setiap variabel. Jika Anda melakukan ini, Amazon Pinpoint menggantikan variabel dengan nilai yang Anda tentukan, jika nilai yang sesuai tidak ada untuk penerima. Kami menyarankan Anda melakukan ini untuk setiap variabel dalam template.

   Untuk menentukan nilai default untuk variabel, perluas bagian **Nilai atribut Default**. Kemudian masukkan nilai default yang ingin Anda gunakan untuk setiap variabel. Jika Anda tidak menentukan nilai default dan nilai tidak ada untuk penerima, Amazon Pinpoint tidak mengirim pesan.

1. Ketika Anda selesai memasukkan konten dan pengaturan untuk template, pilih **Buat**.

Untuk menguji template sebelum Anda menggunakannya dalam pesan yang Anda kirim ke pengguna, Anda dapat [mengirim pesan pengujian](messages-sms.md) yang menggunakan template. Jika Anda melakukan ini, pastikan bahwa Anda pertama kali menyelesaikan langkah 8 untuk menentukan nilai default untuk semua variabel dalam template. Jika tidak, pesan mungkin tidak dikirim atau mungkin tidak ditampilkan dengan benar.

# Membuat template suara
<a name="message-templates-creating-voice"></a>

*Template suara* adalah jenis template pesan yang berisi konten dan pengaturan yang ingin Anda buat, simpan, dan gunakan kembali dalam pesan suara yang Anda kirim untuk proyek Amazon Pinpoint Anda. Anda dapat menggunakan templat suara dalam pesan suara yang dikirim sebagai pesan langsung atau uji coba.

Saat membuat templat suara, Anda menentukan konten dan pengaturan yang ingin digunakan kembali di berbagai komponen pesan suara yang didasarkan pada templat. Komponen-komponen ini disebut sebagai *bagian template*. Mereka dapat berisi teks skrip pesan atau pengaturan, seperti suara yang akan digunakan saat menyampaikan pesan. Skrip pesan dapat menyertakan teks statis dan, secara opsional, konten yang dipersonalisasi yang Anda tentukan.

Saat Anda membuat pesan suara yang didasarkan pada templat, Amazon Pinpoint mengisi pesan dengan konten dan setelan yang Anda tentukan dalam templat.

**Untuk membuat template suara**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pilih **Buat templat**.

1. Di bawah **Saluran**, pilih **Suara**.

1. Di bawah **rincian Template****, untuk nama Template**, masukkan nama untuk template. Nama harus dimulai dengan huruf atau angka. Ini dapat berisi hingga 128 karakter. Karakter dapat berupa huruf, angka, garis bawah (\$1), atau tanda hubung (‐).

1. (Opsional) Untuk **deskripsi Versi**, masukkan deskripsi singkat dari template. Deskripsi dapat berisi hingga 500 karakter.

1. Di bawah **Detail pesan suara****, untuk Pesan**, masukkan teks yang ingin Anda gunakan sebagai skrip pesan untuk pesan yang menggunakan templat. Script dapat berisi hingga 10.000 karakter dan harus dalam format plaintext.
**Tip**  
Anda dapat menyertakan konten yang dipersonalisasi dalam skrip pesan. Untuk melakukannya, tambahkan variabel pesan yang merujuk ke atribut tertentu yang dibuat oleh Anda atau Amazon Pinpoint, seperti atribut yang menyimpan nama depan pengguna. Dengan menggunakan variabel pesan, Anda dapat memutar konten yang berbeda untuk setiap penerima pesan yang menggunakan templat.   
Untuk menggunakan variabel pesan, pilih nama atribut yang ada dari **pencari Atribut**. Amazon Pinpoint membuat variabel pesan untuk atribut dan menyalinnya ke clipboard Anda. Tempel variabel di lokasi yang Anda inginkan. Untuk informasi selengkapnya, lihat [Menambahkan konten yang dipersonalisasi ke templat pesan](message-templates-personalizing.md).

1. Untuk **Bahasa dan wilayah**, pilih bahasa tempat teks skrip pesan ditulis. Amazon Pinpoint menggunakan pengaturan ini untuk menentukan fonem dan setelan khusus bahasa lainnya yang akan digunakan saat mengonversi teks skrip menjadi ucapan.

1. Untuk **Suara**, pilih suara yang ingin Anda ucapkan pesan kepada penerima. Setiap suara dibuat menggunakan penutur bahasa asli, sehingga ada variasi dari suara ke suara, bahkan dalam bahasa yang sama. Oleh karena itu, ada baiknya untuk menguji setiap suara dengan skrip Anda.

   Daftar suara berubah berdasarkan bahasa yang Anda pilih pada langkah 8. Dalam kebanyakan kasus, daftar ini mencakup setidaknya satu suara pria dan satu wanita. Dalam beberapa kasus, hanya satu suara yang tersedia. Kami terus menambahkan dukungan untuk bahasa tambahan dan membuat suara untuk bahasa yang didukung.

1. Pilih **Putar pesan** untuk menguji bagaimana pesan akan terdengar saat dikirim ke penerima. Sesuaikan konten dan pengaturan hingga template memiliki desain yang Anda inginkan.

1. Jika Anda menambahkan konten yang dipersonalisasi ke template menggunakan variabel pesan, tentukan nilai default untuk setiap variabel. Jika Anda melakukan ini, Amazon Pinpoint menggantikan variabel dengan nilai yang Anda tentukan, jika nilai yang sesuai tidak ada untuk penerima. Kami menyarankan Anda melakukan ini untuk setiap variabel dalam template.

   Untuk menentukan nilai default untuk variabel, perluas bagian **Nilai atribut Default**. Kemudian masukkan nilai default yang ingin Anda gunakan untuk setiap variabel. Jika Anda tidak menentukan nilai default dan nilai tidak ada untuk penerima, Amazon Pinpoint tidak mengirim pesan.

1. Ketika Anda selesai memasukkan konten dan pengaturan untuk template, pilih **Buat**.

# Menambahkan konten yang dipersonalisasi ke templat pesan
<a name="message-templates-personalizing"></a>

Untuk mengirimkan konten dinamis dan dipersonalisasi dalam pesan yang menggunakan templat, tambahkan *variabel pesan* ke templat pesan. *Variabel pesan* adalah placeholder yang mengacu pada atribut tertentu yang dibuat oleh Anda atau Amazon Pinpoint untuk menyimpan informasi tentang pengguna Anda. Setiap atribut biasanya sesuai dengan karakteristik pengguna, seperti nama depan pengguna atau kota tempat mereka tinggal. Dengan menambahkan variabel pesan ke templat, Anda dapat menggunakan atribut ini untuk mengirimkan konten khusus ke setiap penerima pesan yang menggunakan templat.

Jika template berisi variabel pesan, Amazon Pinpoint menggantikan setiap variabel dengan nilai atribut saat ini yang sesuai untuk setiap penerima. Hal ini dilakukan setiap kali mengirim pesan yang menggunakan template. Ini berarti Anda dapat mengirim konten yang dipersonalisasi ke setiap penerima tanpa membuat beberapa versi pesan atau templat pesan yang disesuaikan. Anda juga dapat merasa yakin bahwa pesan tersebut berisi informasi terbaru yang Anda miliki untuk penerima.

Misalnya, jika proyek Anda adalah aplikasi kebugaran untuk pelari dan menyertakan atribut untuk nama depan setiap pengguna, aktivitas pilihan, dan catatan pribadi, Anda dapat menggunakan variabel teks dan pesan berikut dalam templat:

`Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!`

Saat Anda mengirim pesan yang menggunakan templat, Amazon Pinpoint menggantikan variabel dengan nilai saat ini dari setiap atribut untuk setiap penerima. Contoh berikut menunjukkan ini.

**Contoh 1**  
`Hi Sofia, congratulations on your new half marathon record of 1:42:17!`

**Contoh 2**  
`Hi Alejandro, congratulations on your new 5K record of 20:52!`

Jika nilai atribut tidak ada untuk penerima, Amazon Pinpoint dapat mengganti variabel dengan nilai default yang Anda tentukan untuk variabel tersebut. Misalnya, jika pengguna aplikasi kebugaran Anda belum memilih aktivitas pilihan mereka, Anda dapat menggunakannya `running` sebagai nilai default untuk `{{User.UserAttributes.Activity}}` variabel tersebut. Dalam hal ini, Amazon Pinpoint menggantikan variabel seperti yang ditunjukkan pada contoh berikut:

**Contoh 1**  
`Hi Jane, congratulations on your new running record of 1:42:17!`

**Contoh 2**  
`Hi John, congratulations on your new running record of 20:52!`

Jika Anda tidak menentukan nilai default dan nilai tidak ada untuk penerima, Amazon Pinpoint menghilangkan semua teks untuk variabel saat mengirim pesan ke penerima tersebut. Contoh:

`Hi Mary, congratulations on your new record of 20:52!`

Sebagai praktik terbaik, kami menyarankan Anda menentukan nilai default untuk setiap variabel yang Anda sertakan dalam template.

## Menambahkan variabel pesan
<a name="message-templates-add-variables"></a>

Anda dapat menambahkan atribut pesan ke templat baru yang Anda buat atau ke templat yang sudah ada. Jika Anda menambahkan variabel ke template yang ada, Amazon Pinpoint tidak selalu menerapkan perubahan pada pesan yang menggunakan template dan belum dikirim, seperti pesan kampanye yang dijadwalkan untuk dikirim di lain waktu. Hal ini tergantung pada versi template yang Anda tambahkan variabel dan bagaimana Anda mengkonfigurasi pesan yang menggunakan template. Untuk informasi selengkapnya, lihat [Mengelola versi templat pesan](message-templates-versioning.md).

**catatan**  
Template pesan dalam aplikasi tidak mendukung penggunaan variabel pesan.

**Untuk menambahkan variabel pesan ke template pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **template Pesan**, lakukan salah satu hal berikut: 
   + Untuk membuat template baru dan menambahkan variabel pesan ke dalamnya, pilih **Buat template**. Kemudian, pada halaman templat, masukkan nama untuk templat dan, secara opsional, deskripsi templat.
   + Untuk menambahkan variabel pesan ke template yang ada, pilih template yang ingin Anda tambahkan variabel. Kemudian, pada halaman template, pilih **Edit**. Di bawah **Detail templat**, gunakan pemilih versi untuk memilih versi templat yang ingin Anda gunakan sebagai titik awal. Jika Anda memilih versi terbaru, Anda dapat menyimpan perubahan langsung ke versi template tersebut. Jika tidak, Anda dapat menyimpan perubahan Anda sebagai versi baru dari template.

1. Di bagian detail pesan, tentukan di mana Anda ingin menambahkan variabel pesan. Anda dapat menambahkan variabel ke badan semua jenis template. Untuk templat pemberitahuan email dan push, Anda juga dapat menambahkan variabel ke subjek atau judul pesan. 

1. Di **Pencari atribut**, perluas bagian untuk jenis atribut yang ingin Anda tambahkan variabel pesan. Anda dapat memilih dari jenis atribut berikut:  
**Atribut standar**  
Ini adalah atribut yang dibuat Amazon Pinpoint secara otomatis untuk proyek apa pun. Ini berarti Anda dapat menggunakannya dalam pesan yang Anda kirim untuk proyek apa pun. Untuk informasi rinci tentang masing-masing atribut ini, lihat[Atribut yang didukung](#message-templates-variables).  
Untuk menambahkan variabel untuk atribut standar, pilih atribut dari daftar.  
**Atribut khusus**  
Ini adalah atribut yang dapat Anda buat secara opsional untuk masing-masing proyek. Karena atribut ini mungkin tidak tersedia untuk beberapa proyek Anda, Amazon Pinpoint mungkin tidak dapat mengganti variabel dengan nilai untuk setiap penerima pesan yang menggunakan templat. Untuk membantu Anda menghindari masalah ini, Amazon Pinpoint menyediakan opsi untuk membantu Anda memilih atribut yang ada untuk proyek tertentu atau semua proyek Anda.  
Untuk menambahkan atribut kustom:  

   1. Pilih **atribut Kustom**, lalu pilih **Muat atribut kustom**. Di jendela yang muncul, Amazon Pinpoint mencantumkan semua proyek yang Anda buat. Saat Anda memilih setiap proyek, atribut yang umum untuk proyek yang dipilih ditampilkan di panel navigasi sebelah kanan. Jika tidak ada atribut yang ditampilkan, maka tidak ada atribut umum di antara proyek-proyek tersebut. 

   1. Lakukan salah satu tindakan berikut:
      + Untuk menggunakan semua atribut yang umum untuk proyek yang dipilih, pilih **Muat atribut kustom**.
      + Untuk menggunakan atribut tertentu dari daftar, masukkan bagian mana pun dari nama atribut di bidang pencarian. Atribut yang cocok dengan tampilan teks yang dimasukkan. Pilih **Muat atribut kustom** saat atribut yang ingin Anda gunakan ditampilkan. **Pencari atribut** menampilkan atribut kustom yang baru ditambahkan. 
**catatan**  
Anda tidak dapat menambahkan atribut umum dari kumpulan proyek yang berbeda, atau Anda memodifikasi bagian **Atribut kustom** dari **pencari Atribut**. Untuk mengubah atribut kustom, pilih **X** untuk menghapus **pencari Atribut,** dan kemudian mulai lagi.

   1. Di **pencari Atribut**, pilih atribut yang ingin Anda tambahkan variabelnya.  
**Atribut yang direkomendasikan**  
Ini adalah atribut yang Anda buat secara opsional untuk akun saat mengonfigurasi Amazon Pinpoint untuk mengambil rekomendasi yang dipersonalisasi dari model pemberi rekomendasi. Untuk informasi tentang menggunakan model pemberi rekomendasi, lihat[Model pembelajaran mesin](ml-models.md). Anda dapat menambahkan variabel untuk jenis atribut ini ke templat email, templat pemberitahuan push, dan templat SMS. Anda tidak dapat menambahkannya ke templat suara.  
Untuk menambahkan variabel untuk atribut yang direkomendasikan, pilih atribut dari daftar. Jika **pencari Atribut** tidak mencantumkan atribut yang direkomendasikan, Anda harus terlebih dahulu menghubungkan template ke model pemberi rekomendasi.   
Untuk menambahkan atribut yang direkomendasikan:  

   1. Pilih **model Connect**. 

   1. Pilih model yang ingin Anda ambil rekomendasi saat Anda mengirim pesan yang menggunakan templat. 

   1. Pilih **model Connect**.


1. Bila Anda memilih atribut dari **pencari Atribut**, Amazon Pinpoint membuat variabel pesan untuk atribut dan menyalinnya ke clipboard Anda. Tempel variabel di lokasi yang Anda inginkan. Jika Anda memiliki daftar atribut yang panjang, masukkan teks pencarian untuk mempersempit daftar. Pilih **X** untuk menghapus kolom pencarian.

   Setelah Anda menempelkan variabel, Amazon Pinpoint menampilkannya sebagai nama atribut terkait, terlampir dalam dua set kurung kurawal — misalnya,. `{{User.UserAttributes.FirstName}}`

1. Ulangi langkah 4-6 untuk setiap variabel pesan yang ingin Anda tambahkan.

1. Untuk menentukan nilai default untuk variabel pesan, perluas bagian **Nilai atribut Default**. Kemudian, dalam daftar variabel, masukkan nilai default yang ingin Anda gunakan untuk variabel tersebut.
**catatan**  
Kami menyarankan Anda melakukan ini untuk setiap variabel dalam template. Jika tidak, Amazon Pinpoint mungkin tidak dapat mengirim pesan yang menggunakan templat atau pesan mungkin ditampilkan dengan cara yang tidak terduga atau tidak diinginkan.

1. Setelah selesai, lakukan salah satu hal berikut:
   + Jika Anda menambahkan variabel pesan ke template baru, pilih **Buat**.
   + Jika Anda menambahkan variabel pesan ke template yang ada dan Anda ingin menyimpan perubahan Anda sebagai versi baru dari template, pilih **Simpan sebagai versi baru**.
   + Jika Anda menambahkan variabel pesan ke template yang ada dan Anda ingin menyimpan perubahan Anda sebagai pembaruan ke versi terbaru dari template, pilih **Perbarui versi**. Opsi ini hanya tersedia jika Anda membuka versi terbaru dari template di langkah 3.

## Atribut yang didukung
<a name="message-templates-variables"></a>

Setiap proyek dapat memiliki atribut standar dan atribut khusus. Atribut standar adalah atribut yang dibuat Amazon Pinpoint secara otomatis untuk proyek apa pun. Atribut khusus adalah atribut yang Anda buat secara opsional untuk sebuah proyek. Ada tiga jenis atribut khusus:
+ **Atribut pengguna** — Atribut ini menggambarkan pengguna — misalnya, nama depan, nama belakang, dan tanggal lahir pengguna. *Pengguna* adalah individu yang memiliki ID pengguna unik untuk sebuah proyek.
+ **Atribut titik akhir** - Atribut ini menjelaskan titik akhir tertentu untuk pengguna. *Titik akhir* adalah tujuan yang dapat Anda kirimi pesan—seperti alamat email, nomor telepon, atau perangkat seluler. Setiap pengguna dapat dikaitkan dengan satu atau lebih titik akhir. Misalnya, jika Anda berkomunikasi dengan pengguna melalui email, SMS, dan telepon, pengguna dapat dikaitkan dengan tiga titik akhir—satu untuk alamat email pengguna, satu lagi untuk nomor ponsel pengguna, dan satu lagi untuk nomor telepon rumah (telepon rumah) pengguna.
+ **Atribut metrik** — Atribut ini adalah metrik numerik yang dilaporkan aplikasi Anda ke Amazon Pinpoint untuk titik akhir individual, seperti jumlah sesi untuk aplikasi seluler atau jumlah item yang tersisa di keranjang.
+ **Atribut Pinpoint — Atribut** ini adalah pengenal unik untuk aplikasi, kampanye, atau perjalanan Anda.

*Selain atribut kustom dan standar yang Anda atau Amazon Pinpoint buat untuk proyek Anda, Amazon Pinpoint mendukung atribut yang direkomendasikan.* Atribut yang *direkomendasikan adalah atribut* yang menyimpan sementara rekomendasi yang dipersonalisasi untuk pengguna atau titik akhir. Amazon Pinpoint mengambil rekomendasi ini dari model pemberi rekomendasi yang Anda konfigurasikan untuk digunakan. Atribut yang disarankan tidak terkait dengan proyek tertentu. Sebaliknya, mereka terkait dengan akun Amazon Pinpoint Anda. Untuk informasi tentang menggunakan model pemberi rekomendasi, lihat[Model pembelajaran mesin](ml-models.md).

Anda dapat menggunakan atribut standar, kustom, atau direkomendasikan dalam variabel pesan. Tabel berikut menunjukkan teks yang muncul dalam variabel pesan untuk setiap atribut yang didukung, dan menjelaskan setiap atribut. Dalam tabel, *custom\$1attribute* menunjukkan teks yang muncul dalam variabel untuk atribut kustom. Dalam kasus tersebut, ganti *custom\$1attribute* dengan nama atribut kustom. Misalnya, jika proyek Anda menyimpan nama depan pengguna dalam atribut pengguna kustom bernama `FirstName` dan Anda menambahkan variabel untuk atribut itu, teks untuk variabel tersebut adalah`{{User.UserAttributes.FirstName}}`.


| Atribut | Deskripsi | 
| --- | --- | 
| Address | Alamat tujuan untuk pesan atau pemberitahuan push yang Anda kirim ke titik akhir—misalnya, alamat email, nomor telepon, atau token perangkat. | 
| Pinpoint.ApplicationId | Pengidentifikasi unik untuk aplikasi. | 
| Attributes.custom\$1attribute | Atribut endpoint kustom yang menjelaskan titik akhir. | 
| Pinpoint.CampaignId | Pengidentifikasi unik untuk kampanye. | 
| ChannelType | Saluran yang akan digunakan saat mengirim pesan atau pemberitahuan push ke titik akhir. Contoh:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/message-templates-personalizing.html) | 
| CreationDate | Tanggal dan waktu ketika titik akhir ditambahkan ke proyek, dalam format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Misalnya, 2019-06-30T11:45:25.220Z untuk 11:45 UTC 30 Juni 2019. | 
| Demographic.AppVersion | Nomor versi aplikasi yang terkait dengan titik akhir. | 
| Demographic.Locale | [Lokal titik akhir, dalam format berikut: kode [ISO 639-1 alpha-2, diikuti oleh garis bawah (\$1), diikuti oleh nilai alfa-2](https://en.wikipedia.org/wiki/ISO_639-1) ISO 3166-1.](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) Misalnya, en\$1US adalah bahasa Inggris lokal untuk Amerika Serikat. | 
| Demographic.Make | Produsen perangkat endpoint, seperti apple atausamsung. | 
| Demographic.Model | Nama model atau nomor perangkat titik akhir, seperti iPhone atauSM-G900F. | 
| Demographic.ModelVersion | Versi model perangkat endpoint. | 
| Demographic.Platform | Sistem operasi pada perangkat endpoint, seperti ios atauandroid. | 
| Demographic.PlatformVersion | Versi sistem operasi pada perangkat endpoint. | 
| Demographic.Timezone | Zona waktu titik akhir, sebagai nilai [database tz](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Misalnya, America/Los\$1Angeles untuk Waktu Pasifik (Amerika Utara). | 
| EffectiveDate | Tanggal dan waktu ketika titik akhir terakhir diperbarui, dalam format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Misalnya, 2019-08-23T10:54:35.220Z untuk 10:54 UTC 23 Agustus 2019. | 
| EndpointId | Pengidentifikasi unik untuk titik akhir. | 
| EndpointStatus | Baik untuk mengirim pesan atau pemberitahuan push ke titik akhir:ACTIVE, mengirim pesan ke titik akhir, atau,INACTIVE, jangan mengirim pesan ke titik akhir. | 
| Id | Pengidentifikasi unik untuk titik akhir. | 
| Pinpoint.JourneyId | Pengenal unik untuk perjalanan. | 
| Location.City | Kota tempat titik akhir berada. | 
| Location.Country | Kode dua karakter, dalam [format ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), untuk negara atau wilayah tempat titik akhir berada. Misalnya, US untuk Amerika Serikat. | 
| Location.Latitude | Koordinat lintang lokasi titik akhir, dibulatkan ke satu tempat desimal. | 
| Location.Longitude | Koordinat bujur dari lokasi titik akhir, dibulatkan ke satu tempat desimal. | 
| Location.PostalCode | Kode pos atau ZIP untuk area di mana titik akhir berada. | 
| Location.Region | Nama wilayah, seperti negara bagian atau provinsi, tempat titik akhir berada. | 
| Metrics.custom\$1attribute | Metrik numerik khusus yang dilaporkan aplikasi Anda ke Amazon Pinpoint untuk titik akhir. | 
| OptOut | Apakah pengguna memilih untuk tidak menerima pesan dan pemberitahuan push dari Anda:ALL, pengguna memilih keluar dan tidak ingin menerima pesan atau pemberitahuan push apa pun, atau,NONE, pengguna belum memilih keluar dan ingin menerima semua pesan dan pemberitahuan push. | 
| RecommendationItems | Atribut standar yang direkomendasikan yang menyimpan satu rekomendasi untuk titik akhir atau pengguna. Atribut ini berisi teks yang disediakan langsung oleh model pemberi rekomendasi. | 
| RecommendationItems.[\$1] |  Atribut standar yang direkomendasikan yang menyimpan daftar terurut 2—5 rekomendasi untuk titik akhir atau pengguna. Atribut ini berisi teks yang disediakan langsung oleh model pemberi rekomendasi. Placeholder numerik (. [\$1]) menunjukkan bahwa atribut berisi beberapa nilai. Variabel pesan untuk atribut ini dapat merujuk ke nilai tertentu dalam daftar.  | 
| Recommendations.custom\$1attribute | Atribut yang direkomendasikan khusus yang menyimpan satu rekomendasi untuk titik akhir atau pengguna. Atribut ini berisi konten yang disediakan oleh model pemberi rekomendasi dan disempurnakan oleh AWS Lambda fungsi. | 
| Recommendations.custom\$1attribute.[\$1] |  Atribut yang direkomendasikan khusus yang menyimpan beberapa rekomendasi untuk titik akhir atau pengguna. Atribut ini berisi konten yang disediakan oleh model pemberi rekomendasi dan disempurnakan oleh AWS Lambda fungsi. Placeholder numerik (. [\$1]) menunjukkan bahwa atribut berisi beberapa nilai. Variabel pesan untuk atribut ini dapat merujuk ke salah satu nilai tersebut secara khusus.  | 
| RequestId | Pengidentifikasi unik untuk permintaan terbaru untuk memperbarui titik akhir. | 
| User.UserAttributes.custom\$1attribute | Atribut pengguna kustom yang menjelaskan pengguna. | 
| User.UserId | Pengidentifikasi unik untuk pengguna. | 

# Menggunakan pembantu template pesan
<a name="message-template-helpers"></a>

Dengan template Amazon Pinpoint, pelanggan dapat membuat templat pesan yang dapat digunakan kembali berdasarkan bahasa Handlebars.js. Pembantu menyediakan berbagai fitur seperti memformat harga ke mata uang Wilayah tertentu atau menambahkan lokasi berbasis zona waktu. Helper dapat menggunakan string atau bilangan bulat tertentu untuk nilai atau variabel pesan Amazon Pinpoint tertentu.

Ini adalah kategori pembantu, dijelaskan di bagian berikut:

## Pembantu default
<a name="defaulthelpers"></a>

Bagian ini menjelaskan pembantu **bawaan** yang disediakan oleh Setang. Untuk daftar lengkapnya, lihat [Pembantu Bawaan](https://handlebarsjs.com/guide/builtin-helpers.html) di [handlebarsjs.com](https://handlebarsjs.com). Ini adalah pembantu bawaan:
+ `each`— Mengulangi daftar.
**catatan**  
Ukuran daftar maksimum adalah 15 item.
+ `if`— Mengevaluasi pernyataan.

*setiap*  
Mengulangi daftar. Helper ini hanya menggunakan pernyataan blok. Anda dapat secara opsional:   
+ Lulus `@index` permintaan untuk mereferensikan indeks loop saat ini.
+ Gunakan `this` helper untuk mereferensikan elemen saat ini yang sedang diulang.
+ Kembalikan respons pembantu dalam daftar, menggunakan `<li>` tag.
**Penggunaan**  
`{{#each value}}`  
Nilai pada posisi `{{@index}}` adalah`{{this}}`.  
`{{else}}`  
Kondisinya salah.  
`{{/each}}`  
`each`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/each}}` dalam pernyataan blok.  
**Contoh**  
Dalam contoh `each` ini, digunakan untuk mengembalikan daftar warna favorit pengguna. Untuk a`false`, `else` pernyataan dikembalikan. Jika permintaannya adalah ini:  
`{{#each User.UserAttributes.FavoriteColors}}`  
`<li>{{this}}</li>`  
`{{else}}`  
*You have no favorite colors.*  
`{{/each}}`kembali  
+ *red*
+ *blue*
+ *yellow*
untuk pernyataan yang benar.

*jika*  
Mengevaluasi apakah sesuatu itu benar dan mengembalikan respons berdasarkan evaluasi.   
**Penggunaan**  
`{{#if value}}`  
Nilai tidak terdefinisi  
`{{else}}`  
Nilai tidak terdefinisi  
`{{/if}}`  
`if`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/if}}` dalam pernyataan blok.  
**Contoh**  
Dalam contoh ini, `if` helper digunakan untuk mengevaluasi apakah nama depan pengguna. Jika nama ditemukan, salam dikembalikan yang melewati nama depan pengguna dalam respons. Jika tidak, `else` pernyataan mengembalikan salam alternatif.  
`{{#if User.UserAttributes.FirstName.[0]}}`  
`Hello {{User.UserAttributes.FirstName.[0]}},`  
`{{else}}`  
*Hello,*  
`{{/if}}`  
kembali *Hello, Jane* jika `if` penolong benar.

## Pembantu bersyarat
<a name="conditionhelpers"></a>

Bagian ini menjelaskan **pembantu bersyarat**. 

Pembantu bersyarat dapat digunakan pada satu baris atau dalam pernyataan blok. Anda dapat menyesuaikan respons terlepas dari metode pembantu yang Anda gunakan. Anda dapat melewati pembantu bersyarat tambahan dalam pernyataan baris tunggal dan blok. Pembantu bersyarat berikut menunjukkan penggunaan pertama untuk satu baris dan kemudian pernyataan blok menggunakan klausa opsional`else`. Ini adalah pembantu bersyarat:
+ `and`— Membandingkan apakah semua elemen yang dilewati sama.
+ `eq`— Menguji apakah dua elemen sama.
+ `gt`— Menguji apakah satu elemen lebih besar dari yang lain.
+ `gte`— Menguji apakah satu elemen lebih besar dari atau sama dengan yang lain.
+ `if`Mengevaluasi apakah sesuatu itu benar.
+ `lt`— Menguji apakah satu elemen kurang dari yang lain.
+ `lte`— Menguji apakah satu elemen kurang dari atau sama dengan yang lain.
+ `neq`Mengevaluasi apakah dua elemen tidak sama.
+ `not`— Membalikkan respons operasi Boolean.
+ `or`— Membandingkan apakah salah satu elemen dalam argumen sama.

*and*  
Membandingkan apakah *semua* elemen yang dilewatkan dalam argumen sama, dan kemudian mengembalikan respons berdasarkan hasilnya. Helper ini dapat digunakan untuk nilai-nilai non-Boolean. Anda harus melewati setidaknya dua elemen untuk kondisi tersebut.  
**Penggunaan**  
+ `{{and valuea valueb valuec valued yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#and valuea valueb}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/and}}`

  `and`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/and}}` dalam pernyataan blok.
**Contoh**  
Dalam contoh ini, `eq` digunakan dalam pernyataan `and` blok untuk menentukan apakah kedua string yang diteruskan untuk `Location.Country` atribut `Location.City ` dan benar. Jika kedua kondisi sama, maka pernyataan yang benar dikembalikan. Jika salah satu dari atribut tersebut salah, maka `else` pernyataan dikembalikan.  
`{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}`  
*You live in Los Angeles and the US.*  
`{{else}}`  
*You don’t live in Los Angeles and the US.*  
`{{/and}}`

*persamaan*  
Menguji apakah dua elemen sama atau jika nilai satu elemen sama dengan string yang dilewatkan.  
**Penggunaan**  
+ `{{eq valuea valueb yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#eq valuea valueb}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/eq}}`

  `eq`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/eq}}` dalam pernyataan blok.
**Contoh**  
Dalam contoh `eq` ini, digunakan untuk mengevaluasi apakah nilai `User.UserAttributes.FavoriteColors.[0]` adalah*Red*. Jika jawabannya`true`, pernyataan yang benar dikembalikan. Jika jawabannya`false`, maka `else` pernyataan dikembalikan.  
`{{#eq User.UserAttributes.FavoriteColors.[0] "red"}}`  
*Your favorite color is red.*  
`{{else}}`  
*You don't like red.*  
`{{/eq}}`

*gt*  
Menguji apakah nilai satu elemen lebih besar dari yang lain.   
**Penggunaan**  
+ `{{gt valuea valueb yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#gt valuea valueb}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/gt}}`

  `gt`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/gt}}` dalam pernyataan blok.
**Contoh**  
Dalam contoh ini, helper membandingkan nilai `User.UserAttributes.UserAge.[0]` atribut terhadap string*17*, untuk memverifikasi apakah usia pengguna lebih besar dari 17. Jika jawabannya`true`, pernyataan yang benar dikembalikan. Jika jawabannya`false`, maka `else` pernyataan dikembalikan.  
`{{#gt User.UserAttributes.UserAge.[0] "17"}}`  
*You are old enough to rent a car.*  
`{{else}}`  
*You are not old enough to rent a car.*  
`{{/gt}}`

*gte*  
Menguji apakah nilai satu elemen lebih besar dari atau sama dengan yang lain.  
`Usage`  
+ `{{gte valuea valueb yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#gte valuea valueb}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/gte}}`

  `get`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/gte}}` dalam pernyataan blok.
**Contoh**  
Dalam contoh ini, helper membandingkan `User.UserAttributes.UserAge.[0]` atribut terhadap string*18*, untuk memverifikasi apakah usia pengguna lebih besar dari atau sama dengan 18. Jika jawabannya`true`, pernyataan yang benar dikembalikan. Jika jawabannya`false`, maka `else` pernyataan dikembalikan.  
`{{#gte User.UserAttributes.UserAge.[0] "18"}}`  
*You are old enough to rent a car.*  
`{{else}}`  
*You are not old enough to rent a car.*  
`{{/gte}}`

*jika*  
Mengevaluasi apakah sesuatu itu benar dan mengembalikan respons berdasarkan evaluasi.  
**Penggunaan**  
+ `{{#if value}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#if value}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/if}}`

  `if`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/if}}` dalam pernyataan blok.
**Contoh**  
Dalam contoh ini, helper digunakan untuk mengevaluasi apakah nama depan pengguna. Jika nama ditemukan, salam dikembalikan yang melewati nama depan pengguna dalam respons. Jika tidak, pernyataan else mengembalikan salam alternatif.  
`{{#if User.UserAttributes.FirstName.[0]}}`  
*Hello* `{{User.UserAttributes.FirstName.[0]}}`*,*  
`{{else}}`  
*Hello,*  
`{{/if}}`  
kembali *Hello Jane,* jika penolong benar.

*lt*  
Menguji apakah nilai satu elemen kurang dari nilai elemen lainnya.  
**Penggunaan**  
+ `{{lt valuea valueb yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#lt valuea valueb}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/lt}}`

  `lt`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/lt}}` dalam pernyataan blok.
**Contoh**  
Dalam contoh ini, helper membandingkan `User.UserAttributes.UserAge.[0]` atribut terhadap string*18*, untuk memverifikasi apakah usia pengguna kurang dari 18. Jika jawabannya`true`, pernyataan yang benar dikembalikan. Jika jawabannya`false`, maka `else` pernyataan dikembalikan.  
`{{#lt User.UserAttributes.UserAge.[0] "18"}}`  
*You are not old enough to rent a car.*  
`{{else}}`  
*You are old enough to rent a car.*  
`{{/lt}}`

*lte*  
Menguji apakah nilai suatu elemen kurang dari atau sama dengan yang lain.  
**Penggunaan**  
+ `{{lte valuea valueb yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#lte valuea valueb}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/lte}}`

  `lte`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/lte}}` dalam pernyataan blok.
**Contoh**  
Dalam pernyataan blok ini, helper membandingkan `User.UserAttributes.UserAge.[0]` atribut terhadap string*17*, untuk memverifikasi apakah usia pengguna sama dengan 17 atau lebih muda. Jika jawabannya`true`, pernyataan yang benar dikembalikan. Jika jawabannya`false`, maka `else` pernyataan dikembalikan.  
`{{#lte User.UserAttributes.Age.[0] "17"}}`  
*You are not old enough to rent a car.*  
`{{else}}`  
*You are old enough to rent a car.*  
`{{/lte}}`

*neq*  
Uji apakah dua elemen *tidak* sama.  
**Penggunaan**  
+ `{{neq valuea valueb yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#neq valuea valueb}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/neq}}`

  `neq`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/neq}}` dalam pernyataan blok.
**Contoh**  
Dalam pernyataan blok ini, `User.UserAttributes.FavoriteColors.[0]` atribut diperiksa terhadap string`Red`. Jika jawabannya`true`, pernyataan yang benar dikembalikan. Jika jawabannya`false`, maka `else` pernyataan dikembalikan.  
`{{#neq User.UserAttributes.Favorite.Colors.[0] "red"}}`  
*You do not like red.*  
`{{else}}`  
*You like red.*  
`{{/neq}}`

*tidak*  
Membalikkan respon dari operasi Boolean, sehingga jika `not` adalah perbandingan positif, maka `true` pernyataan dikembalikan. Jika responsnya salah, maka pernyataan else dikembalikan.   
**Penggunaan**  
+ `{{not value yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya.
+ `{{#not value}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/not}}`

  `not`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/not}}` dalam pernyataan blok.
**Contoh**  
Dalam pernyataan blok ini, `User.UerAttributes.FavoriteColors.[0]` atribut diperiksa terhadap string*red*, menggunakan `eq` helper. `not`Pembantu kemudian mengembalikan kebalikan dari `eq` penolong. Jika respons mengembalikan warna apa pun selain*red*, `true` pernyataan dikembalikan. Jika respon kembali*red*, maka `else` pernyataan dikembalikan menunjukkan pernyataan palsu.  
`{{#not (eq User.UserAttributes.Favorite.Colors.[0] "red")}}`  
*You do not like red.*  
`{{else}}`  
*You like red.*  
`{{/not}}`  
**Contoh**  
Dalam contoh ini,   
`{{not (eq User.UserAttributes.FavoriteColors.[0] "red")}}`  
mengembalikan false jika `User.UserAttributes.FavoriteColors.[0]` ada*red*.

*atau*  
Membandingkan *apakah salah* satu elemen dalam argumen sama, dan kemudian mengembalikan respons berdasarkan hasilnya. Helper ini dapat digunakan untuk nilai-nilai non-Boolean.  
**Penggunaan**  
+ `{{or valuea valueb valuec valued yes='y' no='n'}}`

  Anda dapat mengganti *y* dan *n* dengan nilai lain, seperti *yes* dan*no*, atau string lain yang ingin Anda kembalikan, tergantung pada kondisinya. Anda harus melewati setidaknya dua elemen untuk kondisi tersebut.
+ `{{#or valuea valueb}}`

  Kondisi itu benar.

  `{{else}}`

  Kondisinya salah.

  `{{/or}}`

  `or`harus diawali dengan tanda pound (`#`) dan diakhiri dengan penutupan `{{/or}}` dalam pernyataan blok.
**Contoh**  
Dalam pernyataan `or` blok ini, dua string untuk `Location.City` atribut dibandingkan tambahan menggunakan `eq` helper. Jika salah satu atribut adalah`true`, maka pernyataan yang benar dikembalikan. Jika satu atau lebih tanggapan`false`, maka `else` pernyataan dikembalikan.  
`{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}`  
*You live on the West Coast of the United States.*  
`{{else}}`  
*You do not live on the West Coast of the United States.*  
`{{/or}}`

## Pembantu tali
<a name="stringhelpers"></a>

Bagian ini menjelaskan pembantu **string** berikut:
+ `abbreviate`— Memotong nilai.
+ `capitalize`— Kapitalisasi setiap kata di antara spasi putih.
+ `capitalizeFirst`— Mengkapitalisasi karakter pertama dari suatu nilai.
+ `center`— Memusatkan nilai.
+ `cut`— Memotong nilai.
+ `dateFormat`— Menetapkan gaya tanggal.
+ `inflect`— Mengembalikan string tunggal atau jamak berdasarkan hitungan.
+ `join`— Bergabung dengan array, iterator, atau objek iterable.
+ `ljust`— Membenarkan nilai ke margin kiri.
+ `lower`— Mengkonversi nilai ke huruf kecil.
+ `now`— Mencetak tanggal saat ini.
+ `ordinalize`— Ordinalisasi nilai numerik.
+ `replace`— Mengganti satu string dengan yang lain.
+ `rjust`— Membenarkan nilai ke margin kanan.
+ `slugify`— Mengonversi nilai menjadi huruf kecil dan menghapus karakter non-kata, mengubah spasi menjadi tanda hubung, dan menghapus spasi putih yang tertinggal.
+ `stripTags`— Strip [X] tag HTML dari nilai.
+ `substring`— Mengembalikan string baru sebagai substring dari nilai yang dilewatkan.
+ `upper`— Mengonversi nilai yang dilewatkan ke huruf besar.
+ `yesno`Menggantikan benar, salah, dan tidak dengan Ya, Tidak, dan Mungkin.

*menyingkat*  
Memangkas nilai jika nilainya melebihi angka yang ditentukan. Ruang putih termasuk dalam hitungan panjang. Elipsis ditampilkan dalam respons untuk menunjukkan nilai terpotong. Elipsis dihitung terhadap nilai terpotong dalam respons. Jenis pembantu ini berguna jika Anda memiliki meja besar dan ruang minimal. Memotong nilai dalam sel memungkinkan Anda untuk memiliki tampilan yang lebih seragam ke tabel.  
**Penggunaan**  
 `{{abbreviate value X}}`, mengganti *X* dengan nilai numerik yang menunjukkan jumlah karakter yang harus disimpan. Angka negatif tidak didukung.  
**Contoh**  
Dalam contoh ini, `abbreviate` digunakan untuk memotong `User.UserAttributes.LastName.[0]` menjadi enam (6) karakter. Respons termasuk elipsis, titik-titik yang dihitung terhadap total enam karakter.  
`{{abbreviate User.UserAttributes.LastName.[0] 6}}`kembali  
*Ale...*jika *Alejandro* adalah nilai dari`[0]`.

*memanfaatkan*  
Kapitalisasi setiap kata di antara spasi putih.  
**Penggunaan**  
 `{{capitalize value}}`  
**Contoh**  
Dalam contoh ini, kapitalisasi awal diterapkan pada setiap kata untuk `Attributes.description.[0]` entri.  
`{{capitalize Attributes.description.[0]}}`  
Jika `Attributes.description.[0]` kembali   
 *My First Post*, jika nilainya `Attributes.description.[0]` adalah*my first post*.

*KapitalisasiPertama*  
Mengkapitalisasi karakter pertama dalam suatu nilai.  
**Penggunaan**  
`{{capitalizeFirst value}}`  
**Contoh**  
Dalam contoh ini, kapitalisasi diterapkan pada karakter pertama dari kata pertama `Attributes.description.[0]` entri.  
`{{capitalizeFirst Attributes.description.[0]}}`kembali  
 *My first post*, jika nilainya `Attributes.description.[0]` adalah*my first post*.  
**Contoh**

*pusat*  
Memusatkan nilai dalam bidang lebar tertentu dengan nomor yang ditentukan. Anda dapat secara opsional meneruskan karakter untuk ditampilkan untuk padding atau membiarkan bidang kosong. Jika tidak ada karakter yang dilewatkan, spasi putih digunakan.  
**Penggunaan**  
 `{{center value size=X [pad=" "}}`, mengganti *X* dengan nilai numerik.  
Jika `pad` dibiarkan kosong, spasi putih digunakan sebagai padding dalam respons. Jika Anda melewati karakter, karakter itu ditampilkan di setiap ruang padding. Angka negatif tidak didukung.  
**Contoh**  
Dalam contoh ini, nilai `Location.City ` dipusatkan dengan ukuran. *19*  
`{{center Location.City size=19}}`kembali   
*"    Los Angeles    "*Jika `Location.City` adalah*Los Angeles*. Perhatikan bahwa tanda kutip yang ditampilkan dalam contoh output disediakan untuk penekanan saja.

*memotong*  
Menghapus nilai yang ditentukan dari string.   
**Penggunaan**  
 `{{cut value [" "]}}`, mengganti spasi dalam parameter tanda kutip dengan nilai yang akan dipotong. Jika tidak ada nilai parameter yang dilewatkan, spasi putih digunakan.   
**Contoh**  
Contoh ini menghapus huruf *e* dari `Location.City` atribut.  
`{{cut Location.City "e"}}`kembali  
*Los Angls*jika `[Location.City` adalah*Los Angeles*.

*DateFormat*  
Menetapkan gaya tanggal default untuk tanggal dalam respons apa pun. Untuk daftar zona waktu IDs, lihat[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).  
**Penggunaan**  
`{{dateFormat date [inputFormat="format1"] [outputFormat="format2"] [tz=timeZoneId] [locale=localeID]}}`  
`format`Parameter harus salah satu dari:  
+ “`full`“: format tanggal lengkap. Misalnya: *Tuesday, September 19, 2020*
+ “`long`“: format tanggal panjang. Misalnya: *September 19, 2020*
+ “`medium`“: format tanggal sedang. Misalnya: *Sept 19, 2020*
+ “`short`“: format tanggal pendek. Misalnya: *9/19/20*
+ “`pattern`“: menggunakan format pola tanggal kustom. Untuk informasi selengkapnya tentang pola tanggal, lihat[https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html).
“`locale`“: menggunakan format tanggal berdasarkan lokal tertentu. Untuk informasi lebih lanjut tentang lokal, lihat[https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-).  
Jika format tidak diteruskan, maka `medium` digunakan secara default.   
**Contoh**  
Dalam contoh ini, `[0]` entri untuk `User.UserAttributes.StartDate.[0]` adalah **09/19/2020** dan pesan dikirim ke pengguna menggunakan format `full` tanggal berdasarkan zona *America/Los\$1Angeles* waktu.  
`We can meet with you any time on ``{{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.`kembali  
*We can meet with you any time on Tuesday, September 19, 2020.*

*belok*  
Mengembalikan string tunggal atau jamak berdasarkan nilai hitungan.  
**Penggunaan**  
 `{{inflect count singular plural [includeCount=false]}}`  
+ Masukkan bentuk tunggal dan jamak dari string yang ingin Anda lewatkan dalam argumen.
+ Jika `includeCount` disetel ke`false`, tidak ada hitungan yang dikembalikan dalam respons. Jika diatur ke `true``count`, termasuk dalam respons.
**Contoh**  
Contoh berikut menunjukkan infleksi untuk pembelian apel, dengan dan tanpa. `includeCount`  
`Thank you for your purchase of {{inflect 3 apple apples includeCount=false}}.`mengembalikan:  
*Thank you for your purchase of apples.*  
Jika `includeCount` diatur ke`true`, maka responsnya adalah  
*Thank you for your purchase of 3 apples.*

*join*  
Bergabung dengan array, iterator, atau objek iterable. Respons mengembalikan daftar, dengan setiap nilai dalam daftar digabungkan dengan karakter yang Anda berikan dalam. `join` Misalnya, Anda dapat memisahkan nilai menggunakan koma (`,`). Nilai dalam helper ini harus berupa daftar tanpa indeks posisi atribut. Misalnya, ini mungkin`Attributes.custom_attribute`.  
**Penggunaan**  
`{{join value " // " [prefix=""] [suffix=""]}}`  
**Contoh**  
Dalam contoh ini, daftar warna dikembalikan, dengan daftar dipisahkan oleh koma dan spasi (`", "`):  
`{{join Attributes.favorite_colors ", "}}`kembali   
*blue, red, green*jika `Attributes.favorite_colors` adalah daftarnya*blue,red,green*.

*ladil*  
Membenarkan nilai ke margin kiri dan menambahkan spasi ke kanan sehingga panjang nilai cocok dengan angka. Angka negatif tidak didukung.  
Anda dapat secara opsional meneruskan karakter untuk ditampilkan untuk `pad` atau membiarkan bidang kosong. Jika Anda membiarkan `pad` nilai kosong, nilai default adalah spasi putih.  
**Penggunaan**  
`{{ljust value size=X [pad=" "]}}`, di *X* mana panjang total nilai, termasuk spasi putih.   
**Contoh**  
Dalam contoh ini, nilai justifikasi kiri *15 * diterapkan ke Location.City.  
`{{ljust Location.City size=15}}`kembali  
*"Los Angeles    "*jika nilainya `Location.City` adalah*Los Angeles*. Perhatikan bahwa tanda kutip yang ditampilkan dalam contoh output disediakan untuk penekanan saja.

*menurunkan*  
Mengkonversi nilai ke semua huruf kecil.  
**Penggunaan**  
`{{lower value}}`  
**Contoh**  
Dalam contoh ini, `[0]` entri `User.UserAttributes.LastName.[0]` untuk diubah menjadi huruf kecil.  
`{{lower User.UserAttributes.LastName.[0]}}`kembali  
*santos*jika *Santos* adalah nilai dari`[0]`.

*sekarang*  
Mencetak tanggal saat ini berdasarkan ID zona waktu yang dilewati. Untuk daftar zona waktu IDs, lihat[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).  
**Penggunaan**  
`{{now [format="format"] [tz=timeZoneId] [locale=localeID]}}`  
`format`Parameter harus salah satu dari:  
+ “`full`“: format tanggal lengkap. Misalnya: *Tuesday, September 19, 2020*
+ “`long`“: format tanggal panjang. Misalnya: *September 19, 2020*
+ “`medium`“: format tanggal sedang. Misalnya: 19 September 2020
+ “`short`“: format tanggal pendek. Misalnya: 9/19/20
+ “`pattern`“: pola tanggal. Untuk informasi selengkapnya tentang pola tanggal, lihat[https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html). 
“`locale`“: menggunakan format tanggal berdasarkan lokal tertentu. Untuk informasi lebih lanjut tentang lokal, lihat[https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-).  
Jika format tidak diteruskan, maka `medium` digunakan secara default.  
**Contoh**  
Dalam contoh ini, tanggal saat ini di Los Angeles dikembalikan dengan `medium` format.  
`{{now "medium" tz=America/Los_Angeles}}`kembali   
*Sept 19, 2020*.

*menordinalisasi*  
Ordinalisasi nilai numerik yang diteruskan dalam argumen. Misalnya, *1* diordinalisasikan sebagai *1st* dan *2* sebagai*2nd*. Hanya nilai numerik yang didukung.  
**Penggunaan**  
`{{ordinalize [number]}} `  
**Contoh**  
Dalam contoh ini, `[0]` entri `User.UserAttributes.UserAge` diordinalisasi dan dikembalikan, bersama dengan pesan.   
`Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!`pengembalian *22* diordinalisasi sebagai*22nd*.  
*Congratulations on your 22nd birthday\$1*

*menggantikan*  
Mengganti satu string dengan string lain. Sebuah string atau nilai numerik harus literal. Karakter wildcard tidak didukung.  
**Penggunaan**  
`{{replace stringToReplace replacementValue}}`  
**Contoh**  
Dalam contoh ini, garis bawah (\$1) menggantikan spasi putih.  
`{{replace Location.City " " "_"}}`kembali  
*Los\$1Angeles*jika `Location.City ` ada*Los Angeles*.

*radil*  
Membenarkan nilai ke margin kanan dan menambahkan spasi ke kiri sehingga panjang nilai cocok dengan angka. Angka negatif tidak didukung.  
Anda dapat secara opsional meneruskan karakter untuk ditampilkan untuk `pad` atau menjaga bidang kosong. Jika Anda menyimpan `pad` nilai kosong, nilai default adalah spasi putih.  
**Penggunaan**  
`{{rjust value size=X [pad=" "]}}`, di *X* mana panjang total nilai, termasuk spasi putih.   
**Contoh**  
Dalam contoh ini, nilai justifikasi yang tepat *15* diterapkan pada `Location.City` atribut.  
`{{rjust Location.City size=15}}`kembali  
*"    Los Angeles" *. jika `Location.City` ada*Los Angeles*. Perhatikan bahwa tanda kutip yang ditampilkan dalam output disediakan untuk penekanan saja.

*melumpuhkan*  
Mengonversi nilai yang diteruskan menjadi huruf kecil, menghapus karakter non-kata (alfanumerik dan garis bawah), mengonversi spasi menjadi tanda hubung, dan menghapus spasi putih di depan atau di belakang.  
**Penggunaan**  
`{{slugify value}}`  
**Contoh**  
Dalam contoh ini, slugify dilakukan untuk atribut. `Location.City`   
`{{slugify Location.City}}`kembali  
*los-angeles*jika `Location.City` adalah*Los Angeles*.

*StripTags*  
Strip [X] tag HTML dari nilai.  
**Penggunaan**  
 `{{stripTags value}}`  
**Contoh**  
Dalam contoh ini, tag HTML untuk Pengguna. UserAttributes.interest. [0] dihapus.   
`{{stripTags User.UserAttributes.interests.[0]}}`kembali  
*Art*, jika `User.UserAttributes.interests.[0]` ada`<h1>Art</h1>`.

*substring*  
Mengembalikan string baru sebagai substring dari nilai lulus. Panjang dan posisi ditentukan oleh `endOffset` parameter `startOffset` dan, yang harus bilangan bulat. Angka negatif tidak didukung. Jika tidak `endOffset` dilewatkan, substring menggunakan nilai akhir asli dari string.  
**Penggunaan**  
`{{substring value startOffset [endOffset]}}`  
**Contoh**  
Dalam contoh ini, offset 4 dan EndoffSet dari 9 diterapkan ke atribut Location.City.   
`{{substring Location.City 4 9}} `kembali  
`Angel`jika Los Angeles adalah nilai dari `Location.City` is*Los Angeles*.

*atas*  
Mengonversi nilai yang dilewatkan ke huruf besar.  
**Penggunaan**  
`{{upper value}}`  
**Contoh**  
Dalam contoh ini, `[0] ` entri untuk `User.UserAttributes.LastName` atribut dikonversi ke semua huruf besar.  
`{{upper User.UserAttributes.LastName.[0]}}`kembali  
*ROE*jika `User.UserAttributes.LastName.[0]` nilainya*Roe*.

*yesno*  
Menggantikan`true`,`false`, dan `NULL` dengan`Yes`,`No`, dan`Maybe`.  
**Penggunaan**  
`{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}`  
**Contoh**  
Dalam contoh ini, `IsUserSubscribed` atribut mengembalikan apakah pengguna berlangganan daftar tertentu.  
`{{yesno Attributes.IsUserSubscribed}}`kembali   
*yes*jika `Attributes.IsUserSubscribed` adalah*true*.

## Pembantu matematika dan pengkodean
<a name="mathhelpers"></a>

Bagian ini menjelaskan pembantu **matematika dan pengkodean**.
+ `add`— Mengembalikan jumlah dari dua angka.
+ `ceiling`— Membulatkan bilangan bulat ke langit-langit matematikanya.
+ `decode64`— Mendekode nilai yang dikodekan base64 ke string.
+ `divide`— Mengembalikan hasil bagi dua angka.
+ `encode64`— Mengkodekan string menggunakan base64.
+ `floor`— Membulatkan bilangan bulat ke lantai matematikanya.
+ `md5`— Hash string yang dilewatkan menggunakan MD5 algoritma.
+ `modulo`— Mengembalikan sisa dari dua angka menggunakan floating point.
+ `multiply`— Mengembalikan produk dari dua angka.
+ `round`— Membulatkan desimal ke bilangan bulat terdekat.
+ `sha256`— Hash string yang dilewatkan menggunakan SHA-256.
+ `sha512`— Hash string yang dilewatkan menggunakan SHA-512.
+ `subtract`— Mengembalikan selisih dua angka.
+ `uuid`— Secara acak menghasilkan UUID dalam format 128-bit.

*tambahkan*  
Mengembalikan jumlah dua angka bersama dengan floating point.  
**Penggunaan**  
`{{add arg1 arg2}}`  
**Contoh**  
`{{add 5 2.3}} `kembali  
*7.3*

*langit-langit*  
Membulatkan bilangan bulat ke langit-langit matematikanya, yang merupakan bilangan bulat tertinggi yang paling dekat dengan nilai yang dilewatkan.  
**Penggunaan**  
`{{ceiling value}}`  
**Contoh**  
`{{ceiling 5.23}}`kembali  
*6*

*decode64*  
Mendekode nilai yang dikodekan base64 ke string.  
**Penggunaan**  
`{{decode64 "string"}}`  
**Contoh**  
`{{decode64 "SGVsbG8gd29ybGQ="}}`kembali  
*Hello World*

*membagi*  
Mengembalikan hasil bagi dua angka, termasuk floating point.  
**Penggunaan**  
 `{{divide arg1 arg2}}`  
**Contoh**  
`{{divide 5 2.3}}`kembali  
*2.17391304*

*dikode64*  
Mengkodekan string yang diteruskan dalam argumen menggunakan base64.  
**Penggunaan**  
`{{encode64 "string"}}`  
**Contoh**  
`{{encode64 "Hello World"}}`  
*SGVsbG8gd29ybGQ=*

*lantai*  
Membulatkan bilangan bulat ke lantai matematikanya, yang merupakan bilangan bulat terendah yang paling dekat dengan nilai yang dilewatkan.  
**Penggunaan**  
`{{floor value}}`  
**Contoh**  
`{{floor 5.23}}`kembali  
*5*

*md5*  
Hash string yang dilewatkan menggunakan MD5 algoritma.  
**Penggunaan**  
`{{md5 "string"}}`  
**Contoh**  
`{{md5 "Hello World"}}`  
*3e25960a79dbc69b674cd4ec67a72c62*

*modulo*  
Mengembalikan sisa dari dua angka menggunakan floating point.  
**Penggunaan**  
`{{modulo arg1 arg2}}`  
**Contoh**  
`{{modulo 7 2}}`kembali  
*1*

*kalikan*  
Mengembalikan produk dari dua angka, dengan setiap floating point.  
**Penggunaan**  
`{{multiply arg1 arg2}}`  
**Contoh**  
`{{multiply 5 2.3}}`kembali  
*11.5*

*bulat*  
Membulatkan tempat desimal ke atas atau ke bawah ke bilangan bulat terdekat.  
**Penggunaan**  
`{{round value}}`  
**Contoh**  
`You spent an average of {{round 19.21}} minutes on our website each day.`mengembalikan:  
*You spent an average of 19 minutes on our website each day.*

*sha256*  
Hash string yang diteruskan menggunakan keamanan kriptografi SHA-256.  
**Penggunaan**  
`{{sha256 "string"}}`  
**Contoh**  
`{{sha256 "Hello World"}}`kembali  
*a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e*

*sha512*  
Hash string yang diteruskan menggunakan keamanan kriptografi SHA-512.  
**Penggunaan**  
`{{sha512 "string"}}`  
**Contoh**  
`{{sha512 "Hello World"}}`kembali  
*2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b*

*kurangi*  
Mengembalikan selisih dua angka, dengan floating point.  
**Penggunaan**  
`{{subtract arg1 arg2}}`  
**Contoh**  
`{{subtract 5 2.3}} `kembali  
*2.7*

*uuid*  
Secara acak menghasilkan UUID dalam format 128-bit standar. Tidak ada nilai yang perlu diteruskan dalam argumen.  
**Penggunaan**  
`{{uuid}}`  
**Contoh**  
`{{uuid}} `kembali  
**95f36680-152c-4052-99ec-cc3cdf7ca594**

## Partial sebaris
<a name="inlinepartials"></a>

Meskipun secara teknis bukan pembantu, sebagian inline adalah cara Setang untuk merampingkan templat yang menyertakan string berulang, yang lebih baik untuk digunakan kembali. [Untuk informasi lebih lanjut, lihat Bagian [sebaris di handlebarsjs.com](https://handlebarsjs.com/guide/partials.html#inline-partials).](https://handlebarsjs.com) 

**Penggunaan**

`{{#* inline "inlineName"}}Content to reuse{{/inline}}`

Untuk mereferensikan konten sebagian inline di tempat lain, gunakan:

` {{> inlineName}}`

**Contoh**

Contoh berikut membuat sebagian inline yang menyertakan nama depan penerima, dan, jika tersedia, nama belakang, dengan menambahkan kode berikut ke awal template:

`{{#* inline "fullName"}}`

`{{User.UserAttributes.FirstName.[0]}} {{#if User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}`

`{{/inline}}`

Setelah membuat `fullName` sebagian, Anda dapat memasukkannya di mana saja di template Anda dengan mendahului nama parsi dengan simbol `>` (lebih besar dari), diikuti oleh spasi, seperti pada contoh berikut:. `{{> fullName}}`

*` Hello {{> fullName}}`*

mengembalikan nama depan dan belakang pengguna jika benar - misalnya,*Hello Jane Doe*. Jika tidak, jika tidak ada nama belakang yang ditemukan, *Hello Jane* dikembalikan.

Setang menyertakan fitur tambahan di luar yang didokumentasikan di sini. Untuk informasi lebih lanjut, lihat [handlebarsjs.com](https://handlebarsjs.com/).

## Menggunakan variabel dengan pembantu template pesan
<a name="template-helpers-variables"></a>

Atribut kustom Amazon Pinpoint`User.UserAttributes.LastName`, seperti, disimpan sebagai daftar, terlepas dari apakah ada satu item atau beberapa item. Saat meneruskan daftar di helper yang mengharapkan string, Anda harus menentukan nilai indeks atribut bersama dengan nama atribut. Nilai indeks atribut ini menunjukkan posisi nilai dari daftar atribut: `.[0]` untuk entri pertama dalam daftar, `.[1]` untuk yang kedua, `.[2]` untuk yang ketiga, dan seterusnya. Misalnya, katakanlah Anda menggunakan `upper` helper untuk mengonversi entri (`[0]`) pertama `User.UserAttributes.LastName` ke semua huruf besar. Penggunaan helper adalah`{{upper value}}`, dan atribut diformat sebagai. `User.UserAttributes.LastName` Ganti *value* dengan nama atribut dan nilai indeks atribut `.[0]` sebagai berikut:`{{upper User.UserAttributes.LastName.[0]}}`. Respons kemudian mengembalikan `[0]` entri dari daftar, diformat dalam semua huruf besar. Misalnya, jika nilai `[0]` is*Santos*, respon kembali*SANTOS*. 

Amazon Pinpoint nama atribut kustom mendukung spasi. Untuk memiliki atribut kustom dipanggil`"Last Name"`, Anda harus memformat atribut sebagai`User.UserAttributes.[Last Name]`. Untuk mengakses entri pertama dalam daftar indeks atribut formatnya`User.UserAttributes.[Last Name].[0]`.

Nama atribut kustom dapat berisi hingga 50 karakter. Nilai atribut dapat berisi hingga 100 karakter. Saat Anda menentukan nama atribut kustom, hindari menggunakan karakter berikut: tanda angka (\$1), titik dua (:), tanda tanya (?) , garis miring terbalik (\$1), dan garis miring (/). Konsol Amazon Pinpoint tidak dapat menampilkan nama atribut yang berisi karakter ini. Pembatasan ini tidak berlaku untuk nilai atribut.

## Menggunakan pembantu bersarang
<a name="template-helpers-nesting"></a>

 Anda dapat bersarang beberapa pembantu template pesan dalam satu sama lain. Contoh berikut menunjukkan cara memformat dua pembantu:`{{ first helper (second helper)}}`. Pembantu kedua diproses terlebih dahulu, diikuti oleh penolong pertama. Ingatlah bahwa penolong pertama selalu menentukan output. Pembantu selanjutnya harus bersarang di dalam pembantu sebelumnya sebagai berikut:. `{{ first helper (second helper (third helper) )}}`

Contoh berikut menunjukkan cara membuat sarang dua pembantu **JANE** untuk diubah menjadi**Jane**:`{{capitalizeFirst (lower "JANE")}}`. `lower`pertama mengkonversi **JANE** ke**jane**. Kemudian `capitalizeFirst` mengkonversi **jane** ke**Jane**.

# Mengelola template pesan
<a name="message-templates-managing"></a>

Halaman **template Pesan** di konsol Amazon Pinpoint menyediakan satu lokasi bagi Anda untuk membuat, melihat, dan mengelola semua templat pesan untuk akun Amazon Pinpoint Anda di Wilayah saat ini. AWS Dengan menggunakan halaman ini, Anda dapat mengelola template pesan Anda sebagai satu koleksi. Ini dapat membantu Anda merancang pesan yang konsisten dan menggunakan kembali konten dengan lebih mudah dan efektif. Anda dapat menggunakan halaman ini untuk melakukan tugas-tugas manajemen seperti melihat dan mengedit template, dan menyalin, menghapus, dan membuat template.

**Topics**
+ [

# Melihat koleksi templat pesan
](message-templates-managing-view-all.md)
+ [

# Membuka template pesan
](message-templates-managing-open.md)
+ [

# Mengedit templat pesan
](message-templates-managing-edit.md)
+ [

# Menyalin template pesan
](message-templates-managing-copy.md)
+ [

# Menghapus template pesan
](message-templates-managing-delete.md)
+ [

# Menambahkan tag ke template
](message-templates-managing-add-tag.md)
+ [

# Menghapus tag dari template
](message-templates-managing-remove-tag.md)

Untuk informasi tentang membuat templat pesan, lihat [Membuat template email](message-templates-creating-email.md)[Membuat template pemberitahuan push](message-templates-creating-push.md),[Membuat template SMS](message-templates-creating-sms.md),[Membuat template suara](message-templates-creating-voice.md), atau, tergantung pada jenis templat yang ingin Anda buat.

Untuk informasi tentang melihat dan mengelola versi template, lihat[Mengelola versi templat pesan](message-templates-versioning.md).

# Melihat koleksi templat pesan
<a name="message-templates-managing-view-all"></a>

Halaman **template Pesan** menampilkan daftar semua templat pesan untuk akun Amazon Pinpoint Anda saat ini. Wilayah AWS Untuk menelusuri daftar atau menemukan templat tertentu dengan cepat, Anda dapat mengurutkan dan memfilter daftar, memilih kolom mana yang akan ditampilkan, dan mengubah pengaturan tampilan lainnya untuk daftar.

**Untuk melihat koleksi templat pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**. Halaman **template Pesan** membuka dan menampilkan jumlah template dalam koleksi Anda dan daftar template tersebut.

1. Untuk menyesuaikan daftar atau menemukan templat tertentu dengan cepat, pilih salah satu opsi berikut:
   + Untuk mengurutkan daftar berdasarkan jenis nilai tertentu, pilih judul kolom untuk nilai tersebut. Untuk mengubah urutan pengurutan dari naik ke turun atau sebaliknya, pilih judul kolom lagi. 
   + Untuk menerapkan filter yang hanya menampilkan jenis templat tertentu, gunakan pemilih saluran di bagian atas halaman untuk memilih saluran. Untuk menghapus filter, pilih **Semua saluran pesan** dari pemilih saluran.
   + Untuk menerapkan filter yang hanya menampilkan templat yang namanya berisi teks tertentu, masukkan teks di kotak **Pencarian** di atas daftar. Untuk menghapus filter, pilih **X** di kotak **Pencarian**.
   + Untuk mengubah jumlah templat yang ditampilkan dalam daftar, pilih ikon pengaturan di bagian atas halaman. Kemudian, untuk **ukuran Halaman**, pilih jumlah templat yang ingin Anda tampilkan, lalu pilih **Simpan perubahan**.
   + Untuk menambah atau menghapus kolom dari daftar, pilih ikon pengaturan di bagian atas halaman. Kemudian, untuk **Pilih kolom yang terlihat**, aktifkan atau nonaktifkan setiap kolom, lalu pilih **Simpan perubahan**.

# Membuka template pesan
<a name="message-templates-managing-open"></a>

Dengan menggunakan halaman **template Pesan**, Anda dapat dengan cepat menemukan dan membuka template pesan tertentu untuk melihat konten template dan informasi tentang template. Misalnya, Anda dapat melihat versi template saat ini dan sebelumnya, dan menentukan kapan template terakhir diperbarui. Setelah Anda membuka template, Anda juga dapat [mengedit template](message-templates-managing-edit.md).

**Untuk membuka template pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih templat yang ingin Anda buka. Halaman template membuka dan menampilkan informasi tentang template. Ini juga menampilkan isi dari versi aktif template.

1. Untuk melihat versi template yang berbeda, gunakan pemilih versi di bawah **Detail templat** untuk memilih versi yang ingin Anda lihat.

# Mengedit templat pesan
<a name="message-templates-managing-edit"></a>

Anda dapat membuka template pesan untuk diedit dengan dua cara: saat Anda membuat pesan yang menggunakan templat, dan dengan menggunakan halaman **Templat pesan**. Topik ini menjelaskan cara membuka dan mengedit templat menggunakan halaman **Templat pesan**.

Jika Anda mengedit templat, Amazon Pinpoint mungkin menerapkan perubahan Anda ke pesan yang ada yang menggunakan templat dan belum dikirim, seperti pesan kampanye yang dijadwalkan akan dikirim di lain waktu. Hal ini tergantung pada apakah Anda mengedit versi aktif dari template dan bagaimana Anda mengkonfigurasi pesan yang menggunakan template. Untuk informasi selengkapnya, lihat [Mengelola versi templat pesan](message-templates-versioning.md).

**Untuk mengedit template pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih templat yang ingin Anda edit. Halaman template membuka dan menampilkan informasi tentang template. Ini juga menampilkan konten dan pengaturan untuk versi aktif template.

1. Pilih **Edit**.

1. Di bawah **Detail templat**, gunakan pemilih versi untuk memilih versi templat yang ingin Anda gunakan sebagai titik awal untuk perubahan Anda. Jika Anda memilih versi terbaru dari template, Anda dapat menyimpan perubahan Anda langsung ke versi template tersebut. Jika tidak, Anda dapat menyimpan perubahan Anda sebagai versi baru dari template.

1. Buat perubahan yang Anda inginkan. Anda dapat mengubah salah satu konten atau pengaturan template, kecuali nama template. Untuk mengubah nama template, Anda dapat [membuat salinan template](message-templates-managing-copy.md), menyimpan salinan dengan nama yang Anda inginkan, dan kemudian secara opsional menghapus template asli.

1. Setelah Anda selesai melakukan perubahan, lakukan salah satu hal berikut:
   + Untuk menyimpan perubahan Anda sebagai versi baru dari template, pilih **Simpan sebagai versi baru**. Untuk membantu memastikan bahwa perubahan Anda tidak memengaruhi pesan yang ada, sebaiknya pilih opsi ini.
   + Untuk menyimpan perubahan Anda sebagai pembaruan ke versi terbaru template, pilih **Perbarui versi**. Opsi ini hanya tersedia jika Anda memilih versi terbaru dari template di langkah 5. Jika Anda memilih opsi ini, perubahan Anda mungkin memengaruhi pesan yang ada yang menggunakan templat.

# Menyalin template pesan
<a name="message-templates-managing-copy"></a>

Untuk membuat template pesan baru dengan cepat yang mirip dengan template yang ada, Anda dapat membuat salinan template. Anda kemudian dapat mengedit salinan template tanpa mengubah template asli.

**Untuk menyalin templat pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih kotak centang di sebelah templat yang ingin Anda salin.

1. Pada menu **Tindakan**, pilih **Duplikat.**

1. Untuk **nama Template**, masukkan nama untuk salinan template. Nama harus dimulai dengan huruf atau angka. Ini dapat berisi hingga 128 karakter. Karakter dapat berupa huruf, angka, garis bawah (\$1), atau tanda hubung (‐). 

1. Setelah Anda selesai memasukkan nama, pilih **Template duplikat**. Halaman template membuka dan menampilkan semua konten dan pengaturan untuk versi aktif template yang Anda salin.

1. (Opsional) Untuk mengubah salinan templat, pilih **Edit**, buat perubahan yang Anda inginkan, lalu pilih **Simpan sebagai versi baru**.

# Menghapus template pesan
<a name="message-templates-managing-delete"></a>

Jika Anda ingin menghapus template pesan dari Amazon Pinpoint sepenuhnya, Anda dapat menghapus template. Jika Anda menghapus templat, itu tidak memengaruhi pesan yang ada yang menggunakan templat, seperti pesan kampanye yang dijadwalkan untuk dikirim di lain waktu.

**Awas**  
Jika Anda menghapus templat, Amazon Pinpoint akan menghapus semua versi, konten, dan pengaturan untuk templat tersebut. Selain itu, template menjadi tidak tersedia untuk semua pesan future. Anda tidak dapat memulihkan template setelah Anda menghapusnya. 

**Untuk menghapus template pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih kotak centang di samping setiap templat yang ingin Anda hapus.

1.  Dari menu **Tindakan**, pilih **Hapus**.

# Menambahkan tag ke template
<a name="message-templates-managing-add-tag"></a>

Tag adalah label yang dapat Anda tentukan dan kaitkan dengan AWS sumber daya, termasuk jenis sumber daya Amazon Pinpoint tertentu.

Menambahkan tag ke templat dapat membantu Anda mengkategorikan dan mengelola templat dengan berbagai cara, seperti berdasarkan tujuan, pemilik, lingkungan, atau kriteria lainnya. Anda dapat menggunakan tag untuk menemukan templat yang ada dengan cepat, atau untuk mengontrol pengguna mana yang dapat mengakses templat tertentu. Anda dapat menambahkan paling banyak 50 pasangan kunci-nilai, dengan setiap kunci menjadi unik.

**Untuk menambahkan tag**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih templat yang ingin Anda tambahkan tag.

1. Di bagian **Tanda**, pilih **Kelola tanda**.

1. Pilih **Tambahkan tag baru**.

1. Masukkan kunci tag dan pasangan nilai yang ingin Anda tambahkan.

1. (Opsional) Untuk menambahkan tag tambahan, pilih **Tambahkan tag baru**.

1. Setelah selesai, pilih **Simpan tag**.

# Menghapus tag dari template
<a name="message-templates-managing-remove-tag"></a>

Jika Anda tidak lagi memerlukan tag untuk diterapkan ke template, Anda dapat menghapusnya melalui konsol. 

**Untuk menghapus tag**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih templat yang ingin Anda hapus tag.

1. Di bagian **Tanda**, pilih **Kelola tanda**.

1. Di samping tag yang ingin Anda hapus, pilih **Hapus**.

1. Pilih **Simpan tag**.

Untuk informasi selengkapnya tentang cara menggunakan tag dalam kebijakan IAM, lihat [Mengelola tag](https://docs.aws.amazon.com/pinpoint/latest/developerguide/tagging-resources.html).

# Mengelola versi templat pesan
<a name="message-templates-versioning"></a>

Untuk membantu Anda mengelola pengembangan dan penggunaan templat pesan individual, Amazon Pinpoint mendukung pembuatan versi untuk semua jenis templat pesan. Versioning menyediakan cara bagi Anda untuk membuat riwayat perubahan pada template—setiap versi adalah snapshot dari template pada titik waktu tertentu. Versioning juga menyediakan cara bagi Anda untuk mengontrol konten dan pengaturan pesan yang menggunakan template.

Setiap kali Anda mengubah template, Anda dapat menentukan apakah Anda ingin menyimpan perubahan Anda sebagai versi baru dari template atau sebagai pembaruan ke versi terbaru dari template yang sudah ada. Saat Anda mendesain, mengembangkan, dan menyempurnakan template, masing-masing versi ini berfungsi sebagai snapshot yang dapat membantu Anda melacak kemajuan dan status template. Artinya, Anda dapat menggunakan versi untuk menyimpan, melacak, dan mengelola template saat berubah seiring waktu. Anda dapat:
+ **Lacak riwayat template** - Untuk setiap template, Amazon Pinpoint menyediakan daftar versi template. Daftar ini menampilkan nama setiap versi, dan ini menunjukkan kapan setiap versi terakhir diubah. Daftar ini diurutkan dalam urutan kronologis menurun dengan versi terbaru terdaftar terlebih dahulu.
+ **Melihat dan membandingkan versi template** — Dengan menggunakan daftar versi, Anda dapat menelusuri versi template sebelumnya. Jika Anda memilih versi dari daftar, Amazon Pinpoint menampilkan konten dan pengaturan yang disimpan dalam versi tersebut.
+ **Memulihkan versi template sebelumnya** — Jika Anda menemukan masalah dalam versi terbaru dari template, Anda dapat membuka dan mengedit versi sebelumnya yang tidak mengandung masalah. Anda kemudian dapat menyimpan versi sebelumnya sebagai versi baru dari template. Versi baru kemudian menjadi versi terbaru dari template.

Anda juga dapat menggunakan versi untuk mengontrol versi template mana yang dapat digunakan dalam pesan. Anda melakukan ini dengan menunjuk versi tertentu sebagai *versi aktif* dari template. *Versi aktif* biasanya merupakan versi yang paling baru ditinjau dan disetujui untuk digunakan dalam pesan, tergantung pada alur kerja organisasi Anda untuk mengembangkan dan mengelola templat. 

Saat Anda menetapkan versi sebagai versi aktif, Anda mengaktifkan versi tersebut untuk digunakan dalam pesan. Saat template berubah seiring waktu, Anda dapat menetapkan versi yang berbeda sebagai versi aktif, dan Anda dapat mengubah penunjukan itu beberapa kali. 

**catatan**  
Jika Anda perlu mengedit template yang sedang digunakan secara aktif, kami sarankan Anda membuat versi baru dari template. 

**Topics**
+ [

## Cara kerja pembuatan versi
](#message-templates-versioning-overview)
+ [

## Melihat versi template pesan
](#message-templates-versioning-view-versions)
+ [

## Melihat versi aktif dari template pesan
](#message-templates-versioning-view-active)
+ [

## Menunjuk versi aktif dari template pesan
](#message-templates-versioning-set-active)
+ [

## Mengedit versi aktif dari template pesan
](#message-templates-versioning-edit-active)

## Cara kerja pembuatan versi
<a name="message-templates-versioning-overview"></a>

Dalam alur kerja pengembangan yang khas, template pesan memiliki banyak versi. Versi ini meluas dari awal desain dan pengembangan melalui pengujian, peninjauan, dan, pada akhirnya, persetujuan untuk digunakan dalam pesan. Dalam beberapa kasus, Anda dapat membuat dan menyetujui versi tambahan setelah persetujuan awal, saat Anda menyempurnakan dan memperbarui templat. Misalnya, Anda dapat menambahkan tautan atau mengubah tata letak templat sebagai respons terhadap data analitik untuk kampanye yang menggunakan templat.

### Penomoran versi
<a name="message-templates-versioning-overview-numbering"></a>

Ketika Anda membuat template, hanya ada satu versi template- *Versi 1*. Setiap kali Anda kemudian mengubah template, Anda menentukan apakah Anda ingin menyimpan perubahan Anda sebagai versi baru dari template, atau sebagai pembaruan ke versi terbaru dari template. 

Jika Anda menyimpan perubahan Anda sebagai versi baru, Amazon Pinpoint secara otomatis menambah nomor versi dengan 1 dan menetapkan nomor versi itu ke versi— *Versi 1* untuk versi pertama, Versi *2 untuk versi* kedua, Versi *3 untuk versi* ketiga, dan seterusnya. Nomor versi tidak pernah digunakan kembali. Anda dapat menyimpan sebanyak 5.000 versi template.

Jika Anda menyimpan perubahan sebagai pembaruan ke versi terbaru, Amazon Pinpoint menimpa versi terbaru untuk menyertakan perubahan Anda. Untuk memastikan bahwa Anda memiliki tampilan riwayat template yang akurat, Anda hanya dapat menimpa versi terbaru dari template dengan menggunakan konsol Amazon Pinpoint. Anda tidak dapat menimpa versi template sebelumnya dengan menggunakan konsol.

### Versi terbaru dan aktif
<a name="message-templates-versioning-overview-version-types"></a>

Untuk mendukung pengembangan template jangka panjang dan berkelanjutan, dua versi templat dapat diperbarui pada saat yang bersamaan. Mereka adalah: versi *terbaru*, yang merupakan versi yang paling baru diubah, dan versi *aktif*, yang merupakan versi yang dapat digunakan dalam pesan.

Bergantung pada alur kerja organisasi Anda, versi aktif biasanya merupakan versi yang paling baru ditinjau dan disetujui untuk digunakan dalam pesan. Ini belum tentu versi terbaru dari template. Selain itu, versi apa pun selain versi aktif dianggap sebagai versi draf atau arsip template. Ini berarti bahwa Anda hanya dapat menggunakan versi aktif template dalam pesan yang Anda buat dengan menggunakan konsol Amazon Pinpoint.

Misalnya, Anda dapat membuat beberapa versi template saat Anda mendesain dan mengembangkan template. Ketika versi terbaru template selesai dan disetujui untuk digunakan dalam pesan, Anda dapat menetapkan versi tersebut sebagai versi aktif dari template. Anda kemudian dapat menggunakan versi aktif template dalam pesan. Jika nanti Anda memutuskan untuk mengubah templat, Anda dapat membuat versi tambahan untuk perubahan tersebut, tanpa memengaruhi versi aktif templat atau pesan apa pun yang ada yang menggunakan templat. 

Dari semua versi template, satu versi harus ditetapkan sebagai versi aktif dari template. Saat template berubah seiring waktu, Anda dapat menetapkan versi yang berbeda sebagai versi aktif, dan Anda dapat mengubah penunjukan itu beberapa kali. 

### Pengaturan versi untuk pesan
<a name="message-templates-versioning-overview-versions-messages"></a>

Untuk menggunakan versi templat tertentu dalam pesan, versi tersebut harus berupa versi aktif templat saat Anda membuat pesan atau saat Amazon Pinpoint mengirim pesan. Hal ini tergantung pada bagaimana Anda mengkonfigurasi pesan untuk menggunakan template. Saat Anda membuat pesan dan memilih templat untuk itu, Anda memiliki dua opsi:
+ **Gunakan versi yang saat ini aktif** — Jika Anda memilih opsi ini, Amazon Pinpoint selalu mengirimkan konten dan pengaturan pesan yang sama, seperti yang ditentukan dalam versi templat yang aktif saat Anda membuat pesan. Ini berarti bahwa pesan tetap sama, terlepas dari perubahan apa pun yang Anda buat pada template nanti.
+ **Gunakan versi yang aktif saat pesan dikirim** - Jika Anda memilih opsi ini, Amazon Pinpoint secara otomatis memperbarui konten dan pengaturan pesan agar sesuai dengan versi templat mana pun yang aktif saat mengirim pesan. Ini berarti bahwa pesan berubah jika Anda menetapkan versi yang berbeda sebagai versi aktif setelah Anda membuat pesan.

Misalnya, jika Anda melakukan hal berikut:

1. Buat *Versi 1* dari template. 

1. Tentukan *Versi 1* sebagai versi aktif dari template.

1. Buat pesan yang menggunakan templat dan jadwalkan pesan yang akan dikirim di lain waktu.

1. Ubah template beberapa kali.

1. Tentukan versi baru (*Versi 5*) sebagai versi aktif dari template.

Amazon Pinpoint melakukan hal berikut untuk setiap opsi saat mengirim pesan:
+ **Gunakan versi yang saat ini aktif** — Jika Anda memilih opsi ini untuk pesan, Amazon Pinpoint menggunakan konten dan pengaturan yang ditentukan oleh *Versi 1* template. Hal ini dilakukan karena *Versi 1* adalah versi aktif dari template ketika pesan dibuat.
+ **Gunakan versi yang aktif saat pesan dikirim** - Jika Anda memilih opsi ini untuk pesan, Amazon Pinpoint secara otomatis memperbarui pesan untuk menggunakan konten dan pengaturan yang ditentukan oleh *Versi 5* template. Hal ini dilakukan karena *Versi 5* adalah versi aktif dari template ketika pesan dikirim.

Jika Anda ingin memastikan bahwa perubahan pada templat tidak memengaruhi pesan yang ada yang belum Anda kirim, sebaiknya konfigurasikan pesan agar menggunakan versi templat yang aktif saat pesan dibuat, bukan dikirim. Atau, jika Anda ingin terus mengembangkan templat setelah Anda mulai menggunakannya dalam pesan, Anda dapat [membuat salinan templat](message-templates-managing-copy.md), lalu mengedit dan menggunakan salinan templat dalam pesan baru.

## Melihat versi template pesan
<a name="message-templates-versioning-view-versions"></a>

Dengan menggunakan halaman **template Pesan**, Anda dapat dengan cepat menemukan dan membuka template pesan tertentu. Anda kemudian dapat melihat daftar versi yang ada untuk template. Dari daftar itu, Anda dapat memilih versi tertentu untuk melihat konten dan pengaturan untuk versi template tersebut.

**Untuk melihat versi template pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih templat yang versinya ingin Anda lihat. Halaman template membuka dan menampilkan informasi tentang template. Ini juga menampilkan konten dan pengaturan untuk versi aktif template.

1. Di bawah **Detail Template**, buka pemilih versi untuk menampilkan daftar versi untuk template.

1. Untuk melihat konten dan pengaturan untuk versi tertentu, gunakan pemilih versi untuk memilih versi. Setelah Anda memilih versi, Amazon Pinpoint menampilkan konten dan pengaturan untuk versi template tersebut.

## Melihat versi aktif dari template pesan
<a name="message-templates-versioning-view-active"></a>

Anda dapat melihat versi aktif template pesan dengan dua cara: saat Anda membuat pesan yang menggunakan templat, dan dengan menggunakan halaman **Templat pesan**. Untuk melihat versi aktif templat saat Anda membuat pesan, pilih templat untuk pesan tersebut. Amazon Pinpoint secara otomatis menampilkan pratinjau versi aktif template. 

Untuk melihat versi aktif template menggunakan halaman **Templat pesan**, ikuti langkah-langkah dalam topik ini.

**Untuk melihat versi aktif template pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih templat yang versi aktifnya ingin Anda lihat. Halaman template membuka dan menampilkan informasi tentang template. Ini juga menampilkan konten dan pengaturan untuk versi aktif template. Di bawah **Detail Template**, perhatikan bahwa **VERSI AKTIF** muncul (berwarna hijau) di sebelah nama versi di pemilih versi.

1. Untuk melihat versi template yang berbeda, gunakan pemilih versi di bawah **Detail templat** untuk memilih versi yang Anda inginkan. Untuk melihat versi aktif lagi, gunakan pemilih versi untuk memilih versi yang menampilkan **VERSI AKTIF** (berwarna hijau) di samping nama versi.

## Menunjuk versi aktif dari template pesan
<a name="message-templates-versioning-set-active"></a>

Saat Anda membuat template pesan, Amazon Pinpoint secara otomatis menetapkan versi pertama template sebagai versi aktif template. Saat Anda membuat dan mengembangkan versi template berikutnya, Anda dapat menunjuk versi yang berbeda sebagai versi aktif template, dan Anda dapat mengubah penunjukan itu beberapa kali.

Sebelum Anda menetapkan versi sebagai versi aktif template, ada baiknya untuk memverifikasi bahwa semua konten dan pengaturan dalam versi aktif yang diusulkan sudah lengkap dan siap digunakan.

Ini juga merupakan ide yang baik untuk memverifikasi bahwa perbedaan antara versi aktif saat ini dan yang diusulkan tidak akan memengaruhi pesan yang ada dengan cara yang tidak terduga atau tidak diinginkan. Jika Anda menetapkan versi yang berbeda sebagai versi aktif, Amazon Pinpoint mungkin menerapkan perubahan Anda ke pesan yang ada yang menggunakan templat dan belum dikirim. Hal ini tergantung pada bagaimana Anda mengkonfigurasi pesan yang menggunakan template. Untuk informasi selengkapnya, lihat [Pengaturan versi untuk pesan](#message-templates-versioning-overview-versions-messages).

Jika template digunakan dalam pesan yang belum dikirim, bandingkan versi yang saat ini aktif dengan versi yang ingin Anda aktifkan. Juga, tinjau aktivitas perjalanan dan kampanye apa pun yang menggunakan templat. Kemudian, edit template seperlunya untuk mengatasi masalah apa pun yang Anda temukan sebelum Anda menetapkan versi yang berbeda sebagai versi aktif.

Jika Anda khawatir tentang efek penunjukan versi yang berbeda sebagai versi aktif, Anda dapat [membuat salinan template](message-templates-managing-copy.md) sebagai gantinya. Anda kemudian dapat mengedit dan menggunakan salinan templat dalam pesan baru.

**Untuk menunjuk versi aktif dari template pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih templat yang ingin Anda tentukan untuk versi aktifnya. Halaman template membuka dan menampilkan informasi tentang template. Ini juga menampilkan konten dan pengaturan untuk versi yang saat ini merupakan versi aktif dari template. 

1. Di bawah **Detail templat**, gunakan pemilih versi untuk memilih versi yang ingin Anda tetapkan sebagai versi aktif. Setelah Anda memilih versi, Amazon Pinpoint menampilkan konten dan pengaturan untuk versi template tersebut.

1. Pilih **Buat versi aktif**.

Versi aktif baru dari template sekarang tersedia untuk digunakan dalam pesan baru. Selain itu, ini digunakan dalam pesan yang ada yang belum dikirim dan dikonfigurasi untuk menggunakan versi template yang aktif saat pesan dikirim.

## Mengedit versi aktif dari template pesan
<a name="message-templates-versioning-edit-active"></a>

Sebelum Anda mengedit versi aktif template, penting untuk diingat bahwa hanya versi aktif template yang dapat digunakan dalam pesan yang Anda buat dengan menggunakan konsol Amazon Pinpoint. Untuk alasan ini, ada baiknya untuk memverifikasi terlebih dahulu bahwa perubahan Anda telah selesai dan siap digunakan.

Ini juga merupakan ide yang baik untuk memverifikasi bahwa perubahan Anda tidak akan memengaruhi pesan yang ada dengan cara yang tidak terduga atau tidak diinginkan. Amazon Pinpoint mungkin menerapkan perubahan Anda ke pesan yang ada yang menggunakan template dan belum dikirim. Hal ini tergantung pada bagaimana Anda mengkonfigurasi pesan yang menggunakan template. Untuk informasi selengkapnya, lihat [Pengaturan versi untuk pesan](#message-templates-versioning-overview-versions-messages).

Untuk menentukan bagaimana perubahan Anda dapat memengaruhi pesan yang ada, tinjau konten dan setelan untuk versi templat yang saat ini aktif. Juga, tinjau aktivitas perjalanan dan kampanye apa pun yang menggunakan templat. Kemudian, pertimbangkan perubahan yang Anda rencanakan untuk dibuat dan pastikan bahwa perubahan Anda selaras dengan sasaran Anda untuk pesan yang ada yang menggunakan templat. 

Terakhir, jika Anda khawatir tentang efek mengedit versi aktif template, Anda dapat [membuat salinan template](message-templates-managing-copy.md) sebagai gantinya. Anda kemudian dapat mengedit dan menggunakan salinan templat dalam pesan yang Anda buat nanti.

**Untuk mengedit versi aktif template pesan**

1. Buka konsol Amazon Pinpoint di. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Di panel navigasi, pilih **Template pesan**.

1. Pada halaman **Templat pesan**, pilih templat yang versi aktifnya ingin Anda edit. Halaman template membuka dan menampilkan informasi tentang template. Ini juga menampilkan konten dan pengaturan untuk versi yang saat ini ditetapkan sebagai versi aktif template. 

1. Pilih **Edit**.

1. Di bawah **Detail Template**, gunakan pemilih versi untuk memastikan bahwa Anda mengedit versi aktif template. **VERSI AKTIF** muncul (berwarna hijau) di sebelah nama versi aktif. 

1. Buat perubahan yang Anda inginkan, lalu pilih **Simpan sebagai versi baru**.

1. Di bawah **Detail template**, gunakan pemilih versi untuk memilih versi template yang Anda buat pada langkah sebelumnya.

1. Pilih **Buat versi aktif**.

Versi aktif baru dari template sekarang tersedia untuk digunakan dalam pesan baru. Selain itu, ini digunakan dalam pesan yang ada yang belum dikirim dan dikonfigurasi untuk menggunakan versi template yang aktif saat pesan dikirim.