Quy Trình Phê Duyệt ZNS Template API – Những Điều Nhất Định Phải Biết

Mỗi ngày, doanh nghiệp phải xử lý hàng nghìn giao dịch: đơn hàng, thanh toán, xác thực đăng nhập, nhắc nợ… Nhưng nếu khách hàng không nhận kịp thông báo, trải nghiệm sẽ bị gián đoạn và uy tín thương hiệu bị ảnh hưởng. Đây chính là lúc ZNS Template API phát huy sức mạnh, giúp doanh nghiệp gửi thông điệp tự động, đúng người – đúng thời điểm – đúng ngữ cảnh, ngay trên ứng dụng Zalo mà khách hàng đã quen thuộc.

ĐĂNG KÝ TƯ VẤN

>>> Xem thêm: API ZNS Và Chiến Dịch ZNS: Phân Biệt Để Chọn Phương Án Phù Hợp

1. Điều kiện cần trước khi xây dựng ZNS Template API

Tài khoản và phân quyền bắt buộc

– Zalo Cloud Account (ZCA): Doanh nghiệp cần một tài khoản ZCA để quản trị dịch vụ, nhận thông báo phê duyệt và theo dõi trạng thái mẫu. Mọi cập nhật/trạng thái duyệt–từ chối sẽ được gửi về ZCA và hiển thị trong mục thông báo.

– Zalo Official Account (OA): OA là thương hiệu hiển thị khi gửi ZNS. OA phải được liên kết với ZCA để sử dụng các tính năng trả phí (ZNS). Người thực hiện liên kết cần có quyền Quản trị viên OA.

– App/Ứng dụng (AppID): AppID là đại diện kỹ thuật thay mặt OA gọi API ZNS. App cần liên kết với ZCA; người liên kết phải có quyền Quản trị viên của ứng dụng. Ai được phép đăng ký/thiết lập mẫu: Quản trị viên OA hoặc Đại lý/Đối tác dịch vụ được Zalo Cloud công nhận.

Kích hoạt dịch vụ và tuân thủ chính sách

– Bắt buộc tạo và gửi duyệt Template trước khi gọi API: Đây là điều kiện tiên quyết để được gửi ZNS theo mẫu.

– Duy trì chất lượng gửi: Quyền lợi gửi và phạm vi loại nội dung có thể mở rộng khi OA duy trì chất lượng gửi tốt (tỷ lệ phản hồi tiêu cực thấp). Zalo có cơ chế đánh giá chất lượng và điều chỉnh quyền lợi dựa trên phản hồi người nhận.

Phạm vi nội dung và mục đích hợp lệ

Tính chất giao dịch/CSKH: Mẫu phải liên quan đến một giao dịch đã phát sinh hoặc thông tin dịch vụ dành cho khách hàng hiện hữu, giúp người nhận hiểu vì sao họ nhận được thông báo. Nội dung quảng cáo/khuyến mãi không được khuyến khích trong ZNS theo mẫu.

Yêu cầu với OTP: Thông báo OTP cần nêu rõ tên website/ứng dụng áp dụng mã xác thực.

Tham số định danh bắt buộc: Mẫu phải có ít nhất 1 tham số đặc trưng để định danh (ví dụ: tên/mã khách hàng, mã đơn, số tiền, ngày giao dịch…).

Yêu cầu về cấu trúc template và tham số 

Một ngôn ngữ thống nhất: Không trộn ngôn ngữ; tiếng Việt cần có dấu, không lỗi chính tả, không dùng icon/ký tự đặc biệt.

Chuẩn tham số: Đặt trong dấu “<…>”, không dấu, không dùng dấu cách/gạch nối; các từ ngăn cách bằng gạch dưới. Tránh xưng hô “anh/chị”; ưu tiên biến giới tính hoặc từ trung tính (“bạn”, “quý khách”, “khách hàng”, …). Nội dung phải có tiền tố giải thích cho từng tham số để tránh hiểu lầm.

