hatang.dev

Tạo template email

Viết email một lần với biến như mã đơn hàng, publish, rồi dùng lại từ website, chiến dịch email và automation.

Cập nhật ngày

Trong bài này

Template là email đội ngũ của bạn viết một lần và gửi nhiều lần: xác nhận đơn hàng, thông báo giao hàng, email chào mừng. Người làm marketing sửa nội dung ngay trong dashboard, còn website hay ứng dụng vẫn gửi đúng template đó, với mã đơn và số tiền của từng khách được điền vào. Chiến dịch email và automation cũng có thể bắt đầu từ template.

Tạo và sửa template cần quyền Làm việc trong module Email.

Tạo template

  1. Mở Email → Templates và bấm Template mới.
  2. Điền các giá trị mặc định ở phía trên. Mỗi lần gửi có thể ghi đè chúng:
    • Tên: để đội ngũ nhận biết, ví dụ "Xác nhận đơn hàng".
    • Bí danh (alias): tên ngắn như order-confirmation để lập trình viên dùng thay cho id của template. Chỉ gồm chữ thường, số, - và _.
    • Người gửi: địa chỉ thuộc tên miền đã xác minh, ví dụ Mộc Hương Tea <[email protected]>.
    • Tiêu đề, Reply-To và Thư mục (để gom nhóm template trong danh sách).
  3. Viết email ở tab HTML. Xem thử ở Xem trước, nơi mỗi biến được điền bằng giá trị fallback.
  4. Để trống tab Văn bản nếu không muốn tự viết: Hạ Tầng tự tạo bản văn bản thuần từ HTML. Có phần văn bản thuần giúp email dễ vào hộp thư chính hơn.
  5. Bấm Lưu. Template đang là Bản nháp.
Trình soạn template: giá trị mặc định, HTML, biến và các nút publish
Trình soạn template: giá trị mặc định, HTML, biến và các nút publish

Dùng biến

Biến được viết trong ba cặp ngoặc nhọn: {{{order_id}}}. Thêm giá trị mặc định sau dấu gạch đứng để dùng khi không có giá trị gửi kèm: {{{customer_name|bạn}}}.

  1. Trong Biến, bấm Thêm biến cho từng biến, hoặc Khai báo tất cả để thêm mọi biến Hạ Tầng tìm thấy trong tiêu đề và nội dung.
  2. Chọn kiểu cho từng biến, string hoặc number, và điền Fallback nếu cần.

Những quy tắc cần biết:

  • Mọi biến dùng trong tiêu đề hay nội dung phải được khai báo thì mới publish được. Biến còn thiếu được liệt kê ở dòng Chưa khai báo.
  • Khi lần gửi không có giá trị cho một biến, Hạ Tầng dùng giá trị mặc định viết ngay trong biến, rồi tới fallback. Không có cả hai thì lệnh gửi bị từ chối và không email nào được gửi, nên hãy đặt fallback cho mọi biến mà website có thể bỏ trống.
  • Các biến sau được tự điền khi gửi tới contact và không cần khai báo: {{{FIRST_NAME}}}, {{{LAST_NAME}}}, {{{EMAIL}}}, {{{UNSUBSCRIBE_URL}}}, và thuộc tính contact dạng {{{contact.city}}}.
  • Giá trị được tự làm an toàn cho HTML, nên tên khách hàng không thể làm vỡ bố cục email.

Kiểm tra, gửi thử và publish

  1. Bấm Kiểm tra link. Hạ Tầng đánh dấu link trống, link chỉ có #, link trỏ tới tên miền mẫu (example.com, yourdomain.com, localhost…), link không phải http(s), link không mở được hoặc trả về trang lỗi.
  2. Bấm Gửi thử để nhận bản nháp hiện tại trong hộp thư của chính bạn, với tiêu đề bắt đầu bằng [Test]. Biến hiện giá trị fallback, hoặc tên biến trong ngoặc vuông ([order_id]) nếu không có fallback. Bản nháp cần có Người gửi thì mới gửi thử được.
  3. Bấm Publish. Nếu có link lỗi, việc publish dừng lại cho tới khi bạn sửa hoặc chọn Vẫn publish.

Chỉ bản đã publish mới được gửi đi. Bạn vẫn sửa tiếp được: API, chiến dịch email và automation tiếp tục dùng bản publish gần nhất cho tới khi bạn publish lại, và danh sách hiện Có thay đổi chưa publish trong lúc đó. Nhờ vậy bạn chuẩn bị được nội dung mới mà không làm thay đổi email khách đang nhận.

Nhân bản sao chép template thành một bản nháp mới, ví dụ để làm phiên bản cho dòng sản phẩm khác.

Template được dùng ở đâu

Nơi dùng Cách dùng
Website hoặc ứng dụng Lập trình viên gửi id hoặc alias của template kèm giá trị các biến. Xem hướng dẫn template ở trang dành cho lập trình viên
Chiến dịch email Bắt đầu từ template sao chép một template đã publish vào chiến dịch. Sửa template sau đó không làm thay đổi chiến dịch đã tạo. Xem Gửi chiến dịch email
Automation Mỗi bước Gửi email gửi một template đã publish. Xem Automation

Xử lý sự cố

Hiện tượng Nguyên nhân Cách xử lý
Publish báo biến chưa khai báo Nội dung dùng biến chưa có trong Biến Bấm Khai báo tất cả rồi publish
Lệnh gửi báo "is not published yet" Template chưa từng được publish Publish template
Lệnh gửi báo "Missing value for template variable" Một biến không có giá trị, không có mặc định và không có fallback Thêm fallback, hoặc nhờ lập trình viên gửi kèm giá trị
Khách vẫn nhận nội dung cũ Thay đổi đã lưu nhưng chưa publish Publish; danh sách hiện Có thay đổi chưa publish cho tới lúc đó
Không bật được automation Một template trong đó chưa publish, hoặc chưa có Người gửi Publish template và điền Người gửi

Bước tiếp theo

Bài viết này có giúp ích cho bạn không?

Bài viết liên quan

Chưa tìm thấy điều bạn cần?

Đội ngũ của chúng tôi trả lời qua chat, bằng tiếng Việt hoặc tiếng Anh.

Gửi email cho chúng tôi

Bạn đang tích hợp API hoặc SDK? Xem tài liệu cho lập trình viên →