📝 Mẫu tin Zalo
Mẫu tin Zalo (Zalo Transaction Template) cho phép bạn soạn sẵn nội dung tin nhắn Zalo dạng tin giao dịch (transaction message) — gồm banner, tiêu đề, nội dung và bảng thông tin — rồi gắn dữ liệu động từ record nghiệp vụ (ví dụ theo đơn bán) để tái sử dụng mỗi khi gửi cho khách hàng đã quan tâm OA. Tin được gửi qua kết nối Zalo OA của hệ thống Xbook.
📷 Cần chèn ảnh:
/img/integrations/zalo-template/01.png— Danh sách Mẫu tin giao dịch (Transaction Templates).
🗂️ Mở danh sách mẫu tin
- Vào Zalo → Management → Transaction Management → Transaction Templates.
- Danh sách hiển thị Tên mẫu (Template Name) và Loại mẫu (Template Type).
- Nhấn Mới để tạo một mẫu tin mới.
💡 Khi tạo mới, hệ thống tự sinh sẵn 4 thành phần (element) mặc định theo thứ tự: Banner → Header (Tiêu đề) → Text (Nội dung chính) → Table (Bảng). Bạn chỉ cần chỉnh sửa lại nội dung từng phần.
➕ Tạo mẫu tin
- Tại form mẫu tin, nhập Tên mẫu (Template Name).
- Chọn Loại mẫu (Template Type) — tương ứng loại tin giao dịch Zalo, ví dụ Billing, Order, Reward, Contract, Booking, Membership, Event, Transaction, Account, Internal, Partnership, Education, Rating.
- Mở thẻ Elements để chỉnh sửa từng thành phần của tin.
- Lưu.
Khung Preview ở cột bên phải form sẽ hiển thị bản xem trước tin nhắn theo nội dung bạn đang soạn.
📷 Cần chèn ảnh:
/img/integrations/zalo-template/02.png— Form mẫu tin với thẻ Elements và khung Preview bên phải.
Bảng trường mẫu tin
| Trường | Ý nghĩa |
|---|---|
| Template Name | Tên định danh của mẫu tin. |
| Template Type | Loại tin giao dịch Zalo (Billing, Order, Reward...). |
| Elements | Các thành phần nội dung của tin (banner / header / text / table), chỉnh trong thẻ Elements. |
💡 Ngôn ngữ tin (Vietnamese / English) không nhập tay trên form — khi gửi tự động, hệ thống chọn ngôn ngữ theo ngôn ngữ (lang) của khách hàng nhận tin.
🧩 Chỉnh sửa thành phần (Element)
Mỗi tin gồm các thành phần (element) với Element Type khác nhau:
| Trường | Ý nghĩa |
|---|---|
| Banner | Ảnh đầu tin. Chọn một trong hai: nhập Image URL hoặc tải ảnh Attachment Image. |
| Header | Tiêu đề tin (tối đa 100 ký tự sau khi bỏ thẻ HTML). |
| Text | Nội dung tin (tối đa 2 đoạn, mỗi đoạn ≤ 250 ký tự). |
| Table | Bảng thông tin gồm nhiều dòng (key – value). |
| Align | Căn lề nội dung: trái / giữa / phải. |
⚠️ Với Banner: ảnh phải là JPG/PNG, dung lượng ≤ 1MB, tỷ lệ (cao : rộng) từ 1:5 đến 1:1. Nếu dùng Image URL thì địa chỉ phải bắt đầu bằng
https://và kết thúc bằng.jpghoặc.png. Chỉ được chọn một trong hai cách (URL hoặc tải ảnh), không dùng đồng thời.
📷 Cần chèn ảnh:
/img/integrations/zalo-template/03.png— Form chỉnh sửa thành phần Banner.
Bảng thông tin động (Table)
Trong thành phần Table, mỗi dòng (table line) cho phép gắn dữ liệu lấy động từ record nghiệp vụ:
- Tại thành phần loại Table, mở thẻ Table.
- Nhập Key — nhãn hiển thị của dòng (≤ 35 ký tự).
- Chọn Field và nhập Field Path nếu cần đi sâu qua quan hệ (ví dụ
garage_repair_id.vehicle_id.name). - Cột Value hiển thị giá trị mẫu lấy từ record để xem trước (≤ 100 ký tự khi gửi).
- Chọn Style để tô màu giá trị:
green,blue,yellow,red,grey.
💡 Mỗi bảng tối đa 8 dòng và cần ít nhất 1 dòng bắt buộc (ví dụ: mã đơn / mã giao dịch, tên khách hàng hoặc trạng thái). Hệ thống tự định dạng số tiền (kèm "VND") và ngày/giờ khi lấy giá trị từ record.
📷 Cần chèn ảnh:
/img/integrations/zalo-template/04.png— Thẻ Table với các dòng key – field – value.
🔘 Nút thao tác (Button)
Mỗi mẫu tin có thể gắn kèm các nút thao tác (button) hiển thị cuối tin. Mỗi mẫu tối đa 4 nút, mỗi Title ≤ 35 ký tự.
| Trường | Ý nghĩa |
|---|---|
| Title | Nhãn nút. |
| Type | Loại nút: Open URL, Query Show, Query Hide, Open SMS, Open Phone. |
| URL | Liên kết mở khi chọn loại Open URL. |
| Query Data | Dữ liệu callback cho Query Show/Hide (ví dụ #callback_data). |
| SMS Content / SMS Phone Code | Nội dung và số nhận với loại Open SMS (nội dung ≤ 160 ký tự). |
| Phone Code | Số điện thoại với loại Open Phone. |
| Image Icon | Biểu tượng nút: nhập URL http(s), attachment_id, hoặc để trống / default để dùng icon mặc định của Zalo. |
📷 Cần chèn ảnh:
/img/integrations/zalo-template/05.png— Form nút thao tác (Button).
📤 Gửi tin tự động theo đơn bán
Hệ thống dùng tên mẫu để liên kết với nghiệp vụ đơn bán:
- Tạo mẫu tin đặt tên
confirm_orderđể gửi khi xác nhận đơn bán. - Tạo mẫu tin đặt tên
cancel_orderđể gửi khi hủy đơn bán. - Khi đơn bán được xác nhận hoặc hủy, hệ thống tự tìm mẫu tương ứng và gửi tin cho khách hàng có gắn Zalo User (Zalo User ID) trên đối tác (partner).
💡 Tin chỉ gửi được khi đối tác của đơn đã liên kết tài khoản Zalo (đã quan tâm OA). Nếu đơn có liên kết Portal, nút loại Open URL trong mẫu sẽ được gắn sẵn đường dẫn Portal đầy đủ của đơn khi gửi.
Ngoài ra, trên form đơn bán (sale.order) có nút Download JSON (hiển thị khi đơn ở trạng thái Đã xác nhận hoặc Đã hủy) để xuất payload tin Zalo của đơn ra file JSON.
📷 Cần chèn ảnh:
/img/integrations/zalo-template/06.png— Nút Download JSON trên form đơn bán.