Tính nhất quán hiển thị: Doanh nghiệp chịu trách nhiệm bảo đảm kết quả hiển thị đúng cấu trúc đã được duyệt trên thiết bị người dùng cuối. Nếu thay đổi cấu trúc, phải đăng ký duyệt lại.

>>> Xem thêm: Hướng Dẫn Nâng Cấp Zalo OA Chi Tiết Mới Nhất 2025

Logo và tuỳ chọn mô-đun hình ảnh

– Logo: Cần phiên bản light/dark nhất quán, chất lượng tốt, thể hiện rõ thương hiệu (tên OA/doanh nghiệp). Khi đã được duyệt, không thể chỉnh sửa; nếu cần đổi hình (ví dụ thêm ảnh), phải tạo mẫu mới.

– Mô-đun hình ảnh (mới): Zalo Cloud đang triển khai hướng dẫn xét duyệt template có hình ảnh để tăng tương tác; doanh nghiệp cần tuân thủ tiêu chuẩn riêng cho loại mẫu này. 

Nút thao tác (CTA) và quy định liên kết

Không chèn link/số điện thoại trong nội dung: Tất cả đường link & số điện thoại phải đặt trong CTA (nút chính/phụ). Một mẫu có thể có tối đa 2 CTA.

Không dùng link rút gọn: Không sử dụng bitly, onelink… hoặc các link không khả dụng/không công khai rõ ràng. 

Param trong CTA: Hỗ trợ tham số hoá URL/số liên hệ theo từng người dùng; dữ liệu truyền vào phải UTF-8. Sai định dạng sẽ lỗi -132 Parameter invalid.

Quy trình phê duyệt và thời gian

Thời gian xử lý: Thông thường khoảng 2–3 ngày làm việc cho việc duyệt đăng ký/thay đổi cấu trúc template, kết quả được thông báo qua OA ZNS và trang thông báo trong ZCA.

Không sửa được sau khi duyệt: Nếu muốn thay đổi cấu trúc (kể cả thêm hình ảnh), cần tạo mẫu mới và gửi duyệt lại.

Tuân thủ pháp luật và chuẩn mực

Nội dung không vi phạm pháp luật Việt Nam, không gây hiểu lầm, không dùng ngôn từ mê tín/lừa gạt, văn phong chuyên nghiệp, rõ ràng, trình bày đúng tag/mục đích gửi. 

2. Các loại mẫu ZNS Template API phổ biến

Zalo hiện hỗ trợ một số loại mẫu ZNS chuẩn hoá, phục vụ cho những mục đích khác nhau. Việc chọn đúng loại mẫu không chỉ giúp doanh nghiệp truyền tải thông tin rõ ràng mà còn tăng khả năng được phê duyệt nhanh chóng. 

Mẫu văn bản

Đặc điểm: Đây là loại mẫu cơ bản nhất, chỉ bao gồm nội dung chữ. Doanh nghiệp có thể chèn tham số động (param) để cá nhân hoá thông tin cho từng khách hàng.

Ứng dụng thực tế: Thông báo đơn hàng đã được xác nhận, thông tin giao dịch ngân hàng, nhắc nhở lịch hẹn dịch vụ.

Ưu điểm: Dễ tạo, nhanh được duyệt, tối ưu cho nội dung ngắn gọn, rõ ràng.

Lưu ý: Nội dung phải có ít nhất một tham số định danh (ví dụ: tên khách hàng, mã đơn hàng, ngày giao dịch…) để tăng tính xác thực.

Mẫu bảng 

ZNS loại bảng cho phép trình bày dữ liệu dưới dạng bảng, giúp sắp xếp thông tin có cấu trúc.

Ứng dụng thực tế: Trình bày hóa đơn thanh toán chi tiết, sao kê tài khoản định kỳ, bảng thông tin sản phẩm/dịch vụ.

