Template Email Lanjutan

Email

·

25 Mar 2016

Template Email Lanjutan

Poin Penting

    • Template SparkPost mendukung komposisi email sederhana dan lanjutan, termasuk HTML, teks, logika kondisional, loop, dan data dinamis per penerima melalui variabel substitusi.

    • Array dapat diberikan ke data substitusi, memungkinkan Anda untuk melakukan loop melalui item (misalnya, daftar file, aktivitas terbaru, baris tabel kustom) untuk menghasilkan bagian yang dipersonalisasi untuk setiap penerima.

    • Tiga kurung kurawal {{{ }}} memungkinkan Anda untuk menyisipkan HTML mentah yang tidak di-escape, yang penting ketika data substitusi Anda sudah mengandung markup.

    • Lampiran dapat dikirim dengan mudah saat menggunakan endpoint transmisi (content.attachments), yang mengabstraksi batas MIME dan encoding untuk Anda.

    • Gambar inline bekerja serupa dengan lampiran tetapi dirender dalam body menggunakan referensi cid:.

    • Template itu sendiri tidak mendukung lampiran secara native, tetapi Anda dapat tetap menyertakannya dengan membuat email RFC 5322 lengkap dengan bagian MIME dan menyimpan itu sebagai template email_rfc822.

    • Ketika membangun template RFC 5322 mentah, substitusi masih berfungsi — tetapi hanya di header, dan bagian MIME HTML dan teks pertama.

    • Menggunakan klien email bahasa pemrograman Anda (misalnya, JavaMail) menawarkan jalur lain: menghasilkan email MIME lengkap secara programatis dan mengirim melalui API transmisi SparkPost.

    • Untuk pemeliharaan, jaga markup dan data terpisah kapan pun memungkinkan—terutama saat membangun template yang mencakup loop atau beberapa bagian MIME.

    • Fitur template lanjutan (kondisional, ekspresi, iterasi array) memungkinkan pengembang untuk membangun email yang canggih dan dipersonalisasi tanpa harus menulis ulang seluruh template per kasus penggunaan.

Sorotan Tanya jawab

  • Apakah template SparkPost dapat menangani loop dan array?

    Ya. Template dapat mengiterasi array menggunakan konstruksi for each. Ini memungkinkan tabel dinamis, daftar, atau blok HTML yang diulang untuk setiap penerima.

  • Untuk apa tiga kurung kurawal digunakan?

    {{{ variable }}} menyisipkan HTML mentah tanpa pengkodean. Ini diperlukan ketika data penggantian Anda sudah termasuk markup HTML.

  • Bisakah saya mengirim lampiran dengan template?

    Tidak secara langsung melalui bidang template — tetapi Anda dapat dengan menyimpan template email_rfc822 yang menyertakan bagian lampiran MIME.

  • Apakah substitusi masih berfungsi dalam template RFC 5322?

    Ya, tetapi hanya dalam header dan bagian MIME HTML + teks pertama.

  • Kapan saya harus menggunakan endpoint transmisi daripada template?

    Ketika mengirim lampiran dinamis, gambar inline, atau ketika Anda memerlukan SparkPost untuk mengelola MIME secara otomatis.

  • Apakah lebih baik untuk menyematkan logika tampilan atau menyimpannya terpisah?

    Praktik terbaik adalah menjaga markup tampilan dan data Anda terpisah. Gunakan template untuk presentasi dan kirimkan data pengganti yang bersih dan terstruktur.

  • Bisakah saya menghasilkan email MIME lengkap menggunakan pustaka pemrograman?

    Ya. Perpustakaan seperti JavaMail memungkinkan Anda untuk menyusun pesan RFC 5322 secara programatis dan mengirimkannya melalui API transmisi SparkPost.

  • Apakah fitur template lanjutan banyak digunakan?

    Secara mengejutkan, sedikit pengembang yang menggunakannya, tetapi mereka membuka personalisasi yang kuat: loop, kondisional, logika inline, dan struktur MIME kustom.

  • Mengapa saya perlu template RFC 5322?

    Hanya ketika mengirim email multi-bagian yang kompleks (lampiran, jenis MIME kustom) yang tidak didukung oleh abstraksi template standar SparkPost.

Post ini ditujukan kepada pengembang yang ingin memanfaatkan kemampuan template email SparkPost. Diasumsikan Anda nyaman dengan membaca konten JSON dan mengikuti alur pemrograman dasar. Saat istilah yang mungkin baru bagi Anda diperkenalkan seperti RFC 5322, teks tersebut terhubung dengan referensi sumbernya.

Dengan itu di luar jalan, mari kita langsung masuk.

Kemampuan template dan transmisi SparkPost membuat pengiriman email menjadi mudah. Kemampuan tersebut memberikan abstraksi untuk konten teks dan HTML yang berarti sebagian besar waktu tidak perlu secara langsung mengkodekan format email mentah yang didefinisikan dalam RFC 5322 yang sebelumnya dikenal sebagai (RFC 822). Namun terkadang Anda mungkin ingin membuat pesan yang lebih kompleks yang memiliki bagian Multipurpose Internet Mail Extensions (MIME) lain yang tidak langsung terpapar melalui antarmuka RESTful SparkPost.

