Zalo API Cho Doanh Nghiệp: Hướng Dẫn Zalo OA API, Webhook, ZNS

Zalo API là bộ giao diện lập trình do Zalo cung cấp cho nhà phát triển và doanh nghiệp, trong đó Zalo OA API cho phép phần mềm của bạn nhận tin nhắn khách gửi vào Official Account qua webhook, gửi tin trả lời, quản lý người quan tâm và gửi thông báo ZNS. Để dùng, doanh nghiệp cần một Zalo OA, một ứng dụng trên Zalo for Developers và access token được cấp qua OAuth.

Zalo có hơn 70 triệu người dùng ở Việt Nam, và với nhiều ngành như bán lẻ, giáo dục, bất động sản, đây là kênh khách nhắn nhiều nhất. Vấn đề là đội CSKH không thể ngồi trước Zalo OA 24/7, còn dữ liệu đơn hàng thì nằm ở phần mềm khác. Zalo API là cầu nối: khi nối được, tin nhắn có thể tự vào CRM, đơn hàng có thể tự báo khách, và AI Agent có thể trả lời ngay cả lúc 11 giờ đêm.

Tóm tắt nhanh:

• Doanh nghiệp tích hợp qua Zalo OA API (Official Account), không phải qua Zalo cá nhân
• Cần 3 thứ: Zalo OA đã xác thực, ứng dụng trên developers.zalo.me, access token cấp qua OAuth
• Webhook để nhận tin khách gửi; API gửi tin để trả lời; ZNS cho thông báo giao dịch theo mẫu đã duyệt, tính phí theo tin
• Mỗi loại tin có quy định riêng về thời điểm và nội dung; gửi sai dễ bị hạn chế OA
• Phần khó nhất trong vận hành: làm mới access token và tuân thủ chính sách tin nhắn

Zalo API Gồm Những Gì?

“Zalo API” là tên gọi chung cho nhiều nhóm API trên nền tảng Zalo for Developers. Với doanh nghiệp, ba nhóm quan trọng nhất:

Nhóm	Dùng để làm gì	Ai nên dùng
Zalo OA API	Nhận và gửi tin nhắn với khách qua Official Account, quản lý người quan tâm, gắn nhãn, đăng bài	Mọi doanh nghiệp có Zalo OA
ZNS (Zalo Notification Service)	Gửi thông báo theo mẫu đã duyệt tới số điện thoại khách: xác nhận đơn, nhắc lịch, OTP	Doanh nghiệp có giao dịch với khách
Social API / Đăng nhập Zalo	Cho người dùng đăng nhập website/app bằng Zalo, lấy thông tin cơ bản khi được đồng ý	Website, app cần đăng nhập nhanh

Còn Zalo cá nhân thì không có API chính thức cho việc tự động hóa nhắn tin. Các công cụ “auto Zalo cá nhân” thường giả lập thao tác người dùng, vi phạm điều khoản và là nguyên nhân phổ biến khiến tài khoản Zalo bị khóa. Nếu đội sale của bạn chủ yếu chăm khách qua Zalo cá nhân, xem bài quản lý nhiều tài khoản Zalo để biết cách làm an toàn.

Chuẩn Bị Trước Khi Dùng Zalo OA API

1. Zalo Official Account (OA). Nên là OA đã xác thực doanh nghiệp, vì nhiều tính năng và hạn mức tin nhắn phụ thuộc vào trạng thái xác thực và gói dịch vụ OA.
2. Tài khoản nhà phát triển trên developers.zalo.me, đăng nhập bằng tài khoản Zalo của người quản trị.
3. Một ứng dụng (app) trên Zalo for Developers, có App ID và App Secret.
4. Liên kết app với OA và xin các quyền cần thiết (đọc/gửi tin nhắn, quản lý người quan tâm…).
5. Một máy chủ có HTTPS để nhận webhook và lưu token. Có thể là backend của bạn, n8n, hoặc nền tảng tích hợp sẵn.