Ưu điểm: Trình bày trực quan, dễ đọc. Phù hợp cho các giao dịch có nhiều trường dữ liệu.

Lưu ý: Doanh nghiệp phải đảm bảo bảng hiển thị đúng như bản đã duyệt, không thay đổi cấu trúc sau này. Nếu thay đổi → phải tạo mẫu mới.

Mẫu OTP 

Đặc điểm: Mẫu chuyên biệt để gửi mã xác thực một lần (OTP) khi khách hàng đăng nhập, thanh toán, hoặc thực hiện thao tác quan trọng.

Ứng dụng thực tế: Xác minh giao dịch tài chính. Bảo mật tài khoản khi đăng nhập. Xác nhận thanh toán trực tuyến.

Ưu điểm: Hỗ trợ gửi OTP ngay cả ngoài khung giờ 22h–6h sáng, giúp đảm bảo an toàn cho các giao dịch khẩn. Được Zalo ưu tiên duyệt nhanh do tính chất bảo mật.

Lưu ý: Nội dung OTP phải nêu rõ tên website/ứng dụng phát hành mã, để người dùng biết nguồn gốc và tránh nhầm lẫn.

>>> Xem thêm: Tư Vấn Zalo OA Nâng Cấp – Khi Nào Nên Chuyển Sang Gói Trả Phí?

Mẫu đánh giá dịch vụ 

Đặc điểm: Mẫu này cho phép doanh nghiệp thu thập phản hồi trực tiếp từ khách hàng thông qua nút hành động (CTA).

Ứng dụng thực tế: Khảo sát chất lượng dịch vụ sau khi mua hàng. Đo lường mức độ hài lòng (CSAT/NPS). Thu thập ý kiến về sản phẩm mới.

Ưu điểm: Tăng tương tác trực tiếp giữa doanh nghiệp và khách hàng. Hỗ trợ doanh nghiệp cải thiện chất lượng dịch vụ nhờ dữ liệu phản hồi.

Lưu ý: Các đường dẫn khảo sát phải là link hợp lệ, công khai rõ ràng, không dùng link rút gọn (bitly, tinyurl…). Tránh đặt số điện thoại trực tiếp trong nội dung; chỉ nên dùng trong CTA button.

ĐĂNG KÝ TƯ VẤN

3. Quy trình tạo và gửi duyệt ZNS Template API

Để sử dụng ZNS Template API, doanh nghiệp bắt buộc phải trải qua quy trình tạo mẫu – gửi duyệt – nhận kết quả. Zalo áp dụng quy trình này nhằm đảm bảo tất cả thông báo gửi tới khách hàng đều hợp pháp, chính xác và đúng mục đích chăm sóc khách hàng.

Bước 1: Truy cập Zalo Cloud

Đăng nhập vào ZCA – trung tâm quản lý dịch vụ ZNS. Tại dashboard, chọn Quản lý ZNS → Template API để bắt đầu quá trình tạo mẫu. Đảm bảo Official Account (OA) và AppID đã được liên kết trước đó; nếu chưa, hệ thống sẽ yêu cầu liên kết để tiếp tục.

Bước 2: Chọn loại mẫu phù hợp

Doanh nghiệp sẽ lựa chọn loại template dựa trên mục đích gửi tin:

Văn bản (Text Template): Thông báo ngắn gọn.

Bảng (Table Template): Hóa đơn/sao kê.

OTP Template: Xác thực đăng nhập/giao dịch.

Survey Template: Khảo sát ý kiến.

Việc chọn sai loại mẫu có thể dẫn đến việc từ chối phê duyệt, do đó cần xác định rõ kịch bản sử dụng ngay từ đầu.

Bước 3: Thiết kế nội dung mẫu & thêm tham số động

