Lompat ke konten utama
StableTerakhir diperbarui: 9 Okt 2026, 09.28

Template & Log Email Transaksional

1. Ikhtisar & Nilai Bisnis

Sistem platform v3 menyediakan infrastruktur pengiriman surel secara bawaan. Pesan transaksional akan terkirim secara otomatis kepada entitas yang terlibat (baik itu kepada anggota tim atau staf internal, maupun kepada pelanggan akhir Anda) sesuai dengan pemicu peristiwa (trigger event) di dalam ekosistem DagangBot. Fitur Template Email memungkinkan para pemilik bisnis dan agen pengelola untuk mengustomisasi seluruh aspek pesan, termasuk baris subjek, teks isi pesan, serta tata letak dokumen HyperText Markup Language (HTML) tersebut.

Fitur ini didesain agar email yang keluar seragam dengan identitas dan warna merek bisnis masing-masing penyewa (tenant) tanpa harus merancang dan memelihara infrastruktur pengiriman email pihak ketiga.

Manfaat strategis fitur ini meliputi:

  • Konsistensi Penjenamaan (Branding): Anda mampu menggantikan nama standar, gaya bahasa, serta sapaan platform bawaan menjadi nada sapaan yang sesuai dengan demografi target pelanggan Anda (misalnya: santai, formal, atau Islami).
  • Kemandirian Operasional Penuh: Platform menyediakan infrastruktur SMTP andal yang terintegrasi penuh, sehingga Anda tidak perlu menyewa layanan pihak ketiga secara terpisah.
  • Transparansi Riwayat Pengiriman: Fitur Log Email mendata seluruh aktivitas surel yang beranjak dari server. Hal ini secara instan memastikan setiap klaim keluhan (seperti "Saya tidak menerima tautan reset" atau "Email OTP tidak pernah masuk") dapat dilacak jejak dan status akhirnya secara absolut, baik itu tersampaikan sempurna, masih tertunda dalam antrean, atau gagal karena ditolak penyedia surel penerima.
  • Pewarisan Dinamis (Dynamic Inheritance): Platform menggunakan pendekatan pewarisan ganda (dual inheritance). Bila pemilik bisnis belum pernah memodifikasi template tertentu, sistem akan secara cerdas merujuk dan membaca dari template master dasar bawaan platform, sehingga kelengkapan komunikasi akan selalu terjamin ada tanpa perlu konfigurasi awal.

2. Pemicu (Trigger) dan Kunci Template

Dalam kerangka arsitektur komunikasi transaksional platform, setiap jenis komunikasi surel dilindungi dan diatur oleh pemicu kejadian di sisi sistem latar (backend). Anda tidak dapat membuat kunci template (template key) baru secara sembarangan, hal ini diterapkan demi mencegah penyalahgunaan lalu lintas surel untuk keperluan spam (Spam-abuse). Anda diberikan kebebasan seluas-luasnya untuk memodifikasi estetika desain, warna, maupun salinan teks, namun eksekusi dan pemicu pengiriman tetap diawasi oleh mesin sistem.