Mengirim Template

Berita baiknya adalah bahwa membuat konten RFC 5322 adalah bagian yang sulit. Mulai sekarang, mengirimkan template itu dengan SparkPost persis sama seperti mengirimkan template lainnya.

Berikut adalah cara kita mengirimkan template itu dan mengisi data substitusi:

{
  "campaign_id": "MyCampaign",
  "return_path": "myReturnPath@yourdomain.com",
  "substitution_data": {
    "replyto": "myReplyToh@yourdomain.com",
    "from": "MyFrom@yourdomain.com",
    "subject": "my subject",
    "body1": "Extra content for the HTML part",
    "body2": "Extra content for the text part"
  },
  "recipients": [
    {
      "substitution_data": {},
      "address": {
        "email": "test1@domain.com",
        "name": "test1"
      }
    }
  ],
  "content": {
    "template_id": "xxxxxxx",
    "use_draft_template": true
  }
}

Berita baiknya adalah bahwa membuat konten RFC 5322 adalah bagian yang sulit. Mulai sekarang, mengirimkan template itu dengan SparkPost persis sama seperti mengirimkan template lainnya.

Berikut adalah cara kita mengirimkan template itu dan mengisi data substitusi:

{
  "campaign_id": "MyCampaign",
  "return_path": "myReturnPath@yourdomain.com",
  "substitution_data": {
    "replyto": "myReplyToh@yourdomain.com",
    "from": "MyFrom@yourdomain.com",
    "subject": "my subject",
    "body1": "Extra content for the HTML part",
    "body2": "Extra content for the text part"
  },
  "recipients": [
    {
      "substitution_data": {},
      "address": {
        "email": "test1@domain.com",
        "name": "test1"
      }
    }
  ],
  "content": {
    "template_id": "xxxxxxx",
    "use_draft_template": true
  }
}

Berita baiknya adalah bahwa membuat konten RFC 5322 adalah bagian yang sulit. Mulai sekarang, mengirimkan template itu dengan SparkPost persis sama seperti mengirimkan template lainnya.

Berikut adalah cara kita mengirimkan template itu dan mengisi data substitusi:

{
  "campaign_id": "MyCampaign",
  "return_path": "myReturnPath@yourdomain.com",
  "substitution_data": {
    "replyto": "myReplyToh@yourdomain.com",
    "from": "MyFrom@yourdomain.com",
    "subject": "my subject",
    "body1": "Extra content for the HTML part",
    "body2": "Extra content for the text part"
  },
  "recipients": [
    {
      "substitution_data": {},
      "address": {
        "email": "test1@domain.com",
        "name": "test1"
      }
    }
  ],
  "content": {
    "template_id": "xxxxxxx",
    "use_draft_template": true
  }
}

Komposisi Email Sederhana

Pertama, mari kita tinjau skenario hari cerah untuk mengirim email. Gunakan transmission endpoint untuk menyediakan text dan HTML konten. Di belakang layar, SparkPost menangani penyusunan email RFC 5322 yang valid. SparkPost akan menyisipkan variabel substitusi dari substitution_data ke dalam teks dan konten HTML. Ini adalah cara yang kuat untuk menghasilkan konten kustom bagi setiap penerima dalam template yang umum.

Berikut adalah contoh transmission dengan konten HTML dan teks dengan substitution_data.

{
  "options": {
    "open_tracking": true,
    "click_tracking": true
  },
  "campaign_id": "christmas_campaign",
  "return_path": "bounces-christmas-campaign@domain.com",
  "metadata": {
    "user_type": "students"
  },
  "substitution_data": {
    "sender": "Big Store Team"
  },
  "recipients": [
    {
      "return_path": "123@bounces.domain.com",
      "address": {
        "email": "wilma@domain.com",
        "name": "Wilma Flintstone"
      },
      "tags": [
        "greeting",
        "prehistoric",
        "fred",
        "flintstone"
      ],
      "metadata": {
        "place": "Bedrock"
      },
      "substitution_data": {
        "customer_type": "Platinum"
      }
    }
  ],
  "content": {
    "from": {
      "name": "Fred Flintstone",
      "email": "fred@domain.com"
    },
    "subject": "Big Christmas savings!",
    "reply_to": "Christmas Sales <sales@domain.com>",
    "headers": {
      "X-Customer-Campaign-ID": "christmas_campaign"
    },
    "text": "Hi {{address.name}} \nSave big this Christmas in your area {{place}}! \nClick http://www.mysite.com and get huge discount\n Hurry, this offer is only to {{user_type}}\n {{sender}}",
    "html": "<p>Hi {{address.name}} <br>Save big this Christmas in your area {{place}}! <br>Click <a href=\"http://www.mysite.com\">here</a> and get huge discount</p><p>Hurry, this offer is only to {{user_type}}</p><p>{{sender}}</p>"
  }
}


Kemampuan Substitusi Overview

Kemampuan

Deskripsi

Substitusi variabel dasar