💡 Mẹo: Dùng một tài khoản Zalo “của công ty” để làm quản trị app và OA, không dùng tài khoản cá nhân của một nhân viên. Người đó nghỉ việc là bạn mất quyền quản trị.

Hướng Dẫn Từng Bước Kết Nối Zalo OA API

Bước 1: Tạo ứng dụng và liên kết OA

Trong trang quản lý ứng dụng trên Zalo for Developers, tạo app mới, điền thông tin, rồi vào mục liên kết Official Account để chọn OA của doanh nghiệp. Người quản trị OA cần xác nhận cấp quyền cho app.

Bước 2: Lấy access token qua OAuth

Zalo OA API dùng OAuth: quản trị viên OA đồng ý cấp quyền cho app, Zalo trả về authorization code, máy chủ của bạn đổi code đó lấy access token và refresh token.

• Access token dùng để gọi API, có thời hạn ngắn (tính bằng giờ).
• Refresh token dùng để xin access token mới khi cái cũ hết hạn, có thời hạn dài hơn. Mỗi lần làm mới, Zalo thường trả về một refresh token mới, nên phải lưu lại cái mới thay vì dùng mãi cái cũ.

Đây là chỗ hầu hết tích hợp tự làm bị gãy: quên làm mới token, hoặc lưu sai refresh token, và một sáng thứ Hai mọi tin nhắn tự động ngừng gửi. Hãy dựng một tác vụ định kỳ làm mới token và cảnh báo khi thất bại. Thời hạn cụ thể của từng loại token có thể thay đổi theo phiên bản API, nên kiểm tra tài liệu chính thức tại developers.zalo.me.

Bước 3: Đăng ký webhook để nhận tin nhắn

Trong cấu hình app, khai báo webhook URL (bắt buộc HTTPS) và chọn các sự kiện muốn nhận: người dùng gửi văn bản, gửi ảnh, gửi file, quan tâm, bỏ quan tâm OA. Mỗi khi khách nhắn vào OA, Zalo gửi một yêu cầu kèm dữ liệu sự kiện tới URL của bạn. Nếu chưa quen khái niệm này, đọc bài webhook là gì.

Hãy xác thực nguồn gửi theo cơ chế chữ ký Zalo mô tả trong tài liệu, phản hồi nhanh, và lưu mã sự kiện để tránh xử lý trùng.

Bước 4: Gửi tin trả lời qua API

Máy chủ của bạn gọi API gửi tin của OA, truyền ID người nhận (định danh người dùng trong phạm vi OA của bạn) và nội dung. Tùy loại tin, bạn có thể gửi văn bản, ảnh, danh sách, nút bấm.

Các Loại Tin Nhắn Zalo OA Và Quy Định Cần Biết

Zalo phân loại tin nhắn từ OA và áp quy định khác nhau cho từng loại. Tên gọi và điều kiện chi tiết có thể được Zalo cập nhật, nhưng nguyên tắc chung như sau:

Loại tin	Mục đích	Điều kiện chung	Chi phí
Tin tư vấn	Trả lời, hỗ trợ khách	Gửi trong khung thời gian cho phép sau khi khách tương tác với OA	Theo chính sách gói OA
Tin giao dịch	Xác nhận đơn, cập nhật giao hàng, thanh toán	Nội dung gắn với giao dịch thật của khách	Theo chính sách Zalo
Tin truyền thông	Khuyến mãi, chương trình, sản phẩm mới	Gửi cho người quan tâm OA, có giới hạn và quy định nội dung	Thường tính phí
ZNS	Thông báo tới số điện thoại khách, kể cả chưa quan tâm OA	Mẫu tin phải được duyệt trước, nội dung không quảng cáo	Tính phí theo tin gửi thành công (vài trăm đồng/tin theo bảng giá công bố)
Broadcast	Thông báo hàng loạt tới người quan tâm	Hạn mức theo tháng, nội dung được kiểm duyệt	Miễn phí trong hạn mức

