# Mẫu tin (Templates)
# Giới thiệu
Mẫu tin (templates) do bạn tạo ra trên hệ thống quản lý ZNS - Zalo Notification Service và được sử dụng bởi các Hooks khi Sync templates
xuống WHMCS.
Mỗi template và hook sẽ có những tham số (params) tương ứng khác nhau được quy định khi tạo template trên hệ thống của ZNS.
Các params hỗ trợ được #CODETAY chỉ định sẵn trong từng Hook, vui lòng xem cách khai báo và tạo template ứng với các params bên dưới.
# Các Templates hỗ trợ
Tương ứng với mỗi Hooks thì bạn nên tạo 1 template cùng tên để có thể sử dụng trên hệ thống WHMCS của bạn.
Các Templates nên tạo tương ứng với các Hooks !
- AcceptOrder
- AfterModuleChangePackage
- AfterModuleChangePassword
- AfterModuleCreate
- AfterModuleSuspend
- AfterModuleUnsuspend
- AfterRegistrarRegistration
- AfterRegistrarRenewal
- ClientAdd
- ClientChangePassword
- DailyCronJob
- InvoiceCreated
- InvoicePaid
- InvoicePaymentReminder
- TicketAdminReply
- TicketClose
- UserChangePassword
Map Hooks với Templates
Thông thường tên Templates nên đặt theo tên các Hooks để dễ quản lý và việc map hook với template tương ứng sẽ dễ dàng hơn rất nhiều sau này !
# Giao diện quản lý Templates
Sau khi kích hoạt thành công modules, bạn truy cập vào khu vực quản lý Templates sẽ thấy giao diện như sau (có thể khác do bạn chưa sync templates).
# Sync Templates
Việc này sẽ sync các Templates mà modules đang hỗ trợ trên ZNS xuống để nạp vào hệ thống quản lý. Bạn tiến hành bấm vào nút Sync Templates
ở góc trên bên phải để tiến hành quá trình này.
TIP
Quá trình này có thể lặp lại mỗi lần có Templates mới được tạo ra trên ZNS.
# Chi tiết Template
Mỗi một template sẽ có các thông số sau:
- ID
- Name (Tên)
- Hook
- Params
- Sent (Số tin đã gửi)
- Status (Trạng thái hoạt động)
- Xem mẫu
ID
Đây chính là mã số của template trên ZNS
Tên Template
Đây chính là tên template trên ZNS
Tên Hook
Đây chính là tên hook đang sử dụng template này
Params
Đây là các params (tham số) được khai báo khi tạo template trên ZNS, các params được tạo ra cần tham khảo phần hỗ trợ params tương ứng với mỗi Hook
Số tin đã gửi
Số tin đã được gửi thông qua template này dựa vào lịch sử gửi tin
Trạng thái hoạt động
Trạng thái kiểm duyệt mẫu tin có hợp lệ hay không trên hệ thống ZNS
Trạng thái kiểm duyệt của mẫu tin
Trạng thái này phụ thuộc vào sự kiểm duyệt từ phía ZNS, modules không can thiệp vào quá trình kiểm duyệt của mẫu tin.
Xem mẫu
Đây là bản hiển thị xem trước của mẫu tin do ZNS sinh ra.
# Tạo Template
Truy cập vào khu vực Quản lý mẫu tin ZNS sau đó nhấn vào nút Tạo mẫu tin
ở góc trên bên phải.
Chọn mẫu tin mà bạn muốn hiển thị, tùy thuộc vào mục đích sử dụng của bạn mà chọn dạng mẫu tin tương ứng trong hộp thoại:
Đặt tên cho mẫu tin ở khu vực khoanh đỏ và chọn Offical Account để tiến hành tạo template ở bước tiếp theo bên dưới:
Tiến hành thêm bớt tham số tương ứng đối với template mà bạn đang tạo, trong hình là các mục đóng khung đỏ.
Kiểu và độ dài của Params
Mỗi một params ZNS quy định độ dài và kiểu dữ liệu có thể dùng cho tham số đó, bạn có thể chọn tương ứng kiểu dữ liệu trong khung xổ xuống bên phải tên params.
Bước cuối cùng là mô tả mục đích của template mà bạn đang muốn tạo để hoàn tất quá trình tạo 1 template cơ bản, sau đó nhấn nút Tạo mẫu tin
để hoàn thành quá trình này.
← Hooks Access Token →