Menyisipkan nilai dinamis tunggal ke dalam konten teks atau HTML

Logika bersyarat

Menampilkan konten berbeda berdasarkan evaluasi boolean atau ekspresi

Iterasi array

Mengulang melalui array (misalnya, daftar file) untuk menghasilkan konten yang berulang

Penyisipan HTML mentah ({{{ }}})

Mengizinkan HTML tidak terhindar untuk situasi di mana markup berasal dari sumber data

Personalisasi per penerima

Memastikan konten yang sepenuhnya unik bagi setiap penerima


Pertama, mari kita tinjau skenario hari cerah untuk mengirim email. Gunakan transmission endpoint untuk menyediakan text dan HTML konten. Di belakang layar, SparkPost menangani penyusunan email RFC 5322 yang valid. SparkPost akan menyisipkan variabel substitusi dari substitution_data ke dalam teks dan konten HTML. Ini adalah cara yang kuat untuk menghasilkan konten kustom bagi setiap penerima dalam template yang umum.

Berikut adalah contoh transmission dengan konten HTML dan teks dengan substitution_data.

{
  "options": {
    "open_tracking": true,
    "click_tracking": true
  },
  "campaign_id": "christmas_campaign",
  "return_path": "bounces-christmas-campaign@domain.com",
  "metadata": {
    "user_type": "students"
  },
  "substitution_data": {
    "sender": "Big Store Team"
  },
  "recipients": [
    {
      "return_path": "123@bounces.domain.com",
      "address": {
        "email": "wilma@domain.com",
        "name": "Wilma Flintstone"
      },
      "tags": [
        "greeting",
        "prehistoric",
        "fred",
        "flintstone"
      ],
      "metadata": {
        "place": "Bedrock"
      },
      "substitution_data": {
        "customer_type": "Platinum"
      }
    }
  ],
  "content": {
    "from": {
      "name": "Fred Flintstone",
      "email": "fred@domain.com"
    },
    "subject": "Big Christmas savings!",
    "reply_to": "Christmas Sales <sales@domain.com>",
    "headers": {
      "X-Customer-Campaign-ID": "christmas_campaign"
    },
    "text": "Hi {{address.name}} \nSave big this Christmas in your area {{place}}! \nClick http://www.mysite.com and get huge discount\n Hurry, this offer is only to {{user_type}}\n {{sender}}",
    "html": "<p>Hi {{address.name}} <br>Save big this Christmas in your area {{place}}! <br>Click <a href=\"http://www.mysite.com\">here</a> and get huge discount</p><p>Hurry, this offer is only to {{user_type}}</p><p>{{sender}}</p>"
  }
}


Kemampuan Substitusi Overview

Kemampuan

Deskripsi

Substitusi variabel dasar

Menyisipkan nilai dinamis tunggal ke dalam konten teks atau HTML

Logika bersyarat

Menampilkan konten berbeda berdasarkan evaluasi boolean atau ekspresi

Iterasi array

Mengulang melalui array (misalnya, daftar file) untuk menghasilkan konten yang berulang

Penyisipan HTML mentah ({{{ }}})

Mengizinkan HTML tidak terhindar untuk situasi di mana markup berasal dari sumber data

Personalisasi per penerima

Memastikan konten yang sepenuhnya unik bagi setiap penerima


Pertama, mari kita tinjau skenario hari cerah untuk mengirim email. Gunakan transmission endpoint untuk menyediakan text dan HTML konten. Di belakang layar, SparkPost menangani penyusunan email RFC 5322 yang valid. SparkPost akan menyisipkan variabel substitusi dari substitution_data ke dalam teks dan konten HTML. Ini adalah cara yang kuat untuk menghasilkan konten kustom bagi setiap penerima dalam template yang umum.

Berikut adalah contoh transmission dengan konten HTML dan teks dengan substitution_data.

{
  "options": {
    "open_tracking": true,
    "click_tracking": true
  },
  "campaign_id": "christmas_campaign",
  "return_path": "bounces-christmas-campaign@domain.com",
  "metadata": {
    "user_type": "students"
  },
  "substitution_data": {
    "sender": "Big Store Team"
  },
  "recipients": [
    {
      "return_path": "123@bounces.domain.com",
      "address": {
        "email": "wilma@domain.com",
        "name": "Wilma Flintstone"
      },
      "tags": [
        "greeting",
        "prehistoric",
        "fred",
        "flintstone"
      ],
      "metadata": {
        "place": "Bedrock"
      },
      "substitution_data": {
        "customer_type": "Platinum"
      }
    }
  ],
  "content": {
    "from": {
      "name": "Fred Flintstone",
      "email": "fred@domain.com"
    },
    "subject": "Big Christmas savings!",
    "reply_to": "Christmas Sales <sales@domain.com>",
    "headers": {
      "X-Customer-Campaign-ID": "christmas_campaign"
    },
    "text": "Hi {{address.name}} \nSave big this Christmas in your area {{place}}! \nClick http://www.mysite.com and get huge discount\n Hurry, this offer is only to {{user_type}}\n {{sender}}",
    "html": "<p>Hi {{address.name}} <br>Save big this Christmas in your area {{place}}! <br>Click <a href=\"http://www.mysite.com\">here</a> and get huge discount</p><p>Hurry, this offer is only to {{user_type}}</p><p>{{sender}}</p>"
  }
}


