Bạn muốn gửi thông báo tự động trên Zalo tới hàng nghìn khách hàng một cách cá nhân hóa, nhanh chóng và an toàn? ZNS API chính là công cụ giúp doanh nghiệp hiện thực hóa điều đó. Bài viết này sẽ giúp bạn hiểu rõ ZNS API là gì, các quyền trong hệ thống, cũng như quy trình khởi tạo Template ZNS qua API.

ZNS API là gì?

Đầu tiên, chúng ta cùng tìm hiểu khái niệm ZNS API. Đây là viết tắt của Zalo Notification Service API – một dịch vụ tích hợp cho phép doanh nghiệp kết nối hệ thống nội bộ với nền tảng Zalo Official Account (OA). Thông qua API, doanh nghiệp có thể tận dụng để:

• Tự động gửi thông báo như xác nhận đơn hàng, nhắc lịch, thông báo khuyến mãi.

• Quản lý dữ liệu tập trung về trạng thái gửi tin.

• Cá nhân hóa nội dung để nâng cao trải nghiệm người dùng và tăng tỷ lệ tương tác.

Tất cả tin nhắn được gửi từ OA – kênh chính thức của doanh nghiệp, giúp khách hàng tin tưởng và tránh nhầm lẫn với tin spam.

ZNS API là gì?

Các tài khoản bắt buộc khi triển khai ZNS qua API

Trước khi tích hợp ZNS API, doanh nghiệp cần chuẩn bị các tài khoản nền tảng. Việc này giúp hệ thống hoạt động trơn tru và đảm bảo tính hợp lệ khi gửi tin. Dưới đây là 3 loại tài khoản mà doanh nghiệp cần có:

Phân loại quyền trong ZNS API và các tính năng đi kèm

Hệ thống API ZNS được thiết kế theo mô hình phân quyền rõ ràng để doanh nghiệp dễ dàng quản lý và vận hành. Mỗi nhóm quyền tương ứng với một nhóm chức năng nhất định, đồng thời hệ thống còn cung cấp webhook để thông báo sự kiện tự động. Cụ thể như sau:

1. Quyền gửi tin nhắn ZNS

Đây là nhóm quyền trọng tâm, cho phép doanh nghiệp chủ động triển khai các chiến dịch nhắn tin trên Zalo với nhiều tùy chọn nâng cao:

• Gửi tin nhắn ZNS thông thường cho người dùng.

• Sử dụng hash phone nhằm bảo mật số điện thoại khách hàng.

• Gửi tin trong chế độ thử nghiệm (development mode) để kiểm tra trước khi gửi thật.

• Áp dụng mã hóa RSA tăng cường bảo mật nội dung tin nhắn.

• Thiết lập và vận hành các chuỗi gửi tự động (ZNS Journey).

• Tạo mới mẫu tin (Template ZNS) trực tiếp qua API.

• Chỉnh sửa ZNS Template API.

2. Quyền truy xuất và theo dõi dữ liệu

Nhóm quyền này cung cấp cho doanh nghiệp khả năng kiểm tra, phân tích và quản lý thông tin liên quan đến việc gửi ZNS, bao gồm:

• Lấy trạng thái gửi tin của từng thông báo ZNS.

• Xem hạn mức/quota còn lại để điều chỉnh kế hoạch gửi.

• Tra cứu loại nội dung ZNS được phép gửi theo chính sách Zalo.

• Lấy danh sách template ZNS hiện có trong hệ thống.

• Xem chi tiết thông tin từng template cụ thể.

• Truy xuất dữ liệu mẫu của template để tham khảo hoặc kiểm thử.

• Thu thập đánh giá từ khách hàng về các mẫu tin ZNS.

• Thống kê chất lượng gửi tin của tài khoản Official Account (OA).

3. Webhook thông báo sự kiện tự động

Ngoài hai nhóm quyền chính, ZNS API còn hỗ trợ webhook – công cụ gửi thông báo tức thời đến hệ thống của doanh nghiệp khi có sự kiện liên quan. Các tình huống điển hình gồm:

• Ghi nhận phản hồi của người dùng với mẫu tin đánh giá dịch vụ.

• Thông báo khi có thay đổi về hạn mức gửi ZNS.

• Báo cập nhật về loại nội dung ZNS được phép gửi.

• Cập nhật chất lượng gửi tin của các mẫu tin ZNS.

• Thông báo khi kết thúc hoặc hết hạn một Journey gửi tin.

• Gửi thông tin về việc bắt đầu tính phí cho Journey gửi tin.

• Ghi nhận sự kiện khi người dùng nhận được thông báo ZNS.

• Cập nhật khi có thay đổi về template ZNS trong hệ thống.

Quy trình khởi tạo Template ZNS qua API

Trước khi có thể triển khai gửi tin nhắn ZNS, doanh nghiệp cần chuẩn bị trước mẫu nội dung (Template ZNS). Việc này giúp hệ thống Zalo xét duyệt và đảm bảo tin nhắn của bạn tuân thủ đúng quy định. Chỉ khi mẫu tin được phê duyệt thành công, doanh nghiệp mới có thể sử dụng để gửi đến khách hàng. Có hai phương thức chính để tạo Template ZNS:

• Thông qua giao diện Zalo Cloud (ZCA): phù hợp với doanh nghiệp nhỏ hoặc chỉ có nhu cầu gửi tin hạn chế.

