Template dan variabel

Template memungkinkan Anda menggunakan kembali HTML email dan mengganti variabel pada subjek serta isi saat pengiriman. Pelanggan dapat membuat, mengedit, dan mengajukan template di konsol, lalu menggunakan template yang telah disetujui dan diaktifkan melalui API.

Membuat template di konsol

1. Buka Template Email dan klik Template Baru.
2. Pilih Pemasaran atau Transaksional. Kategori tidak dapat diubah setelah pembuatan. Gunakan pemasaran untuk promosi dan transaksional untuk kode verifikasi, pesanan, serta pemberitahuan layanan.
3. Pilih bahasa template. Buat template terpisah untuk setiap bahasa yang diperlukan; template.language pada API tidak mengganti bahasa secara otomatis.
4. Tempel dan pratinjau konten di editor HTML. Jika AI Assistant diaktifkan untuk akun Anda, Anda dapat membuat atau merevisi HTML dengan AI. Terapkan proposal AI ke draf dan simpan sebelum review; pembuatan konten bukan persetujuan.
5. Simpan draf dan klik Ajukan untuk Review. Platform meninjau versi saat ini. Perubahan berikutnya membuat versi baru yang harus ditinjau kembali.

Status review

Salin templateId dari daftar untuk penggunaan API. Sebelum menghapus template, pastikan tidak ada kampanye atau sistem bisnis yang menggunakannya.

Sintaks variabel

Variabel menggunakan kurung kurawal ganda:

Hello {{firstName}}, your order {{orderNo}} has been confirmed.

• Nama diawali huruf dan selanjutnya dapat berisi huruf, angka, garis bawah, titik, dan tanda hubung, maksimal 64 karakter.
• Titik merupakan bagian dari kunci literal: {{user.name}} membaca kunci "user.name", bukan otomatis menelusuri objek bersarang.
• Hanya penggantian literal yang didukung, bukan kondisi, perulangan, atau ekspresi.
• Subjek dan isi template dirender. text/html langsung tanpa template tidak dirender.
• Nilai string dan angka disarankan. Escape nilai dinamis dengan tepat untuk HTML agar tidak merusak tata letak atau menambahkan markup tidak aman.

Untuk tautan berhenti berlangganan pemasaran, gunakan {{unsubscribe_url}} atau singkatan kompatibel {{unsubscribe}}. Lihat Email pemasaran dan berhenti berlangganan.

Menggunakan template melalui API

{
  "from": {"email": "notify@example.com", "name": "Example"},
  "to": [{"email": "alice@example.net"}],
  "subject": "Order {{orderNo}} confirmed",
  "messageType": "TRANSACTIONAL",
  "variables": {
    "customerName": "Alice"
  },
  "template": {
    "templateId": "tpl_order_confirmation",
    "variables": {
      "orderNo": "ORDER-20261111-001"
    }
  }
}

• subject wajib dan dapat berisi variabel.
• Jangan memberikan text/html yang tidak kosong bersama dengan template.
• variables tingkat atas memberikan nilai umum; kunci yang sama di template.variables didahulukan.
• messageType harus sesuai dengan tujuan template atau pesan dapat ditolak setelah penerimaan.
• template.language adalah field cadangan dan saat ini tidak memilih bahasa. Abaikan dan gunakan templateId untuk bahasa yang diinginkan.

Variabel yang hilang dan hasil

HTTP 202 hanya menunjukkan penerimaan. Template nonaktif, versi yang belum ditinjau, variabel hilang, dan konflik tipe dapat gagal kemudian. Periksa Catatan dan status pengiriman.

Pertanyaan umum

Mengapa variabel tidak mengubah isi? Hanya pengiriman template yang merender variabel. Render konten langsung di sistem Anda terlebih dahulu.

Mengapa template yang disetujui masih tidak dapat dikirim? Periksa apakah template telah diaktifkan, tidak diubah setelah persetujuan, dan versi saat ini sama dengan versi yang ditinjau.

Dapatkah saya mengirim konten langsung dan template bersamaan? Tidak. Pilih salah satu mode.

Dapatkah saya mengunggah lampiran melalui API? Tidak ada unggahan lampiran atau penyimpanan konten yang dapat digunakan, dan referensi lampiran tidak menghasilkan pengiriman lampiran aktual.

Sumber terkait