Bỏ qua để đến nội dung
ReputeCastReputeCast Docs

Nhập mẫu email giao dịch

Hướng dẫn thao tác
Dành cho:
Quản trị viên không gian làm việc, Nhà phát triển
Cần quyền:
transactional:edit
Trong ứng dụng:
Giao dịch, rồi Nhập mẫu

Để chuyển mẫu email Postmark, hoặc các mẫu bạn lưu trong SendGrid, Mailgun hay Notifuse, bạn kết nối ReputeCast với tài khoản một lần, chọn các mẫu, và đọc báo cáo chuyển đổi trước khi bất cứ thứ gì được tạo. Mỗi mẫu được viết lại bằng Liquid của ReputeCast, các biến được khai báo dựa trên những gì mẫu sử dụng, và mẫu được nhập dưới dạng bản nháp: không có gì được xuất bản, và ứng dụng của bạn tiếp tục gửi bằng các phiên bản đang chạy cho đến khi có người xuất bản một bản nháp.

Trước khi bắt đầu

Phần tiêu đề “Trước khi bắt đầu”

  • Bạn cần quyền transactional:edit (Chủ sở hữu, Quản trị viên và Biên tập viên có quyền này). Chỉ người dùng mới chạy được việc nhập, khóa API thì không.

  • Lấy thông tin xác thực cho nguồn của bạn. Khóa được lưu ở dạng mã hóa chỉ cho lần nhập này và bị xóa khi lần nhập kết thúc.

    Nguồn Cần dán gì
    Postmark Một server API token, lấy từ tab API Tokens của server. Nguồn: Postmark, What are the Account and Server API Tokens
    SendGrid Một khóa API dạng Custom Access có quyền đọc Template Engine, lấy từ Settings › API Keys. Nguồn: SendGrid, API Keys
    Mailgun Một khóa API của tài khoản, lấy từ menu hồ sơ › API Security, cùng khu vực của tài khoản (US hoặc EU). Nguồn: Mailgun, Where can I find my API keys
    Notifuse Địa chỉ máy chủ Notifuse của bạn và một khóa API của không gian làm việc có quyền Templates read. Nguồn: Notifuse, Admins & API Keys
    Tệp MJML hoặc HTML Tối đa 50 tệp .mjml, .html hoặc .htm, mỗi tệp tối đa 2 MB, mã hóa UTF-8

    Các nguồn được kiểm tra tháng 10/2026.

Nhập các mẫu

Phần tiêu đề “Nhập các mẫu”

  1. Mở Giao dịch, rồi Nhập mẫu và chọn nơi các mẫu đang được lưu hiện nay.

    Trang mẫu giao dịch, với nút Import templates bên cạnh New template ở góc trên bên phải và 15 mẫu đang chạy trong danh sách bên dưới.

    Ảnh chụp này hiển thị giao diện tiếng Anh.

  2. Kết nối nguồn. Với Postmark, dán token vào Token API của server; với SendGrid, dán khóa API. Với Mailgun, dán khóa vào Khóa API riêng và chọn Khu vực; điền Tên miền gửi (không bắt buộc) để đọc mẫu của một tên miền, hoặc để trống để đọc mọi tên miền chưa bị vô hiệu hóa. Với Notifuse, nhập Địa chỉ Notifuse, như https://notifuse.example.com, và khóa API. Với Tệp MJML hoặc HTML, thả hoặc chọn tệp: các tệp được chuyển đổi ngay, và bước tiếp theo là báo cáo.

  3. Chọn các mẫu. ReputeCast chọn sẵn các mẫu đang hoạt động của Postmark, mọi mẫu của SendGrid và Mailgun, và các mẫu giao dịch của Notifuse; hãy đánh dấu thêm bất kỳ mẫu nào khác bạn muốn.

  4. Chuyển đổi các mẫu và đọc báo cáo. Mỗi mẫu nhận một trong các kết quả ở bảng bên dưới, kèm dòng và cấu trúc gây ra từng ghi chú.

  5. Nhập các mẫu dưới dạng bản nháp. Báo cáo hiển thị ID ReputeCast mà mỗi bản nháp nhận được; hãy mở từng bản nháp, sửa những gì báo cáo yêu cầu, và xuất bản từ trình chỉnh sửa mẫu.