Kemampuan Substitusi Overview

Kemampuan

Deskripsi

Substitusi variabel dasar

Menyisipkan nilai dinamis tunggal ke dalam konten teks atau HTML

Logika bersyarat

Menampilkan konten berbeda berdasarkan evaluasi boolean atau ekspresi

Iterasi array

Mengulang melalui array (misalnya, daftar file) untuk menghasilkan konten yang berulang

Penyisipan HTML mentah ({{{ }}})

Mengizinkan HTML tidak terhindar untuk situasi di mana markup berasal dari sumber data

Personalisasi per penerima

Memastikan konten yang sepenuhnya unik bagi setiap penerima


Substitusi Array Data

Banyak orang menyadari bahwa titik akhir transmisi dan templat SparkPost dapat melakukan konten sederhana substitusi dalam header email dan badan email. Namun banyak yang mengabaikan kemampuan untuk menyediakan konten bersyarat atau array data yang juga dapat disubstitusi. Anda juga dapat memberikan konten unik per penerima. Dalam contoh ini kami mengirim array tautan unik kepada setiap penerima.

Ini dicapai dengan memberikan array data JSON yang akan dimasukkan ke dalam badan email. Setelah data diberikan, SparkPost akan menggunakan logika dalam templat untuk mengisinya.

Dalam contoh ini SparkPost akan mencari data substitusi yang disebut “files_html” dan melakukan “untuk setiap” pada setiap elemen dalam array. Ini akan membuat baris dengan nilai “file” dalam elemen “files_html”. Perhatikan kurung kurawal ganda di sekitar “loop_var.file“. Ini karena setiap elemen array mengandung HTML dan kami perlu memberi tahu server untuk menggunakannya apa adanya dan tidak meloloskannya. Bagian teks akan menjadi label teks sederhana dan URL ke file.

<table>
  {{each files_html}}
    <tr>
      <td>{{{loop_var.file}}}</td>
    </tr>
  {{ end }}
</table>


Ini adalah contoh kerja yang sudah lengkap:

Banyak orang menyadari bahwa titik akhir transmisi dan templat SparkPost dapat melakukan konten sederhana substitusi dalam header email dan badan email. Namun banyak yang mengabaikan kemampuan untuk menyediakan konten bersyarat atau array data yang juga dapat disubstitusi. Anda juga dapat memberikan konten unik per penerima. Dalam contoh ini kami mengirim array tautan unik kepada setiap penerima.

Ini dicapai dengan memberikan array data JSON yang akan dimasukkan ke dalam badan email. Setelah data diberikan, SparkPost akan menggunakan logika dalam templat untuk mengisinya.

Dalam contoh ini SparkPost akan mencari data substitusi yang disebut “files_html” dan melakukan “untuk setiap” pada setiap elemen dalam array. Ini akan membuat baris dengan nilai “file” dalam elemen “files_html”. Perhatikan kurung kurawal ganda di sekitar “loop_var.file“. Ini karena setiap elemen array mengandung HTML dan kami perlu memberi tahu server untuk menggunakannya apa adanya dan tidak meloloskannya. Bagian teks akan menjadi label teks sederhana dan URL ke file.

<table>
  {{each files_html}}
    <tr>
      <td>{{{loop_var.file}}}</td>
    </tr>
  {{ end }}
</table>


Ini adalah contoh kerja yang sudah lengkap:

Banyak orang menyadari bahwa titik akhir transmisi dan templat SparkPost dapat melakukan konten sederhana substitusi dalam header email dan badan email. Namun banyak yang mengabaikan kemampuan untuk menyediakan konten bersyarat atau array data yang juga dapat disubstitusi. Anda juga dapat memberikan konten unik per penerima. Dalam contoh ini kami mengirim array tautan unik kepada setiap penerima.

Ini dicapai dengan memberikan array data JSON yang akan dimasukkan ke dalam badan email. Setelah data diberikan, SparkPost akan menggunakan logika dalam templat untuk mengisinya.

Dalam contoh ini SparkPost akan mencari data substitusi yang disebut “files_html” dan melakukan “untuk setiap” pada setiap elemen dalam array. Ini akan membuat baris dengan nilai “file” dalam elemen “files_html”. Perhatikan kurung kurawal ganda di sekitar “loop_var.file“. Ini karena setiap elemen array mengandung HTML dan kami perlu memberi tahu server untuk menggunakannya apa adanya dan tidak meloloskannya. Bagian teks akan menjadi label teks sederhana dan URL ke file.

<table>
  {{each files_html}}
    <tr>
      <td>{{{loop_var.file}}}</td>
    </tr>
  {{ end }}
</table>


Ini adalah contoh kerja yang sudah lengkap:

Lampiran dalam Kemampuan Transmisi

