Email Template

Email Template

Email Template 定義可重複使用的郵件內容，並透過變數佔位符（{{variable}}）進行動態個人化。

Schema

interface EmailTemplate {
  id: string; // "emt_..." - Unique identifier
  account_id: string; // Owning account
  name: string; // Template name
  event_type: string; // Business event (e.g., "user_welcome")
  editor: "grapesjs_mjml"; // Template editor
  editor_state: string; // Serialized editor state
  mjml: string; // MJML source
  subject_template: string; // Subject with variables
  body_text_template: string; // Plain text with variables
  body_html_template: string; // HTML with variables
  archived_at: string | null; // Archived timestamp
}

屬性

屬性	型別	說明
id	string	帶有 emt_ 前綴的 KSUID
account_id	string	擁有此模板的帳戶
name	string	人類可讀名稱
event_type	string	事件觸發名稱
editor	string	編輯器類型
editor_state	string	序列化後編輯器狀態
mjml	string	MJML 原始碼
subject_template	string	主旨模板
body_text_template	string	純文字內容模板
body_html_template	string	HTML 內容模板
archived_at	string?	封存時間

變數語法

以 {{variable_name}} 進行替換：

Subject: Welcome, {{name}}!

Dear {{name}},

Your account {{account_name}} is ready.

Best regards,
The {{company}} Team

用法

以模板寄送：

{
  "template_id": "emt_...",
  "to": [{ "email": "user@example.com" }],
  "variables": {
    "name": "Jane",
    "account_name": "Acme Corp",
    "company": "Example Inc"
  }
}

範例

{
  "id": "emt_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "name": "welcome",
  "event_type": "user_welcome",
  "editor": "grapesjs_mjml",
  "editor_state": "{}",
  "mjml": "<mjml><mj-body></mj-body></mjml>",
  "subject_template": "Welcome to {{company}}, {{name}}!",
  "body_text_template": "Hi {{name}},\n\nWelcome to {{company}}...",
  "body_html_template": "<h1>Welcome, {{name}}!</h1>...",
  "archived_at": null
}

相關

• Email Message - 已寄送郵件
• Email - 郵件基礎設施