Ba lưu ý thực tế:

• Không dùng ZNS để quảng cáo. Mẫu có nội dung khuyến mãi thường bị từ chối, và gửi sai mục đích có thể bị khóa tính năng.
• Tin tư vấn có thời hạn. Nếu khách nhắn từ lâu, bạn không thể tùy ý nhắn lại bằng tin tư vấn. Đây là lý do nên trả lời nhanh, và là chỗ AI Agent giúp nhiều nhất.
• Muốn gửi hàng loạt đúng luật, xem bài Zalo Business là gì để hiểu các gói OA và Zalo Business, thay vì dùng công cụ spam qua Zalo cá nhân.

💡 Mẹo: Với xác nhận đơn và cập nhật giao hàng, ZNS ổn định hơn tin OA vì gửi được tới số điện thoại, kể cả khi khách chưa quan tâm OA.

Tự Code, Dùng n8n Hay Dùng Nền Tảng Có Sẵn?

Có ba cách để đưa Zalo OA API vào hoạt động.

Tự lập trình. Linh hoạt nhất. Đội kỹ thuật viết backend nhận webhook, quản lý token, gọi API gửi tin, nối với CRM. Phù hợp khi bạn có lập trình viên và quy trình đặc thù. Chi phí ẩn là bảo trì: Zalo nâng cấp phiên bản API, đổi chính sách, và ai đó phải cập nhật theo.

Dùng n8n hoặc công cụ tự động hóa. n8n không có node Zalo chính thức, nhưng node Webhook và HTTP Request đủ để nhận tin và gửi tin. Bạn vẫn phải tự dựng luồng làm mới token. Phù hợp cho thông báo đơn hàng, chuyển tin nhắn vào Google Sheets hoặc CRM. Xem ví dụ trong 5 mẫu n8n workflow.

Dùng nền tảng có kết nối Zalo sẵn. Các nền tảng CSKH đa kênh và AI Agent như Aura đã xử lý OAuth, token, webhook, phân loại tin và lưu lịch sử hội thoại. Bạn chỉ cần liên kết OA và cấu hình agent.

Tiêu chí	Tự lập trình	n8n	Nền tảng AI Agent có sẵn
Thời gian đưa vào dùng	2–6 tuần	1–5 ngày	1–2 ngày
Làm mới token, xử lý lỗi	Tự làm	Tự dựng luồng	Có sẵn
Trả lời khách bằng AI và dữ liệu thật	Tự xây toàn bộ	Tự dựng agent	Có sẵn, cấu hình
Gộp Zalo với Facebook, website	Tự nối từng kênh	Tự nối từng kênh	Hộp thư hợp nhất
Phù hợp	Có đội kỹ thuật, nhu cầu đặc thù	Thông báo, đồng bộ dữ liệu	Đội CSKH/kinh doanh vận hành

Zalo API Và AI Agent: Ví Dụ Một Luồng Hoàn Chỉnh

Một chuỗi nhà thuốc 12 điểm bán nhận khoảng 300 tin nhắn Zalo OA mỗi ngày: hỏi còn thuốc không, hỏi giá, hỏi đơn giao tới đâu. Sau khi nối Zalo OA API với AI Agent:

1. Khách nhắn “Nhà thuốc còn men vi sinh X loại 20 gói không, giao về Gò Vấp được không?”
2. Webhook báo tin mới về nền tảng.
3. Agent hiểu khách hỏi hai ý: tồn kho và khu vực giao.
4. Agent tra tồn kho tại các điểm gần Gò Vấp qua API phần mềm bán hàng, kiểm tra chính sách giao hàng.
5. Agent trả lời qua Zalo OA API: còn hàng ở điểm Quang Trung, giá, phí giao, và hỏi khách có muốn đặt không.
6. Câu hỏi về liều dùng cho trẻ em được agent chuyển cho dược sĩ theo quy tắc Human-in-the-loop, không tự trả lời.