Kết quả Ý nghĩa
Đã chuyển đổi Không có gì cần bạn xử lý.
Đã chuyển đổi, có ghi chú Một cấu trúc đã được viết lại với thay đổi có thể thấy, như {{#each items}} trở thành {% for item in items %}.
Cần sửa thủ công Một cấu trúc được giữ nguyên, và bản nháp báo lỗi Liquid cho đến khi bạn thay thế nó.
Không đọc được Nguồn không trả về mẫu; báo cáo cho biết lý do.

Cách mẫu được chuyển đổi

Phần tiêu đề “Cách mẫu được chuyển đổi”
  • ID lấy từ alias hoặc tên của mẫu ở nguồn: chữ thường, chữ số và dấu gạch ngang, tối đa 64 ký tự. Khi ID đã được dùng, bản nháp nhận thêm -2, -3, v.v., và báo cáo sẽ ghi rõ điều này.
  • Tiêu đề: mẫu Postmark, SendGrid và Notifuse giữ nguyên tiêu đề. Mailgun chỉ giữ tiêu đề khi phiên bản mẫu có header Subject; với tệp, tiêu đề lấy từ <mj-title> của MJML hoặc <title> của HTML, và <mj-preview> của MJML trở thành dòng xem trước. Nếu không có, tiêu đề để trống và báo cáo yêu cầu bạn viết tiêu đề.
  • Layout: một mẫu Postmark dùng layout sẽ được gộp layout vào tại {{{ @content }}}.
  • Phiên bản: SendGrid và Mailgun cung cấp phiên bản đang hoạt động. Một mẫu SendGrid không có phiên bản đang hoạt động sẽ mang theo phiên bản đầu tiên, kèm một ghi chú.
  • Biến được khai báo dựa trên những gì mỗi mẫu sử dụng, kèm kiểu dữ liệu. Dữ liệu thử của SendGrid và Notifuse trở thành giá trị mẫu và bộ dữ liệu thử đầu tiên. Tên biến mà API không chấp nhận, như first-name, được đổi tên (first_name) ở mọi chỗ trong mẫu, và báo cáo cho bạn biết ứng dụng của bạn phải gửi tên nào thay thế.
  • Notifuse: mẫu Notifuse vốn đã là Liquid. Trường liên hệ trở thành biến thông thường (contact.first_name trở thành first_name, contact.email trở thành to.email), và notification_center_url trở thành preferences_url. Mẫu tạo bằng trình soạn thảo trực quan được nhập dưới dạng MJML.

Các thao tác viết lại và sửa thủ công thường gặp:

Ở nguồn Trong ReputeCast
{{#each items}} (Handlebars, Mustachio) {% for item in items %}
Một section như {{#person}} hoặc {{#with author}} {% if person %}; các tên bên trong giờ bắt đầu bằng person.
{{{ pm:unsubscribe }}} của Postmark, {{{unsubscribe}}} của SendGrid {{ unsubscribe_url }}
<%asm_preferences_raw_url%> của SendGrid {{ preferences_url }}
{{insert name "default=Customer"}} của SendGrid {{ name | default: "Customer" }}
%recipient.first_name%, %recipient_email% của Mailgun {{ first_name }}, {{ to.email }}
Một partial như {{> footer}}, hoặc {% include %} của Liquid Sửa thủ công: mẫu không thể chèn tệp khác. Hãy dùng một phần đã lưu.
Một helper hoặc bộ lọc mà ReputeCast không có, như formatCurrency hoặc money Sửa thủ công: hãy thay thế nó, ví dụ bằng cách gửi giá trị đã định dạng trong dữ liệu của lệnh gọi.
view_in_browser_url Sửa thủ công: thư giao dịch không có phiên bản web. Hãy xóa liên kết này.
MJML không biên dịch được, một khối không bao giờ được đóng Sửa thủ công, kèm số dòng

Kiểm tra kết quả

Phần tiêu đề “Kiểm tra kết quả”

Bước cuối liệt kê mọi bản nháp kèm ID ReputeCast và số bản nháp cần sửa thủ công. Các bản nháp nằm ở Giao dịch, rồi Mẫu; hãy mở một bản nháp để xem biến, dữ liệu thử và mọi lỗi Liquid mà báo cáo đã nhắc đến. Hãy gửi thử cho chính bạn từ trình chỉnh sửa trước khi xuất bản.

Khắc phục sự cố

Phần tiêu đề “Khắc phục sự cố”
  • “Postmark trả về 401: token này thuộc một server khác hoặc đã bị thu hồi.” (hoặc 403): hãy sao chép token từ server chứa các mẫu bạn muốn.
  • “SendGrid trả về 403: khóa này không đọc được mẫu.”: hãy sửa khóa trong SendGrid và cấp quyền đọc Template Engine.
  • “Mailgun trả về 401: khóa API sai, hoặc tài khoản ở khu vực còn lại.” (hoặc 403): hãy đổi khu vực, hoặc tạo khóa API tài khoản mới.
  • “Tài khoản Mailgun này không có tên miền nào, nên không có mẫu nào để nhập.”: trong Mailgun, mẫu nằm trên tên miền; hãy thêm tên miền ở đó trước, hoặc nhập đúng tên miền gửi.
  • “… lớn hơn 2 MB.” hoặc “Mỗi lần tải lên tối đa 50 tệp.”: hãy chia nhỏ lần tải lên; mỗi lần tải lên là một lần nhập.
  • “… đang giới hạn số yêu cầu (429). Hãy thử lại sau một phút.”: ReputeCast đã thử lại ba lần, tuân theo Retry-After của nhà cung cấp. Hãy chờ một phút rồi chuyển đổi lại.
  • “Lượt nhập này không còn khóa API. Hãy bắt đầu lại và dán khóa.”: lần nhập đã kết thúc hoặc bị hủy, nên khóa đã bị xóa. Hãy bắt đầu một lần nhập mới.

Liên quan

Phần tiêu đề “Liên quan”
Báo lỗi trang nàyTrang chủ ReputeCastHostReputeNội dung theo giấy phép CC BY 4.0