Titik akhir transmisi juga menyediakan abstraksi untuk mengirim lampiran. Di bawah ini Anda akan melihat lampiran ditentukan dalam array content.attachments di mana setiap objek dalam array menggambarkan item lampiran individu. Seperti sebelumnya, SparkPost akan mengurus encoding teks, HTML, substitusi dan mengiterasi melalui array lampiran untuk mengkodekan pesan email yang dibentuk dengan baik.

Praktik terbaik menyatakan bahwa mengirim lampiran sebaiknya dihindari kecuali secara eksplisit diperlukan sebagai bagian dari layanan Anda.

Di bawah ini adalah field yang diperlukan untuk sebuah lampiran:

  • tipe: Tipe MIME dari lampiran

  • nama: Nama file lampiran

  • data: Data file yang di-encode dalam Base64

Field yang Diperlukan untuk Lampiran

Field

Arti

tipe

Tipe MIME dari lampiran

nama

Nama file seperti yang akan muncul kepada penerima

data

Payload file yang di-encode dalam Base64


Ini adalah bagaimana sebuah lampiran terlihat di dalam stanza konten transmisi:

"content": {
  "attachments": [
    {
      "type": "audio/mp3",
      "name": "voicemail.mp3",
      "data": "TVAzIERhdGEK"
    }
  ]
}

Anda juga dapat mengirim “gambar dalam sebaris” dalam suatu transmisi. Ini sangat mirip dengan lampiran dan ditentukan dalam array content.inline_images di mana masing-masing objek inline_image mirip dengan objek lampiran yang ditunjukkan di atas.

Titik akhir transmisi juga menyediakan abstraksi untuk mengirim lampiran. Di bawah ini Anda akan melihat lampiran ditentukan dalam array content.attachments di mana setiap objek dalam array menggambarkan item lampiran individu. Seperti sebelumnya, SparkPost akan mengurus encoding teks, HTML, substitusi dan mengiterasi melalui array lampiran untuk mengkodekan pesan email yang dibentuk dengan baik.

Praktik terbaik menyatakan bahwa mengirim lampiran sebaiknya dihindari kecuali secara eksplisit diperlukan sebagai bagian dari layanan Anda.

Di bawah ini adalah field yang diperlukan untuk sebuah lampiran:

  • tipe: Tipe MIME dari lampiran

  • nama: Nama file lampiran

  • data: Data file yang di-encode dalam Base64

Field yang Diperlukan untuk Lampiran

Field

Arti

tipe

Tipe MIME dari lampiran

nama

Nama file seperti yang akan muncul kepada penerima

data

Payload file yang di-encode dalam Base64


Ini adalah bagaimana sebuah lampiran terlihat di dalam stanza konten transmisi:

"content": {
  "attachments": [
    {
      "type": "audio/mp3",
      "name": "voicemail.mp3",
      "data": "TVAzIERhdGEK"
    }
  ]
}

Anda juga dapat mengirim “gambar dalam sebaris” dalam suatu transmisi. Ini sangat mirip dengan lampiran dan ditentukan dalam array content.inline_images di mana masing-masing objek inline_image mirip dengan objek lampiran yang ditunjukkan di atas.

Titik akhir transmisi juga menyediakan abstraksi untuk mengirim lampiran. Di bawah ini Anda akan melihat lampiran ditentukan dalam array content.attachments di mana setiap objek dalam array menggambarkan item lampiran individu. Seperti sebelumnya, SparkPost akan mengurus encoding teks, HTML, substitusi dan mengiterasi melalui array lampiran untuk mengkodekan pesan email yang dibentuk dengan baik.

Praktik terbaik menyatakan bahwa mengirim lampiran sebaiknya dihindari kecuali secara eksplisit diperlukan sebagai bagian dari layanan Anda.

Di bawah ini adalah field yang diperlukan untuk sebuah lampiran:

  • tipe: Tipe MIME dari lampiran

  • nama: Nama file lampiran

  • data: Data file yang di-encode dalam Base64

Field yang Diperlukan untuk Lampiran

Field

Arti

tipe

Tipe MIME dari lampiran

nama

Nama file seperti yang akan muncul kepada penerima

data

Payload file yang di-encode dalam Base64


Ini adalah bagaimana sebuah lampiran terlihat di dalam stanza konten transmisi:

"content": {
  "attachments": [
    {
      "type": "audio/mp3",
      "name": "voicemail.mp3",
      "data": "TVAzIERhdGEK"
    }
  ]
}

Anda juga dapat mengirim “gambar dalam sebaris” dalam suatu transmisi. Ini sangat mirip dengan lampiran dan ditentukan dalam array content.inline_images di mana masing-masing objek inline_image mirip dengan objek lampiran yang ditunjukkan di atas.

Lampiran dalam Template

Sekarang kita memiliki latar belakang yang tepat untuk mengirim lampiran dengan endpoint transmisi, mari kita lihat bagaimana cara melakukannya dengan template. Pada saat penulisan ini, belum ada abstraksi lampiran seperti yang Anda temukan untuk transmisi inline. Seseorang mungkin menyimpulkan bahwa template tidak dapat dibuat dengan lampiran. Anda akan sebagian benar, tetapi ada cara lain, meskipun Anda tidak akan lagi terisolasi dari format RFC 5322.

