Tạo và xuất bản 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, transactional:publishnhạy cảm
Trong ứng dụng:: Giao dịch, rồi Mẫu

Tạo mẫu email giao dịch trong chế độ giao dịch của trình soạn thảo, khai báo các biến mà ứng dụng của bạn gửi, và xuất bản phiên bản mới mà không làm hỏng các lệnh gọi ứng dụng đang thực hiện.

Trước khi bắt đầu

transactional:edit để tạo mẫu và lưu bản nháp; transactional:publish để xuất bản, quay lại phiên bản cũ, lưu trữ hoặc xóa mẫu. Biên tập viên chỉnh sửa được; xuất bản là một quyền nhạy cảm.
Một người gửi Giao dịch đã xác minh. Xem thêm tên miền gửi thư và người gửi.
Đọc cách email giao dịch hoạt động nếu bạn chưa quen với danh mục và tuyến Giao dịch.

Tạo một mẫu

Mở Giao dịch, rồi Mẫu rồi chọn Mẫu mới. Bắt đầu từ một mẫu khởi đầu (Đặt lại mật khẩu, Liên kết đăng nhập, Xác minh email, Chào mừng, Biên nhận hoặc hóa đơn, Sắp hết thời gian dùng thử, Lời mời vào nhóm, Cảnh báo mức sử dụng) hoặc từ một mẫu trống. Để mang mẫu từ nền tảng khác sang, dùng Nhập mẫu (xem nhập mẫu email giao dịch).
Ở phần đầu trang, đặt tên, ID mà ứng dụng của bạn gọi (ví dụ password-reset) và danh mục. ID dùng chữ thường, chữ số và từng dấu gạch ngang đơn, tối đa 64 ký tự. ID được cố định sau lần xuất bản đầu tiên; để dùng ID khác về sau, hãy nhân bản mẫu.
Viết Tiêu đề và Dòng xem trước. Cả hai đều nhận biến Liquid như {{ expires_in }}. Bản xem trước hộp thư bên cạnh kết xuất với dữ liệu thử đang chọn.
Thiết kế phần thân bằng các khối giống trình soạn thảo, cùng các khối ReputeCast Đầu thư + logo, Dòng hóa đơn và Chân thư giao dịch. Mẫu Thiết yếu có chân thư giao dịch với tên công ty và địa chỉ, không có liên kết hủy đăng ký; danh mục Tùy chọn có chân thư kèm liên kết hủy đăng ký.

Ảnh chụp này hiển thị giao diện tiếng Anh.
Mở tab Biến và chọn Khai báo cho mỗi giá trị mà ứng dụng của bạn gửi. Một biến có kiểu (Văn bản, Số, Có/không, Ngày, URL, Danh sách hoặc Đối tượng), có thể là Bắt buộc, có Giá trị mẫu dùng cho bản xem trước, và một giá trị mặc định không bắt buộc dùng khi biến bị thiếu. Đánh dấu một biến là Nhạy cảm cho các giá trị bí mật như liên kết đặt lại mật khẩu: biến đó không bao giờ được lưu, nhật ký và nội dung được lưu hiển thị ••••••, và không thể Gửi lại những thư đó. Bảng này cho bạn biết khi một biến trong nội dung chưa được khai báo, hoặc một biến đã khai báo nhưng không được dùng.
Mở tab Dữ liệu thử để lưu các bộ giá trị mẫu có tên (sửa dưới dạng JSON), ví dụ “Người dùng mới” và “Không có tên”. Bản xem trước, phần kiểm tra và các lần kết xuất thử trước khi xuất bản đều dùng các bộ này. Dùng Xem trước với phía trên khung thiết kế để chuyển giữa các bộ.
Mở tab Kiểm tra để sửa các lỗi về nội dung, khả năng tiếp cận và liên kết, rồi dùng Gửi thử để gửi thử cho chính bạn. Bản nháp tự lưu; ⌘ S lưu ngay.