Berikut adalah pemicu kejadian (trigger events) komunikasi email transaksional yang dikonfigurasi dan diizinkan secara resmi oleh sistem platform:

  • agent_invite: Digunakan ketika pemilik utama bisnis mengundang anggota tim (agen/admin/supervisor) baru untuk masuk ke dalam dasbor manajemen. Pesan ini memuat tautan pendaftaran atau kode gabung unik yang hanya berlaku dalam jendela waktu tertentu demi keamanan.
  • invoice: Bukti penagihan resmi (billing) dan rincian informasi pembelanjaan (order) pelanggan. Pesan ini terpicu otomatis pada saat pelanggan berhasil mencapai fase pembayaran atau saat pesanan diselesaikan (completed) oleh sistem manajemen pemesanan internal.
  • low_balance: Pemberitahuan kritis (alert) bagi pemilik toko (merchant) bila estimasi saldo koin (token balance) miliknya nyaris menyentuh ambang batas minimum. Hal ini amat penting bagi operasi asisten cerdas agar bot tetap dapat merespons dan memanggil Large Language Model (LLM) secara nirkendala (seamless).
  • otp_verification: Pengiriman kode rahasia One-Time Password (OTP) enam digit yang diwajibkan saat alur masuk (login) akun staf maupun pelanggan, atau saat terjadi permintaan pemulihan hak akses.
  • password_reset: Pengiriman tautan satu-kali-pakai untuk mengatur ulang kata sandi pengguna admin. Tautan ini dilengkapi dengan mekanisme kadaluarsa (expiry timer) dan pencegahan akses ganda (replay attack protection).
  • welcome: Surel penyambutan pendaftaran akun pelanggan baru yang berisi informasi kredensial dasar, tautan menuju portal belanja, serta ringkasan syarat layanan atau janji manis merek Anda.
  • account_suspended: Peringatan darurat satu arah dari sisi administrator platform (pusat) yang memberitahukan bahwa akun operasional toko Anda sedang dikenai sanksi penangguhan akses sementara atau permanen akibat indikasi pelanggaran aturan main layanan platform.
  • appeal_approved: Pemberitahuan administratif dari sistem yang mengabarkan persetujuan atas pengajuan banding yang sebelumnya diajukan oleh toko. Pemberitahuan ini merupakan penanda resmi dicabutnya sanksi penangguhan sehingga toko Anda dapat kembali beroperasi secara utuh.

3. Prasyarat Penggunaan & Konfigurasi Sistem

Untuk dapat merambah dan memanfaatkan kekuatan modifikasi template ini, Anda serta tim wajib memperhatikan prasyarat infrastruktur serta manajemen peran (RBAC) di bawah ini:

  • Hak Akses Role-Based Access Control (RBAC): Tidak sembarang agen dapat mengedit sapaan otomatis. Pengguna wajib mengemban kewenangan (permission) sumber daya email pada tingkatan update agar antarmuka mengizinkannya menimpa dan menyimpan perubahan ke basis data tenant. Sementara itu, untuk keperluan audit dan investigasi pencarian riwayat melalui panel laporan surel, staf cukup memerlukan hak akses di tingkat read. Usaha modifikasi oleh agen yang kekurangan otoritas akan seketika dihentikan oleh barikade komponen pelindung antarmuka dan API.
  • Kemampuan HTML Dasar: Platform ini menyediakan kotak teks kode HTML yang lugas demi performa dan pengiriman yang bersih, alih-alih pembuat halaman drag-and-drop berlapis. Akibatnya, modifikasi drastis (di luar dari sekadar menyisipkan atau membuang serangkai kalimat) menuntut pemahaman staf Anda atas bahasa markah HTML serta Inline Cascading Style Sheets (CSS). Penting dipahami bahwa hampir seluruh pembaca email modern (seperti Gmail client, Microsoft Outlook, dan Apple Mail) akan memblokir dan mengabaikan gaya CSS eksternal atau kelas-kelas style yang disematkan di dalam tag header demi alasan sterilitas keamanan, sehingga styling langsung (inline-styling) pada tag HTML merupakan standar industri yang wajib diikuti.
  • Proteksi Data Belum Tersimpan: Panel kontrol dasbor dilengkapi penjaga keamanan pengeditan lokal. Apabila staf mencoba menutup panel, berpindah menu (tab), atau menyegarkan (refresh) bilah ramban (browser) di saat ada kode teks belum disetujui (dirty state), maka modul useUnsavedChangesGuard akan segera membekukan layar dengan pop-up pencegahan. Ini memberikan kesempatan pada staf untuk menyimpan hasil kerjanya atau dengan sengaja membuang pembaruan tersebut.

4. Variabel, Personalisasi Otomatis (Placeholder) & Sanitasi

Guna mengakomodir komunikasi massa yang personal, seluruh bagian teks—baik pada baris Subjek (Subject line) maupun pada area tubuh HTML (Body HTML)—mendukung injeksi data kustom. Sistem melambangkannya melalui tag interpolasi berbasis kurung kurawal ganda, layaknya {{nama_variabel}}. Mesin utilitas backend yang memproses templat tersebut secara mutakhir mengurai logika sebelum diserahkan pada SMTP:

Variabel Pelanggan dan Penanganan Sapaan Pintar

Sistem mengenali pelbagai tanda identitas konsumen, misalnya: {{customer_name}}, {{nama_pelanggan}}, {{nama}}, atau {{name}}. Karena lumrah ditemui pelanggan dagang berbasis perpesanan instan yang malas menginput nama asli dan justru hanya membiarkan bidang tersebut terisi sebatas nomor telepon tanpa identitas pasti, subsistem secara khusus membekali utilitas ini dengan prosedur penyelamatan nama sapaan (smart polite fallback):

  • Jika isi {{nama}} terdeteksi merupakan susunan abjad manusia yang wajar (sebagai contoh "Budi" atau "Siti"), maka kalimat "Halo Kak {{nama}}!" akan dicetak sempurna menjadi "Halo Kak Budi!".
  • Sebaliknya, apabila {{nama}} ditemukan kosong, didapati merupakan deretan angka nomor seluler ("081234567"), ataupun sekadar istilah generik murahan ("User", "Pelanggan"), maka sistem interseptor cerdas (berbasis pustaka IsPhoneNumberName) segera mencopot tag pemanggilan yang memalukan tersebut, lalu menggubah kalimatnya menjadi sapaan hormat tunggal. Dalam kasus ini, tag "Halo Kak {{nama}}!" dipangkas cerdik menjadi "Halo Kak!" tanpa mewariskan residu jarak (spasi) ganda yang janggal dan tak sedap dipandang mata.

Variabel Identitas Bisnis (Brand)

Platform membolehkan Anda memanggi nama entitas toko dengan menaruh tag leksikal {{brand_name}}, {{nama_toko}}, {{store_name}}, {{business_name}}, hingga {{merchant_name}}. Andaikan nilai identitas bisnis di halaman pangkal pengaturan nyatanya belum diinput atau tengah kosong, peladen otomatis melapisinya dengan untaian teks anggun berbunyi "toko kami", agar pembeli tetap merasakan kesan institusional.

Variabel Transaksional & Logika Pembersihan Khusus (Sanitization)

Terdapat rentetan variabel eksklusif yang hanya terbuka aksesnya di bawah kunci templat (template key) yang berkorelasi:

  • Pada kelompok surat Penangguhan (account_suspended): Pemuatan string {{reason}} otomatis mewakili penjelasan alasan dari staf sentral dan nilai {{until}} menegaskan tenggat durasi pemblokiran yang dikenakan.
  • Pada kelompok surat Pemulihan Akun (appeal_approved): Tersedia kolom muatan {{note}} berisi apresiasi atau catatan pengingat kebersihan akun pasca-persetujuan.
  • Pembersihan Otomatis (Sanitization): Demi kemutlakan kualitas, platform menjalankan sapuan terakhir. Sisa-sisa tag kupon yang tidak dipergunakan oleh promosi saat itu (semacam {{promo}}, {{promo_offer}}, {{voucher_code}}) akan dipaksa lenyap (sanitized hingga bersih menjadi ruang kosong) dari dokumen rilis. Tidak akan ada lagi kecerobohan di mana sintaks mentah tak termodifikasi terpampang di layar depan pengguna secara vulgar.

5. Panduan Modifikasi & Pratinjau (Preview)

Untuk mendemonstrasikan perubahan identitas merek, Anda dapat meniru panduan implementasi berikut:

5.1 Mengubah Konten Template Terpilih

  1. Langkah perdana, pastikan Anda masuk di bawah kredensial bertenaga. Arahkan kursor Anda menunju sisi menu Pengaturan dan tekan submisi Email Transaksional.
  2. Masuk menuju belahan (tab) Template. Sistem segera membentangkan kisi templat (grid) berisi segenap kunci yang beroperasi aktif. Tekan salah satunya, umpama menu OTP Verification.
  3. Di saat jendela modal tersemat terbuka, modifikasilah pada ruas Subjek. Misal, ciptakan untaian "Kode Rahasia Masuk {{brand_name}} Anda: {{otp}}".
  4. Gulirkan turun menuju seksi Body HTML. Ubahlah tata warna selaras pada kelas-kelas inline CSS. Sewaktu Anda memperbarui sintaks, mekanisme UI senantiasa mempersembahkan fitur uji pratinjau mentah.
  5. Sesudah mantap, tekan tomboh komando Simpan Perubahan. Mulai detik mutlak tersebut, modifikasi penimpa (override) langsung dicetak menempati bilik basis data Anda yang spesifik pada teritori (merchant_id), menindas pengaturan generik di level pangkal (di mana kolom asalnya merekam merchant_id IS NULL). Seluruh agen surel pun berbalik menyadur instruksi Anda yang teraktual.

5.2 Mengembalikan ke Status Bawaan Platform (Rollback Default)

Kerap terjadi kasus di mana modifikasi brutal atas blok tag mengakibatkan susunan sel-sel tabel pecah atau citra tak terbaca dalam gawai genggam (mobile phone). Apabila tata letak HTML telanjur berantakan di luar batas upaya reparasi manual, carilah opsi Reset to Default. Menekan pilihan tersebut berarti menitahkan peladen agar menghanguskan (delete) presensi rekaman baris penimpa kustom tersebut dari tabel lapis merchant, sehingga subsistem komunikasi toko Anda kembali bersandar penuh pada template orisinal (is_active = true, merchant_id = NULL) warisan mahakarya arsitektur platform DagangBot yang rapi.

6. Penanganan Galat & Sistem Log Pengiriman (Log Email)

Mengejawantahkan asas pertanggungjawaban data, setiap kali agen CS dihadapkan oleh pelanggan menjengkelkan yang terus mengklaim "Saya tidak pernah menerima lembar faktur", staf tersebut dipersenjatai dengan panel bukti Log Email. Panel ini merupakan proyeksi jejak audit transmisi secara seketika (realtime outbox logger).

  1. Menuju log audit: Buka menu Log di dalam ranah Pengaturan Email. Jalankan filter urutan berdasarkan sumbu waktu, ataupun cari tepat nama surel spesifik pelanggan.
  2. Pahami dan cermati muara nasib pesan pada indikator status yang ditautkan langsung ke alur pekerja antrean (queue worker):
    • pending (Tertunda): Keterangan bahwa struktur surel baru saja diproduksi dan mengendap dalam tabel tunggakan lokal (realtime outbox). Pesan tengah berbaris antre menantikan pekerja rutin (worker) di lapis backend merangkum lalu menyerahkannya (hand-off) melewati lorong API kepada gateway SMTP eksternal (layaknya Amazon SES).
    • delivered (Tersampaikan): Indikator pamungkas yang membuktikan bahwa muatan bytes email sukses dilempar dan dikonfirmasi ketersampaiannya oleh penadah peladen kotak masuk sang tujuan (seperti Google Gmail atau Microsoft Outlook server). Nomor penanda dari penyedia lalu disisipkan (provider_message_id) guna kelengkapan arsip.
    • failed (Gagal Rute): Menandakan bahwa transmisi surel diretas kegagalan parah dari pihak ketiga penyedia, umumnya akibat fenomena pental (email bounce), surel tak eksis, alamat salah ketik (typo) parah, maupun saat jumlah percobaan ulang paksa (retry limit) akibat masalah percekikan peladen (throttling) sudah memuncak melampaui ambang rasional sistem. Informasi galat spesifik diselipkan pada ruas error_message.

Tabel pencatatan ini beroperasi secara tangkas, mendukung fungsionalitas pemilahan (sorting) menurun, pemecahan halaman (pagination), hingga pencarian kata kunci yang dilengkapi mekanisme pengereman (debounced search).

7. Referensi Terkait

content/docs/features/email-templates.mdx
Terakhir diperbarui: 9 Okt 2026, 09.28

Dokumentasi teknis DagangBot