Cách gửi tin ZNS Zalo OA: tạo mẫu tin và kết nối phần mềm
Hướng dẫn gửi tin ZNS Zalo OA từng bước: chuẩn bị và xác thực OA, tạo ứng dụng, đăng ký mẫu tin, lấy access token, gọi API từ phần mềm và theo dõi kết quả.

Tóm tắt nhanh
Để gửi tin ZNS qua Zalo OA, doanh nghiệp cần một Zalo Official Account đã xác thực, một ứng dụng trên Zalo for Developers liên kết với OA, tài khoản thanh toán dịch vụ, mẫu tin ZNS đã được Zalo duyệt và access token. Phần mềm gọi API gửi tin theo số điện thoại khách, truyền mã mẫu và dữ liệu, rồi theo dõi trạng thái gửi.
- ZNS (Zalo Notification Service) gửi tin thông báo theo mẫu đã duyệt tới số điện thoại có dùng Zalo
- Cần Zalo OA đã xác thực, ứng dụng trên Zalo for Developers và tài khoản thanh toán dịch vụ
- Mỗi mẫu tin phải được Zalo duyệt, nội dung cố định và chỉ thay đổi ở các tham số
- Phần mềm gọi API bằng access token; token có hạn nên cần cơ chế làm mới tự động
- Phí tính theo tin và chính sách nội dung có thể thay đổi, luôn đối chiếu trang chính thức của Zalo
Mục lục bài viết
- ZNS là gì và dùng khi nào?
- Bước 1: Chuẩn bị và xác thực Zalo OA
- Bước 2: Tạo ứng dụng trên Zalo for Developers
- Bước 3: Thiết lập tài khoản thanh toán dịch vụ
- Bước 4: Tạo mẫu tin ZNS và chờ duyệt
- Bước 5: Lấy access token và kết nối phần mềm
- Bước 6: Gửi thử và theo dõi trạng thái
- Tóm tắt và bước tiếp theo
- Câu hỏi thường gặp
Tin nhắn Zalo có tỷ lệ được đọc cao hơn email với nhiều nhóm khách hàng Việt Nam, vì vậy ngày càng nhiều doanh nghiệp muốn gửi xác nhận đơn hàng, nhắc lịch hẹn hay thông báo giao hàng qua Zalo. Dịch vụ phù hợp cho việc này là ZNS. Bài viết hướng dẫn gửi tin ZNS Zalo OA theo 6 bước, từ chuẩn bị OA, tạo mẫu tin đến kết nối phần mềm gọi API tự động.
ZNS là gì và dùng khi nào?
ZNS (Zalo Notification Service) là dịch vụ gửi tin thông báo theo mẫu từ Zalo Official Account (OA) tới khách hàng thông qua số điện thoại. Khách không cần quan tâm OA trước vẫn có thể nhận tin, miễn số điện thoại đó có tài khoản Zalo.
Đặc điểm cần nắm:
- Gửi theo mẫu: nội dung cố định đã được Zalo duyệt, chỉ thay đổi ở các tham số như tên khách, mã đơn, ngày hẹn.
- Gửi theo số điện thoại: phù hợp gửi cho khách vừa đặt hàng, đặt lịch mà chưa tương tác với OA.
- Tính phí theo tin: đơn giá và cách tính do Zalo quy định.
- Mục đích chính là thông báo và chăm sóc khách hàng, không phải kênh quảng cáo tự do.
Các tình huống ứng dụng phổ biến:

Tài liệu kỹ thuật chính thức nằm tại Zalo for Developers. Vì giao diện và chính sách của Zalo có thể thay đổi, bài này mô tả quy trình ở mức ổn định; khi thao tác, hãy đối chiếu tài liệu mới nhất.
Bước 1: Chuẩn bị và xác thực Zalo OA
Zalo OA là tài khoản chính thức đại diện cho doanh nghiệp trên Zalo, và là nơi tin ZNS được gửi đi. OA cần được xác thực để sử dụng ZNS.
Những việc cần làm:
- Tạo OA bằng tài khoản Zalo do doanh nghiệp quản lý, không dùng tài khoản cá nhân của nhân viên.
- Đặt tên OA trùng hoặc gần với tên thương hiệu, có ảnh đại diện và ảnh bìa rõ ràng.
- Chuẩn bị giấy tờ doanh nghiệp theo yêu cầu xác thực của Zalo.
- Thêm quản trị viên dự phòng để không mất quyền khi nhân sự thay đổi.
Nếu website của bạn đã có nút chat Zalo trỏ về OA, việc gửi ZNS sẽ giúp kênh Zalo đồng bộ hơn. Cách gắn nút được trình bày trong bài gắn nút Zalo, hotline lên website.
Bước 2: Tạo ứng dụng trên Zalo for Developers
Ứng dụng trên Zalo for Developers là "danh tính kỹ thuật" giúp phần mềm của bạn được phép gọi API thay mặt OA. Mỗi ứng dụng có App ID và khoá bí mật riêng.
Trình tự chung:
- Đăng nhập Zalo for Developers bằng tài khoản quản trị OA.
- Tạo ứng dụng mới, điền tên và mô tả.
- Vào phần cấu hình Official Account của ứng dụng, liên kết với OA của doanh nghiệp.
- Khai báo đường dẫn callback (URL máy chủ của bạn) để nhận mã cấp quyền.
- Ghi lại App ID và khoá bí mật, lưu trong kho bí mật hoặc biến môi trường của máy chủ.
Khoá bí mật của ứng dụng không được đưa vào mã nguồn công khai, ứng dụng di động hay mã JavaScript chạy trên trình duyệt.
Bước 3: Thiết lập tài khoản thanh toán dịch vụ
ZNS là dịch vụ trả phí nên OA cần được liên kết với một tài khoản thanh toán. Không có số dư hoặc phương thức thanh toán hợp lệ, tin sẽ không được gửi.
Theo quy trình hiện hành, việc quản lý dịch vụ và thanh toán ZNS được thực hiện qua tài khoản Zalo Cloud Account (ZCA). Bạn kích hoạt dịch vụ, liên kết OA và nạp tiền hoặc chọn hình thức thanh toán phù hợp. Hãy xem bảng giá và cách tính phí trên trang chính thức, vì đơn giá có thể khác nhau theo loại mẫu tin và thay đổi theo thời gian.
Một mẹo vận hành: đặt cảnh báo khi số dư xuống dưới ngưỡng, vì hết tiền giữa chừng sẽ khiến khách không nhận được xác nhận đơn hàng mà bạn không hề biết.
Bước 4: Tạo mẫu tin ZNS và chờ duyệt
Mẫu tin là khung nội dung cố định, các phần thay đổi được khai báo dưới dạng tham số. Mỗi mẫu phải được Zalo duyệt trước khi dùng.
Ví dụ mẫu "Xác nhận đơn hàng" của một cửa hàng thời trang hư cấu tên Nhã Phong:
Nhã Phong xác nhận đơn hàng của bạn
Khách hàng: <customer_name>
Mã đơn: <order_code>
Tổng tiền: <total>
Dự kiến giao: <delivery_date>
Cảm ơn bạn đã mua sắm tại Nhã Phong.
Lưu ý khi soạn mẫu để tăng khả năng được duyệt:
- Chọn đúng loại mẫu (giao dịch, chăm sóc khách hàng, xác thực…) theo phân loại của Zalo.
- Nội dung rõ ràng, nhận diện được doanh nghiệp gửi, không mang tính quảng cáo nếu loại mẫu không cho phép.
- Khai báo đúng kiểu dữ liệu và độ dài cho từng tham số.
- Không đưa đường dẫn rút gọn khó xác minh.
Sau khi được duyệt, bạn nhận mã mẫu tin (template_id). Mã này sẽ dùng khi gọi API.
Bước 5: Lấy access token và kết nối phần mềm
Access token là chìa khoá tạm thời cho phép phần mềm gọi API của OA. Token có thời hạn, nên phần mềm cần lưu refresh token và tự làm mới. Nếu bạn chưa quen cách các phần mềm "nói chuyện" với nhau, hãy đọc bài API là gì trước.
Luồng cấp quyền theo chuẩn OAuth: quản trị viên OA cấp quyền cho ứng dụng, Zalo chuyển hướng về callback kèm mã cấp quyền, máy chủ của bạn đổi mã đó lấy access token và refresh token. Từ đó, trước khi token hết hạn, máy chủ dùng refresh token để lấy token mới. Chi tiết tham số và thời hạn token, xem tài liệu chính thức vì có thể thay đổi theo phiên bản API.
Khi có token và mã mẫu tin, phần mềm gửi yêu cầu gửi tin. Ví dụ minh hoạ theo tài liệu ZNS (thay giá trị trong ngoặc nhọn bằng dữ liệu thật):
curl -X POST "https://business.openapi.zalo.me/message/template" \
-H "Content-Type: application/json" \
-H "access_token: <ACCESS_TOKEN>" \
-d '{
"phone": "84901234567",
"template_id": "<TEMPLATE_ID>",
"template_data": {
"customer_name": "Trần Minh",
"order_code": "NP20261117",
"total": "650.000đ",
"delivery_date": "19/11/2026"
},
"tracking_id": "order-NP20261117"
}'
Một số điểm kỹ thuật cần lưu ý:
- Số điện thoại dùng định dạng quốc tế, bỏ số 0 đầu và thêm
84. tracking_iddo bạn tự đặt, nên gắn với mã đơn để đối chiếu về sau.- Đưa việc gửi tin vào hàng đợi, có cơ chế thử lại khi lỗi tạm thời, nhưng không gửi lặp khi đã thành công.