Xuất bản một phiên bản

Chỉ phiên bản đã xuất bản mới được gửi. Ứng dụng của bạn luôn nhận phiên bản đang chạy; bản nháp không bao giờ được gửi.

Chọn Xuất bản (hoặc Xuất bản v2, v.v.) trên thanh trên cùng.
Đọc Những gì thay đổi: phần khác biệt về tiêu đề, dòng xem trước, biến và nội dung so với phiên bản đang chạy. Hiện toàn bộ khác biệt mở toàn bộ phần này.
Nếu thay đổi sẽ làm hỏng các lệnh gọi từ ứng dụng của bạn, hộp thoại sẽ báo. ReputeCast so sánh các biến bắt buộc mới với các lệnh gọi trong 7 ngày qua. Ví dụ, một biến bắt buộc mới mà không lệnh gọi nào trong số đó gửi sẽ làm chúng thất bại với missing_variables. Chọn cách xuất bản:
- Đặt biến thành không bắt buộc, với giá trị mặc định (khuyến nghị): các lệnh gọi cũ vẫn hoạt động và in ra giá trị mặc định cho đến khi ứng dụng của bạn gửi biến này.
- Giữ biến bắt buộc và cập nhật ứng dụng trước: xuất bản sau, và sao chép payload mới cho các nhà phát triển của bạn.
- Vẫn xuất bản: các lệnh gọi thiếu biến sẽ thất bại cho đến khi ứng dụng được cập nhật.
Ảnh chụp này hiển thị giao diện tiếng Anh.
Xác nhận. Phiên bản mới trở thành phiên bản mà mọi lệnh gọi API kết xuất; phiên bản trước vẫn nằm trong lịch sử.

Nếu chính sách phê duyệt của không gian làm việc có quy tắc “Xuất bản mẫu giao dịch cũng cần phê duyệt” (mặc định tắt), việc xuất bản sẽ cần một người phê duyệt trước; xem yêu cầu phê duyệt cho các lần gửi rủi ro. Khi chính sách khả năng tiếp cận của không gian làm việc được đặt là Chặn, các lỗi khả năng tiếp cận nghiêm trọng cũng chặn việc xuất bản.

Quay lại phiên bản cũ

Mở Phiên bản, chọn một phiên bản cũ hơn rồi chọn Xuất bản lại. Phiên bản đó trở thành phiên bản mà mọi lệnh gọi API kết xuất; các phiên bản mới hơn vẫn nằm trong lịch sử, và bản nháp của bạn không thay đổi.

Kiểm tra kết quả

Phần đầu trang hiển thị phiên bản đang chạy, ví dụ v3 đang chạy · bản nháp giống v3.
Một lệnh gọi kết xuất trả về tiêu đề và nội dung mới mà không gửi thư; xem gửi email giao dịch bằng API.
Thư mới trong nhật ký thư hiển thị phiên bản mới.

Khắc phục sự cố

Lệnh gọi thất bại với template_not_published → mẫu có bản nháp nhưng chưa có phiên bản đang chạy. Hãy xuất bản mẫu.
Lệnh gọi thất bại với missing_variables → lệnh gọi thiếu một biến bắt buộc. Hãy gửi biến đó, hoặc đặt biến thành không bắt buộc với giá trị mặc định rồi xuất bản lại.
Trường ID ở chế độ chỉ đọc → mẫu đã được xuất bản. Hãy nhân bản mẫu để dùng ID khác.
Nút xuất bản bị vô hiệu hóa với thông báo “Không có thay đổi từ v3” → bản nháp giống phiên bản đang chạy; không có gì mới để xuất bản.

Liên quan

Gửi email giao dịch đầu tiên
Gửi cho mỗi người đọc đúng ngôn ngữ của họ (phiên bản ngôn ngữ cũng dùng được cho mẫu)
Danh mục, thời gian lưu và cảnh báo