Chỉ số	Trực tay	Zalo OA API + AI Agent
Thời gian phản hồi giờ cao điểm	15 phút – 2 giờ	Dưới 30 giây cho câu hỏi tra cứu
Tin nhắn ngoài giờ	Trả lời sáng hôm sau	Trả lời ngay, chuyển người khi cần
Câu hỏi chuyên môn	Dược sĩ trả lời	Vẫn do dược sĩ, agent chỉ chuyển đúng người
Lịch sử khách hàng	Nằm rải rác trên điện thoại	Lưu tập trung, gắn với hồ sơ khách

Số liệu minh họa theo kinh nghiệm triển khai phổ biến; kết quả thực tế phụ thuộc dữ liệu và quy trình.

Nếu bạn muốn xem luồng này chạy trên Zalo OA của chính doanh nghiệp mình, đặt lịch demo miễn phí với Aura.

Câu Hỏi Thường Gặp Về Zalo API

Zalo API có miễn phí không?

Việc tạo ứng dụng và gọi Zalo OA API không tốn phí riêng, nhưng nhiều tính năng và hạn mức phụ thuộc gói dịch vụ OA. ZNS và một số loại tin nhắn tính phí theo tin gửi thành công.

Zalo cá nhân có API không?

Không có API chính thức để tự động hóa nhắn tin trên Zalo cá nhân. Công cụ giả lập thao tác trên Zalo cá nhân vi phạm điều khoản sử dụng và có nguy cơ khóa tài khoản.

Zalo OA developer là gì?

Đây là cách gọi trang Zalo for Developers (developers.zalo.me), nơi doanh nghiệp tạo ứng dụng, liên kết với Zalo OA, cấu hình webhook, xin quyền và lấy thông tin xác thực để gọi API.

Access token Zalo OA hết hạn thì làm sao?

Dùng refresh token để xin access token mới qua API OAuth của Zalo, và lưu lại refresh token mới được trả về. Nên chạy tác vụ làm mới định kỳ trước khi token hết hạn và cảnh báo khi thất bại.

ZNS khác tin nhắn Zalo OA thế nào?

ZNS gửi tới số điện thoại của khách theo mẫu đã được Zalo duyệt, kể cả khi khách chưa quan tâm OA, và tính phí theo tin. Tin nhắn OA gửi cho người dùng đã tương tác với OA, theo quy định từng loại tin.

Có tạo chatbot Zalo bằng API được không?

Được. Nhận tin qua webhook, xử lý bằng kịch bản hoặc AI, rồi trả lời qua API gửi tin của OA. Bài chatbot Zalo so sánh chatbot kịch bản và AI Agent trên Zalo.

Kết nối Zalo OA với CRM hoặc phần mềm bán hàng thế nào?

Nhận tin nhắn và sự kiện qua webhook, rồi gọi API của CRM hoặc phần mềm bán hàng để tạo khách hàng, ghi chú hội thoại hoặc tra đơn. Có thể tự code, dùng n8n hoặc dùng nền tảng đã kết nối sẵn cả hai đầu.

Zalo OA API mở ra khả năng biến kênh chat đông khách nhất Việt Nam thành một phần của hệ thống bán hàng, thay vì một hộp thư phải trực tay. Phần kỹ thuật không quá khó; phần cần cẩn thận là token, chính sách tin nhắn và quy tắc chuyển người. Đọc thêm về Zalo CRM và các bài khác trên blog Aura, hoặc tìm hiểu về nền tảng Aura.

Trải nghiệm Chat Hub ngay hôm nay

Bắt đầu quản lý tin nhắn đa kênh thông minh, tăng hiệu suất chăm sóc khách hàng với nền tảng AI-powered.

Dùng thử miễn phí Xem thêm bài viết