Soạn nội dung thông báo theo đúng quy chuẩn của Zalo: Một ngôn ngữ thống nhất (không pha trộn Việt – Anh). Không icon, không ký tự đặc biệt, không viết tắt gây hiểu lầm. Ít nhất 1 tham số động để cá nhân hoá (ví dụ: <ten_khach_hang>, <ma_don_hang>).

Các tham số động phải đặt trong dấu “<…>”, không dấu, viết bằng ký tự thường, ngăn cách bằng gạch dưới. Có ngữ cảnh rõ ràng đi kèm để khách hàng hiểu tham số đó là gì. Trước khi gửi duyệt, doanh nghiệp nên kiểm tra hiển thị trên thiết bị thật để đảm bảo kết quả không sai lệch.

Bước 4: Tích hợp CTA (Call to Action)

Zalo chỉ cho phép đặt link hoặc số điện thoại trong nút CTA, không được chèn trực tiếp trong nội dung tin nhắn.cMột template có thể chứa tối đa 02 CTA button (nút chính + phụ).

Quy tắc quan trọng: Không dùng link rút gọn (bitly, tinyurl…). Đường link phải hợp lệ, công khai và dẫn đúng nội dung. Số điện thoại CTA phải ở định dạng chuẩn quốc tế hoặc trong nước. Nếu cấu hình sai định dạng URL/phone, hệ thống sẽ báo lỗi -132 Parameter invalid khi gọi API.

Bước 5: Gửi phê duyệt và chờ xét duyệt

Sau khi hoàn tất thiết kế, doanh nghiệp nhấn “Gửi duyệt”, hệ thống Zalo Cloud sẽ tiến hành kiểm duyệt mẫu theo các tiêu chí: Nội dung có phù hợp với mục đích CSKH/giao dịch không, có vi phạm chính sách quảng cáo, spam hoặc pháp luật Việt Nam không, tham số động, CTA, logo có đúng định dạng không.

Thời gian xử lý sẽ thường trong vòng 2–3 ngày làm việc, kết quả phê duyệt sẽ được gửi về: OA “Zalo Notification Service” (trong hộp thư OA) hoặc trang thông báo của ZCA Portal.

>>> Xem thêm: Gói Nâng Cấp Zalo – Mở Rộng Giới Hạn, Nhân Đôi Hiệu Quả

Lưu ý quan trọng trong quá trình gửi duyệt

Một khi template đã được phê duyệt, không thể chỉnh sửa nội dung hoặc cấu trúc. Nếu muốn thay đổi → cần tạo mẫu mới và gửi duyệt lại. Nếu mẫu bị từ chối, hệ thống sẽ gửi lý do chi tiết. Doanh nghiệp có thể chỉnh sửa và gửi lại ngay trên ZCA.

Để rút ngắn thời gian phê duyệt, nên sử dụng nội dung rõ ràng, minh bạch, không mập mờ, đặt CTA hợp lệ, không spam, không link ẩn, kiểm tra param hiển thị hợp lý trước khi nộp duyệt.

4. Trạng thái phê duyệt và cách xử lý

Sau khi doanh nghiệp tạo và gửi duyệt ZNS Template, hệ thống Zalo Cloud sẽ tiến hành kiểm tra và trả về trạng thái. Việc nắm rõ các trạng thái giúp bạn chủ động theo dõi tiến độ, xử lý nhanh nếu bị từ chối, và đảm bảo không gián đoạn trong chăm sóc khách hàng.

Các trạng thái phê duyệt của ZNS Template

Đang chờ duyệt

Đây là trạng thái mặc định ngay sau khi bạn gửi template. Đây sẽ là những mẫu đang được bộ phận kiểm duyệt của Zalo xem xét về nội dung, tham số, CTA, logo.
Thời gian duyệt: thường trong vòng 2–3 ngày làm việc. Trong thời gian này, mẫu không thể sử dụng để gửi ZNS.

Được phê duyệt và kích hoạt