Anda dapat melakukan lampiran dalam template dengan mengkodekan konten RFC 5322 sendiri yang mencakup lampiran. Kabar baiknya adalah Anda tidak akan kehilangan kemampuan untuk tetap menggunakan Data Substitusi dalam header email, bagian HTML dan bagian teks Anda. Harap diketahui bahwa jenis template ini membatasi substitusi pada header dan bagian HTML pertama serta bagian teks pertama.


Limitasi Template RFC 5322

Limitasi

Deskripsi

Substitusi terbatas

Hanya berlaku untuk header, bagian HTML pertama, dan bagian teks pertama

Penanganan MIME manual

Pengembang harus membangun semua batasan MIME dan bagian lampiran

Overhead pemeliharaan yang lebih tinggi

Lebih sulit untuk diperbarui, diaudit, dan versi

Tidak ramah abstraksi

Melewatkan kenyamanan dari sistem template SparkPost


Berikut adalah contoh bagaimana melakukan ini.

Email RFC822

Buat email RFC 5322 Anda dengan data substitusi yang Anda inginkan. Saya membuat ini di klien email saya dan mengirimkannya kepada diri saya sendiri. Setelah saya menerimanya, saya menyalin sumbernya dan mengganti bidang yang ingin saya substitusi secara dinamis.

MIME-Version: 1.0
Reply-To: {{replyto}}
Subject: {{subject}}
From: {{from}}
To: {{address.email}}
Content-Type: multipart/mixed; boundary="001a113c48b0b89d92052d3051da"
--001a113c48b0b89d92052d3051da
Content-Type: multipart/alternative; boundary="001a113c48b0b89d89052d3051d8"
--001a113c48b0b89d89052d3051d8
Content-Type: text/plain; charset=UTF-8
Email with a *text attachment*.
{{body2}}
--001a113c48b0b89d89052d3051d8
Content-Type: text/html; charset=UTF-8
<div dir="ltr">
  <div>Email with a <i>text attachment</i>.</div>
  {{body1}}
<

Bagian MIME terakhir dalam pesan ini yang akan Anda lihat Content-Disposition: attachment; filename=myfile.txt”. Di sinilah nama file ditentukan. Konten lampiran Anda akan jauh lebih kompleks, tetapi contoh ini berusaha untuk menjaga kesederhanaan.

Sekarang kita memiliki latar belakang yang tepat untuk mengirim lampiran dengan endpoint transmisi, mari kita lihat bagaimana cara melakukannya dengan template. Pada saat penulisan ini, belum ada abstraksi lampiran seperti yang Anda temukan untuk transmisi inline. Seseorang mungkin menyimpulkan bahwa template tidak dapat dibuat dengan lampiran. Anda akan sebagian benar, tetapi ada cara lain, meskipun Anda tidak akan lagi terisolasi dari format RFC 5322.

Anda dapat melakukan lampiran dalam template dengan mengkodekan konten RFC 5322 sendiri yang mencakup lampiran. Kabar baiknya adalah Anda tidak akan kehilangan kemampuan untuk tetap menggunakan Data Substitusi dalam header email, bagian HTML dan bagian teks Anda. Harap diketahui bahwa jenis template ini membatasi substitusi pada header dan bagian HTML pertama serta bagian teks pertama.


Limitasi Template RFC 5322

Limitasi

Deskripsi

Substitusi terbatas

Hanya berlaku untuk header, bagian HTML pertama, dan bagian teks pertama

Penanganan MIME manual

Pengembang harus membangun semua batasan MIME dan bagian lampiran

Overhead pemeliharaan yang lebih tinggi

Lebih sulit untuk diperbarui, diaudit, dan versi

Tidak ramah abstraksi

Melewatkan kenyamanan dari sistem template SparkPost


Berikut adalah contoh bagaimana melakukan ini.

Email RFC822

Buat email RFC 5322 Anda dengan data substitusi yang Anda inginkan. Saya membuat ini di klien email saya dan mengirimkannya kepada diri saya sendiri. Setelah saya menerimanya, saya menyalin sumbernya dan mengganti bidang yang ingin saya substitusi secara dinamis.

MIME-Version: 1.0
Reply-To: {{replyto}}
Subject: {{subject}}
From: {{from}}
To: {{address.email}}
Content-Type: multipart/mixed; boundary="001a113c48b0b89d92052d3051da"
--001a113c48b0b89d92052d3051da
Content-Type: multipart/alternative; boundary="001a113c48b0b89d89052d3051d8"
--001a113c48b0b89d89052d3051d8
Content-Type: text/plain; charset=UTF-8
Email with a *text attachment*.
{{body2}}
--001a113c48b0b89d89052d3051d8
Content-Type: text/html; charset=UTF-8
<div dir="ltr">
  <div>Email with a <i>text attachment</i>.</div>
  {{body1}}
<

