Zalo OA OpenAPI: Mô hình tích hợp, ứng dụng và các nhóm quyền cần biết
Muốn kết nối Zalo OA với CRM hoặc phần mềm nội bộ, doanh nghiệp cần chuẩn bị tài khoản, ứng dụng và quyền truy cập. Bài viết giúp bạn phân biệt từng thành phần trước khi giao đội ngũ kỹ thuật thực hiện khởi tạo ứng dụng và cấp quyền Zalo OA.
Zalo OA OpenAPI giúp hệ thống doanh nghiệp làm việc với Zalo OA qua API. Doanh nghiệp có thể kết nối CRM, ERP hoặc chatbot để tổ chức vận hành và tập trung dữ liệu.
Hiểu nhanhZalo OA là kênh giao tiếp; Zalo App phục vụ kết nối kỹ thuật; ZBS Account quản lý chi tiêu. Ba thành phần có vai trò khác nhau.
2. Cần chuẩn bị những tài khoản nào?
Tài khoản
Vai trò
Việc cần chuẩn bị
Zalo OA
Kênh chính thức để doanh nghiệp giao tiếp với khách hàng trên Zalo.
Khởi tạo và xác thực tài khoản doanh nghiệp.
Zalo App
Ứng dụng đại diện cho việc kết nối và sử dụng API.
Tạo ứng dụng, hoàn thiện thông tin và thực hiện cấp quyền.
ZBS Account
Tài khoản quản lý chi tiêu dịch vụ Zalo.
Thiết lập tài khoản và liên kết các tài sản cần sử dụng.
Nếu chưa có kênh chính thức, hãy bắt đầu từ tạo và xác thực Zalo OA cho doanh nghiệp. Chuẩn bị thông tin pháp lý, tên thương hiệu, hình ảnh và người phụ trách quản trị trước khi tiến tới tích hợp.
Lưu ý về người quản trịCác tài khoản có thể do những người khác nhau quản trị. Trước khi thao tác liên kết hoặc ủy quyền, cần kiểm tra người thực hiện có đủ quyền trên các tài khoản liên quan.
3. Khởi tạo và cấp quyền ứng dụng theo trình tự nào?
Bước 1: Khởi tạo và hoàn thiện Zalo App
Tại công cụ Zalo for Developers, tạo ứng dụng và khai báo thông tin theo yêu cầu. Tiếp tục hoàn thiện thông tin liên hệ, biểu tượng và cấu hình cần thiết; thực hiện kích hoạt, xác thực hoặc xét duyệt quyền theo hướng dẫn áp dụng cho ứng dụng.
Thiết lập ZBS Account và liên kết Zalo OA, Zalo App tương ứng với nhu cầu sử dụng dịch vụ. Trong phần quản lý tài sản của ZBS Account, chọn đúng loại tài sản cần liên kết và kiểm tra kết quả sau khi xác nhận.
Phân biệt hai việcLiên kết tài sản với ZBS Account phục vụ quản lý dịch vụ và chi tiêu. Cấp quyền cho ứng dụng phục vụ truy cập API của Zalo OA. Hoàn tất việc này chưa đồng nghĩa đã hoàn tất việc kia.
Bước 3: Cấp quyền cho ứng dụng quản lý Zalo OA
Thực hiện ủy quyền Zalo OA cho ứng dụng AppID. Doanh nghiệp có thể triển khai luồng OAuth v4 hoặc thao tác bằng API Explorer theo hướng dẫn tương ứng. Chọn đúng ứng dụng, đúng Zalo OA và lấy mã truy cập sau khi hoàn tất cấp quyền.
Gợi ý phối hợp triển khaiNên lập danh sách gồm tên Zalo OA, AppID, ZBS Account và người quản trị phụ trách. Cả bộ phận vận hành lẫn kỹ thuật cùng đối chiếu danh sách này trước khi thử kết nối.
4. API và webhook phối hợp vận hành như thế nào?
Luồng quản lý và đồng bộ dữ liệu
Sơ đồ dưới đây thể hiện hai chiều trao đổi. Hệ thống doanh nghiệp gọi API để lấy dữ liệu; khi có cập nhật, Zalo gửi sự kiện đến webhook đã cấu hình. Phía doanh nghiệp tiếp nhận và đồng bộ dữ liệu với hệ thống nội bộ.
Hình 1. Máy chủ doanh nghiệp nhận sự kiện qua webhook và chủ động truy vấn dữ liệu bằng API. Ảnh gốc: Zalo Official Account.
Chiều chủ động: máy chủ gửi yêu cầu API và xử lý dữ liệu phản hồi.
Chiều nhận sự kiện: webhook tiếp nhận thay đổi để hệ thống cập nhật thông tin.
Luồng tương tác với người dùng
Trong sơ đồ tương tác, người dùng bắt đầu bằng một hành động với Zalo OA hoặc sản phẩm liên kết. Sự kiện được chuyển đến máy chủ doanh nghiệp kèm UserID; hệ thống lưu thông tin và gọi API theo nghiệp vụ cần thực hiện.
Hình 2. Từ tương tác của người dùng, hệ thống nhận UserID và thực hiện nghiệp vụ qua Zalo OA; mỗi nghiệp vụ cần đáp ứng điều kiện tương ứng. Ảnh gốc: Zalo Official Account.
Có UserID chưa phải là đủSơ đồ có bước kiểm tra điều kiện trước khi gửi tin hoặc gọi thoại. Khi triển khai, đội ngũ kỹ thuật cần kiểm tra quyền, điều kiện sử dụng và kết quả trả về của từng API.
5. Chọn nhóm quyền và kiểm tra trước khi vận hành
Các nhóm chức năng gồm nhắn tin, gọi thoại, nội dung, nhóm và quản lý; webhook cung cấp thông tin sự kiện. Hãy bắt đầu từ nghiệp vụ cần dùng để xác định API và sự kiện phải xử lý.
Nên kiểm tra một luồng hoàn chỉnh: phát sinh tương tác, nhận sự kiện, xử lý dữ liệu và thực hiện phản hồi.
Xác định đúng Zalo OA, AppID và ZBS Account của dự án.
Kiểm tra trạng thái ứng dụng và quyền đã được cấp.
Thử nhận sự kiện tại webhook và đối chiếu dữ liệu.
Ghi nhận kết quả gọi API để bộ phận kỹ thuật kiểm tra.
Thống nhất người theo dõi kết nối sau khi bàn giao.
Lưu ý về chi phíZalo không thu phí tích hợp Zalo OA; gói dịch vụ và các tính năng sử dụng có thể phát sinh phí. Cần dự trù riêng phần triển khai phần mềm và chi phí vận hành dịch vụ.
ABENLA — Zalo Business SolutionsChuẩn bị kết nối Zalo OA với hệ thống doanh nghiệp?Tìm hiểu lộ trình thiết lập tài khoản và dịch vụ để làm rõ nhu cầu trước khi triển khai.Tìm hiểu đăng ký dịch vụ Zalo ZBS →