Nghĩa là template của bạn đã được Zalo chấp thuận và có thể sử dụng ngay trong API. Trạng thái này đồng nghĩa doanh nghiệp có thể tạo lệnh API gửi tin theo mẫu cho khách hàng. Lúc này, bạn cần tích hợp ngay vào hệ thống CSKH hoặc CRM để triển khai thực tế.

Từ chối phê duyệt

Khi mẫu bị từ chối, hệ thống sẽ gửi kèm lý do chi tiết qua OA Zalo Notification Service, trang thông báo trong ZCA Portal.

Một số lý do phổ biến khiến bị từ chối:

– Nội dung không liên quan đến giao dịch/CSKH, mang tính quảng cáo.

– Sử dụng ngôn ngữ sai chuẩn (icon, ký tự đặc biệt, lỗi chính tả).

– Không có tham số định danh, hoặc tham số đặt sai định dạng.

– Chèn trực tiếp link/số điện thoại trong nội dung thay vì CTA.

– Sử dụng link rút gọn (bitly, tinyurl…).

– Logo không đạt chuẩn hoặc sai lệch với thương hiệu.

Cách xử lý khi template bị từ chối

Xem lại lý do từ chối: Mỗi lần từ chối sẽ đi kèm thông báo chi tiết → giúp doanh nghiệp chỉnh sửa chính xác.

Sửa nội dung và gửi lại: Điều chỉnh theo đúng hướng dẫn (ví dụ: thêm tham số <ma_don_hang>, đổi link trong CTA). Sau khi sửa xong, nhấn “Gửi duyệt lại” trực tiếp trên ZCA. Tạo mới nếu thay đổi cấu trúc: Nếu bạn muốn chỉnh sửa sâu hơn về bố cục hoặc thêm/bớt tham số, cần tạo template mới thay vì sửa mẫu cũ. Hãy tránh lặp lại lỗi tương tự để rút ngắn thời gian duyệt về sau.

Một số lưu ý quan trọng

Trong giai đoạn đang chờ duyệt, doanh nghiệp không nên thử gửi API vì rất dễ bị lỗi. Sau khi template ở trạng thái được phê duyệt, bạn có thể tích hợp và gọi API bất kỳ lúc nào.

Nếu bị từ chối nhiều lần liên tiếp, hệ thống có thể đánh giá bạn chưa tuân thủ chính sách, dẫn đến việc thắt chặt hơn khi duyệt những mẫu sau.Nên duy trì lịch sử gửi tin lành mạnh: tỷ lệ spam thấp, nội dung rõ ràng → điều này giúp các template sau được duyệt nhanh hơn.

ĐĂNG KÝ TƯ VẤN

Việc triển khai ZNS Template API không chỉ đòi hỏi năng lực kỹ thuật mà còn yêu cầu sự tuân thủ chặt chẽ chính sách của Zalo. Một template rõ ràng, minh bạch và phù hợp mục đích CSKH sẽ được duyệt nhanh chóng, giúp doanh nghiệp tiết kiệm thời gian và hạn chế rủi ro.

Thông tin chi tiết xin vui lòng liên hệ:

CÔNG TY CỔ PHẦN GIẢI PHÁP DOANH NGHIỆP VIHAT

Website: vihatsolutions.com

Hotline: 0901 888 484

Email: cs@vihatgroup.com 

VP trụ sở ViHAT Solutions: 140 -142, Đường số 2 (KĐT Vạn Phúc City), P. Hiệp Bình Chánh, Tp. Thủ Đức, Tp. Hồ Chí Minh. 

VP chi nhánh Hà Nội: 85-87 Đường Hoàng Quốc Việt, Nghĩa Đô, Cầu Giấy (Tòa nhà An Hưng). 

VP Chi nhánh Cambodia: Thida Rath #154 St.33MC, Sangkat Steung Meanchey, Khan Mean Chey Phnom Penh. 

Vân Nguyễn