Bagian MIME terakhir dalam pesan ini yang akan Anda lihat Content-Disposition: attachment; filename=myfile.txt”. Di sinilah nama file ditentukan. Konten lampiran Anda akan jauh lebih kompleks, tetapi contoh ini berusaha untuk menjaga kesederhanaan.

Sekarang kita memiliki latar belakang yang tepat untuk mengirim lampiran dengan endpoint transmisi, mari kita lihat bagaimana cara melakukannya dengan template. Pada saat penulisan ini, belum ada abstraksi lampiran seperti yang Anda temukan untuk transmisi inline. Seseorang mungkin menyimpulkan bahwa template tidak dapat dibuat dengan lampiran. Anda akan sebagian benar, tetapi ada cara lain, meskipun Anda tidak akan lagi terisolasi dari format RFC 5322.

Anda dapat melakukan lampiran dalam template dengan mengkodekan konten RFC 5322 sendiri yang mencakup lampiran. Kabar baiknya adalah Anda tidak akan kehilangan kemampuan untuk tetap menggunakan Data Substitusi dalam header email, bagian HTML dan bagian teks Anda. Harap diketahui bahwa jenis template ini membatasi substitusi pada header dan bagian HTML pertama serta bagian teks pertama.


Limitasi Template RFC 5322

Limitasi

Deskripsi

Substitusi terbatas

Hanya berlaku untuk header, bagian HTML pertama, dan bagian teks pertama

Penanganan MIME manual

Pengembang harus membangun semua batasan MIME dan bagian lampiran

Overhead pemeliharaan yang lebih tinggi

Lebih sulit untuk diperbarui, diaudit, dan versi

Tidak ramah abstraksi

Melewatkan kenyamanan dari sistem template SparkPost


Berikut adalah contoh bagaimana melakukan ini.

Email RFC822

Buat email RFC 5322 Anda dengan data substitusi yang Anda inginkan. Saya membuat ini di klien email saya dan mengirimkannya kepada diri saya sendiri. Setelah saya menerimanya, saya menyalin sumbernya dan mengganti bidang yang ingin saya substitusi secara dinamis.

MIME-Version: 1.0
Reply-To: {{replyto}}
Subject: {{subject}}
From: {{from}}
To: {{address.email}}
Content-Type: multipart/mixed; boundary="001a113c48b0b89d92052d3051da"
--001a113c48b0b89d92052d3051da
Content-Type: multipart/alternative; boundary="001a113c48b0b89d89052d3051d8"
--001a113c48b0b89d89052d3051d8
Content-Type: text/plain; charset=UTF-8
Email with a *text attachment*.
{{body2}}
--001a113c48b0b89d89052d3051d8
Content-Type: text/html; charset=UTF-8
<div dir="ltr">
  <div>Email with a <i>text attachment</i>.</div>
  {{body1}}
<

Bagian MIME terakhir dalam pesan ini yang akan Anda lihat Content-Disposition: attachment; filename=myfile.txt”. Di sinilah nama file ditentukan. Konten lampiran Anda akan jauh lebih kompleks, tetapi contoh ini berusaha untuk menjaga kesederhanaan.

Template Tersimpan

Setelah Anda memiliki email RFC 5322 yang valid, simpanlah menggunakan bentuk email_rfc822 dari endpoint template daripada menggunakan teks dan HTML fields. Berikut adalah contoh dari apa yang terlihat seperti isi untuk pesan tersebut:

{
  "content": {
    "email_rfc822": "MIME-Version: 1.0\nReply-To: {{replyto}}\nSubject: {{subject}}\nFrom: {{from}}\nTo: {{address.email}}\nContent-Type: multipart/mixed; boundary=001a113c48b0b89d92052d3051da\n\n--001a113c48b0b89d92052d3051da\nContent-Type: multipart/alternative; boundary=001a113c48b0b89d89052d3051d8\n\n--001a113c48b0b89d89052d3051d8\nContent-Type: text/plain; charset=UTF-8\n\nEmail with a *text attachment*.\n\n{{body2}}\n\n--001a113c48b0b89d89052d3051d8\nContent-Type: text/html; charset=UTF-8\n\n<div dir=\"ltr\"><div>Email with a <i>text attachment</i>.</div>\n\n{{body1}}\n</div>\n\n--001a113c48b0b89d89052d3051d8--\n--001a113c48b0b89d92052d3051da\nContent-Type: text/plain; charset=US-ASCII; name=\"myfile.txt\"\nContent-Disposition: attachment; filename=\"myfile.txt\"\nContent-Transfer-Encoding: base64\nX-Attachment-Id: f_ild455ce0\n\nVGhpcyBpcyBteSBzaW1wbGUgdGV4dCBmaWxlLgo=\n--001a113c48b0b89d92052d3051da--"
  },
  "name": "_TMP_TEMPLATE_TEST"
}

Ketika permintaan selesai, SparkPost akan merespons dengan pengidentifikasi unik untuk template baru Anda. Sebagai contoh xxxxxxx.

Setelah Anda memiliki email RFC 5322 yang valid, simpanlah menggunakan bentuk email_rfc822 dari endpoint template daripada menggunakan teks dan HTML fields. Berikut adalah contoh dari apa yang terlihat seperti isi untuk pesan tersebut:

{
  "content": {
    "email_rfc822": "MIME-Version: 1.0\nReply-To: {{replyto}}\nSubject: {{subject}}\nFrom: {{from}}\nTo: {{address.email}}\nContent-Type: multipart/mixed; boundary=001a113c48b0b89d92052d3051da\n\n--001a113c48b0b89d92052d3051da\nContent-Type: multipart/alternative; boundary=001a113c48b0b89d89052d3051d8\n\n--001a113c48b0b89d89052d3051d8\nContent-Type: text/plain; charset=UTF-8\n\nEmail with a *text attachment*.\n\n{{body2}}\n\n--001a113c48b0b89d89052d3051d8\nContent-Type: text/html; charset=UTF-8\n\n<div dir=\"ltr\"><div>Email with a <i>text attachment</i>.</div>\n\n{{body1}}\n</div>\n\n--001a113c48b0b89d89052d3051d8--\n--001a113c48b0b89d92052d3051da\nContent-Type: text/plain; charset=US-ASCII; name=\"myfile.txt\"\nContent-Disposition: attachment; filename=\"myfile.txt\"\nContent-Transfer-Encoding: base64\nX-Attachment-Id: f_ild455ce0\n\nVGhpcyBpcyBteSBzaW1wbGUgdGV4dCBmaWxlLgo=\n--001a113c48b0b89d92052d3051da--"
  },
  "name": "_TMP_TEMPLATE_TEST"
}

Ketika permintaan selesai, SparkPost akan merespons dengan pengidentifikasi unik untuk template baru Anda. Sebagai contoh xxxxxxx.

Setelah Anda memiliki email RFC 5322 yang valid, simpanlah menggunakan bentuk email_rfc822 dari endpoint template daripada menggunakan teks dan HTML fields. Berikut adalah contoh dari apa yang terlihat seperti isi untuk pesan tersebut:

{
  "content": {
    "email_rfc822": "MIME-Version: 1.0\nReply-To: {{replyto}}\nSubject: {{subject}}\nFrom: {{from}}\nTo: {{address.email}}\nContent-Type: multipart/mixed; boundary=001a113c48b0b89d92052d3051da\n\n--001a113c48b0b89d92052d3051da\nContent-Type: multipart/alternative; boundary=001a113c48b0b89d89052d3051d8\n\n--001a113c48b0b89d89052d3051d8\nContent-Type: text/plain; charset=UTF-8\n\nEmail with a *text attachment*.\n\n{{body2}}\n\n--001a113c48b0b89d89052d3051d8\nContent-Type: text/html; charset=UTF-8\n\n<div dir=\"ltr\"><div>Email with a <i>text attachment</i>.</div>\n\n{{body1}}\n</div>\n\n--001a113c48b0b89d89052d3051d8--\n--001a113c48b0b89d92052d3051da\nContent-Type: text/plain; charset=US-ASCII; name=\"myfile.txt\"\nContent-Disposition: attachment; filename=\"myfile.txt\"\nContent-Transfer-Encoding: base64\nX-Attachment-Id: f_ild455ce0\n\nVGhpcyBpcyBteSBzaW1wbGUgdGV4dCBmaWxlLgo=\n--001a113c48b0b89d92052d3051da--"
  },
  "name": "_TMP_TEMPLATE_TEST"
}

Ketika permintaan selesai, SparkPost akan merespons dengan pengidentifikasi unik untuk template baru Anda. Sebagai contoh xxxxxxx.

Kesimpulan

sekarang Anda melihat bagaimana SparkPost dapat digunakan untuk mengirim email dengan hampir semua kompleksitas, Anda mungkin ingin melihat "SparkPost Mendukung Pengiriman Email di Apple Watch" atau melihat sintaks pengganti untuk melihat bagaimana ia dapat digunakan dengan "jika maka lain", "ekspresi dalam kondisi" atau "iterasi array" langsung di dalam konten templat atau transmisi Anda.

Berita lainnya

Baca lebih lanjut dari kategori ini

27 Agu 2018

Pentingnya Ukuran Berkas Email

9 Jan 2024

Persyaratan Email Google dan Yahoo di 2024: Inilah Cara Pengaruhnya Terhadap Anda

5 Agu 2019

Cara Mengatur SparkPost sebagai Penghubung SMTP Anda

A person is standing at a desk while typing on a laptop.

Platform AI-native lengkap yang dapat berkembang seiring dengan bisnis Anda.

Hubungi penjualan

Mulai gratis

© 2026 Burung

Hubungi Dukungan

A person is standing at a desk while typing on a laptop.

Platform AI-native lengkap yang dapat berkembang seiring dengan bisnis Anda.

Hubungi penjualan

Mulai gratis

© 2026 Burung

Hubungi Dukungan

A person is standing at a desk while typing on a laptop.

Platform AI-native lengkap yang dapat berkembang seiring dengan bisnis Anda.

Hubungi penjualan

Mulai gratis

© 2026 Burung

Hubungi Dukungan