• Sử dụng API tạo Template: lựa chọn tối ưu cho doanh nghiệp lớn, agency hoặc hệ thống CRM muốn quản lý nhiều mẫu tin và tự động hóa quy trình.

Các bước tạo Template ZNS qua API

Để giúp bạn dễ hình dung, dưới đây là các bước cụ thể khi khởi tạo Template ZNS bằng API:

Bước 1: Gửi yêu cầu tạo Template

Doanh nghiệp gửi request tạo template đến hệ thống Zalo qua API, trong đó bao gồm nội dung và định dạng mẫu tin.

Bước 2: Zalo kiểm duyệt nội dung

Hệ thống tiếp nhận và xem xét nội dung dựa trên các quy định về định dạng, thông điệp, và trải nghiệm người dùng để đảm bảo chất lượng.

Bước 3: Nhận thông báo trạng thái qua webhook

Sau khi xét duyệt, Zalo sẽ gửi thông báo thay đổi trạng thái template về địa chỉ webhook mà doanh nghiệp đã cấu hình trước đó, giúp bạn theo dõi kết quả ngay lập tức.

Tạo Template ZNS

Trạng thái Template sau khi xét duyệt

Sau khi hoàn tất quy trình, trạng thái của template sẽ được cập nhật tự động như sau:

• Từ PENDING_REVIEW → ENABLE nếu được chấp thuận.

• Từ PENDING_REVIEW → REJECT nếu bị từ chối.

Lời khuyên: Trước khi gửi request, hãy kiểm tra kỹ nội dung và định dạng của template để tăng tỷ lệ phê duyệt.

Lưu ý quan trọng khi tích hợp ZNS qua API

Khi triển khai Zalo Notification Service API (ZNS API), doanh nghiệp cần chú ý một số điểm quan trọng để hệ thống vận hành ổn định, không gián đoạn và mang lại trải nghiệm tốt cho khách hàng:

• Xác thực chính xác số điện thoại khách hàng: Số điện thoại trong hệ thống phải trùng khớp với tài khoản Zalo tương ứng để đảm bảo tin nhắn được gửi đúng đối tượng, tránh nhầm lẫn và giảm thiểu lỗi.

• Kiểm tra và gia hạn token API định kỳ: Access token có thời hạn sử dụng giới hạn. Nếu không làm mới kịp thời, hệ thống sẽ ngừng gửi tin nhắn, gây gián đoạn dịch vụ.

• Tuân thủ quy định của Zalo về việc gửi tin nhắn: Chỉ sử dụng những nội dung đã được phê duyệt nhằm ngăn chặn vi phạm chính sách spam và duy trì uy tín thương hiệu.

• Đảm bảo chuẩn kỹ thuật và trải nghiệm người dùng: Kiểm tra kỹ giao diện, bố cục và nội dung tin nhắn để tin nhắn hiển thị đúng định dạng trên mọi thiết bị và nâng cao sự hài lòng của khách hàng.

Lưu ý quan trọng khi tích hợp ZNS bằng API

Giải đáp thắc mắc thường gặp khi gửi ZNS qua API

1. ZNS API có miễn phí không?

Zalo Notification Service API không miễn phí, doanh nghiệp sẽ phải trả phí cho mỗi tin nhắn gửi thành công.

2. Các ngôn ngữ lập trình nào có thể sử dụng với Zalo Notification Service API?

Zalo cung cấp API cho nhiều ngôn ngữ khác nhau như C#, Python, C++, Java, PHP, Android, iOS, Javascript, Node.js. Đồng thời có sẵn SDK (Software Development Kit) cho từng ngôn ngữ để hỗ trợ lập trình viên dễ dàng tích hợp.

3. ZNS API có giới hạn số lượng tin nhắn gửi ra không?

Có, Zalo Notification Service API có giới hạn về số lượng tin nhắn gửi ra, bao gồm hạn mức gửi theo ngày (Daily quota) cho từng loại tin (Giao dịch, Chăm sóc, Hậu mãi) và hạn mức mà người dùng cuối có thể nhận mỗi tháng (User monthly promotion quota) cho tin Hậu mãi. Hạn mức này tự động điều chỉnh dựa trên chất lượng gửi và hoạt động của OA, nhằm đảm bảo trải nghiệm người dùng và phân bổ nguồn lực hợp lý.

4. API ZNS có hỗ trợ thử nghiệm trước khi gửi thật không?

Có, Zalo Notification Service (ZNS) API hỗ trợ thử nghiệm trước khi gửi chính thức bằng cách sử dụng chế độ phát triển (development mode).

ZNS API là công cụ mạnh mẽ giúp doanh nghiệp tự động hóa gửi thông báo, tối ưu hóa chăm sóc khách hàng và hỗ trợ marketing hiệu quả. Khi tích hợp đúng cách, API này không chỉ tiết kiệm chi phí mà còn nâng cao trải nghiệm khách hàng và uy tín thương hiệu. Nếu bạn cần hỗ trợ triển khai hoặc tích hợp API chuyên nghiệp, Abenla với đội ngũ chuyên gia giàu kinh nghiệm luôn sẵn sàng đồng hành. Liên hệ ngay hotline 028 66808866 để được tư vấn miễn phí.

Xem thêm:

Thông tin liên hệ:

Công ty TNHH ABENLA

• Địa chỉ: Số 3, đường 7A, CX Bình Thới, Phường 8, Quận 11, HCM

• Hotline: 028 66808866

• Email: info@smsthuonghieu.com