Bước 6: Gửi thử và theo dõi trạng thái
Trước khi bật cho toàn bộ khách hàng, hãy gửi thử tới số điện thoại nội bộ và kiểm tra cả nội dung lẫn mã phản hồi. Sau khi chạy thật, cần theo dõi tỷ lệ gửi thành công hằng ngày.
Checklist khi gửi thử:
- Tin hiển thị đúng tên OA, đúng nội dung, tham số không bị lỗi định dạng
- Phần mềm lưu được mã tin trả về và mã lỗi nếu có
- Gửi tới số không dùng Zalo trả về lỗi và phần mềm xử lý đúng (ví dụ chuyển sang SMS)
- Token được làm mới tự động khi hết hạn
- Không gửi trùng khi đơn được cập nhật nhiều lần
Bảng lỗi thường gặp và cách xử lý:
| Hiện tượng | Nguyên nhân thường gặp | Cách xử lý |
|---|---|---|
| Báo lỗi token | Access token hết hạn hoặc bị thu hồi | Làm mới token, kiểm tra quyền của ứng dụng |
| Báo lỗi mẫu tin | Mẫu chưa duyệt, sai mã mẫu, thiếu tham số | Kiểm tra trạng thái mẫu và dữ liệu truyền vào |
| Khách không nhận được | Số không dùng Zalo, sai định dạng, khách chặn tin | Chuẩn hoá số, dùng kênh dự phòng |
| Ngừng gửi đột ngột | Hết số dư tài khoản thanh toán | Nạp tiền, đặt cảnh báo số dư |
Tóm tắt và bước tiếp theo
Gửi tin ZNS qua Zalo OA gồm 6 bước: xác thực OA, tạo ứng dụng, thiết lập thanh toán, tạo mẫu tin, lấy token và kết nối phần mềm, gửi thử và theo dõi. Phần quan trọng nhất về kỹ thuật là quản lý token an toàn và xử lý lỗi; về vận hành là chọn đúng loại mẫu và theo dõi số dư. Khi đã chạy ổn, bạn có thể mở rộng sang tự động hoá quy trình chăm sóc khách hàng như nhắc tái mua hay khảo sát sau bán.
Nếu bạn cần kết nối ZNS với phần mềm bán hàng, đặt lịch hay CRM đang dùng, ULI – đơn vị làm phần mềm và tích hợp API có thể hỗ trợ từ khâu chuẩn bị đến vận hành. Hãy liên hệ ULI để trao đổi chi tiết.
Câu hỏi thường gặp
ZNS khác gì nhắn tin qua Zalo OA thông thường?
Tin nhắn OA thông thường gửi cho người đã quan tâm hoặc tương tác với OA. ZNS gửi theo số điện thoại kể cả khi khách chưa quan tâm OA, nhưng chỉ dùng mẫu đã duyệt và tính phí theo tin.
Gửi tin ZNS có mất phí không?
Có. ZNS tính phí theo tin, đơn giá phụ thuộc loại mẫu tin và chính sách hiện hành. Bạn nên xem bảng giá trên trang chính thức của Zalo trước khi triển khai.
Có thể dùng ZNS để gửi quảng cáo không?
ZNS chủ yếu dành cho thông báo giao dịch và chăm sóc khách hàng như xác nhận đơn, nhắc lịch hẹn, cập nhật giao hàng. Quy định về loại nội dung được phép có thể thay đổi, hãy đọc chính sách ZNS mới nhất.
Vì sao khách không nhận được tin ZNS?
Nguyên nhân thường gặp là số điện thoại không dùng Zalo, sai định dạng, khách đã chặn nhận tin từ OA, mẫu tin chưa được duyệt hoặc tài khoản thanh toán hết số dư. Kiểm tra mã lỗi trả về từ API để biết chính xác.
Mẫu tin ZNS bị từ chối thì làm sao?
Đọc lý do từ chối, thường liên quan nội dung mang tính quảng cáo, thiếu thông tin nhận diện doanh nghiệp hoặc tham số không hợp lệ. Sửa theo góp ý và gửi duyệt lại.
Biên soạn bởi đội phát triển phần mềm, thiết kế website và SEO của ULI – công ty phần mềm (uli.vn). Nội dung được rà soát và cập nhật định kỳ.





