Kênh Zalo Official Account (OA)

Hướng dẫn kết nối tài khoản Zalo OA doanh nghiệp, cấu hình Zalo for Developers và đồng bộ hội thoại khách hàng trên OVIRO.

Tích hợp Zalo Official Account (Zalo OA) giúp doanh nghiệp kết nối trang Zalo OA đã xác thực vào OVIRO để chăm sóc khách hàng, phản hồi tin nhắn tự động và hỗ trợ gửi thông báo đơn hàng (ZNS).

Cơ chế kết nối

Zalo OA sử dụng Zalo OAuth 2.0:

Chủ sở hữu hoặc Quản trị viên của trang Zalo OA thực hiện đăng nhập và ủy quyền qua tài khoản Zalo cá nhân.
Zalo trả về mã ủy quyền để hệ thống OVIRO sinh cặp khóa Access Token (thời hạn 25 giờ) và Refresh Token (thời hạn 3 tháng).
Hệ thống OVIRO tự động lên lịch làm mới Access Token bằng Refresh Token để đảm bảo kết nối không bị gián đoạn.

Quy trình kết nối Zalo OA

Bước 1: Khai báo Zalo Developer App

Trước khi tiến hành liên kết OA, vào Cấu hình bán hàng đa kênh (#/setting/omnichannel/tab/general) và điền thông số tại khối Tích hợp Zalo Official Account (OA):

Zalo Developer App ID: ID của ứng dụng tạo trên cổng Zalo for Developers.
Zalo Developer Secret Key: Khóa bí mật của App Zalo.
Callback URL (Redirect URI): Đường dẫn nhận mã callback từ Zalo (ví dụ: https://app.yourdomain.com/v1/ecomchannels/oauth/callback). Đường dẫn này phải được cấu hình trong mục Đăng nhập > Thiết lập liên kết trên cổng Zalo Developers.
OA Webhook Secret Key mặc định: (Tùy chọn) Khóa bí mật dùng cho webhook sự kiện của OA.
Bấm Lưu cài đặt.

Bước 2: Thêm kênh và Ủy quyền Official Account

Vào Bán hàng đa kênh > Tích hợp đa kênh.
Nhấn nút Thêm kênh.
Chọn biểu tượng Zalo Official Account.
Cửa sổ ủy quyền của Zalo xuất hiện:
- Đăng nhập tài khoản Zalo có quyền Quản trị viên đối với Zalo OA.
- Chọn đúng tài khoản Zalo OA cần kết nối.
- Đánh dấu đồng ý các quyền được yêu cầu (Quản lý tin nhắn, xem thông tin người dùng, gửi thông báo).
- Bấm Cho phép.
Cửa sổ tự động đóng lại, Zalo OA xuất hiện trong danh sách kênh của OVIRO với trạng thái Có hiệu lực.

Bước 3: Thiết lập tính năng kênh Zalo OA

Nhấn Sửa tại dòng kênh Zalo OA để cấu hình:

Bật tính năng Chat: Kích hoạt giao diện nhận và trả lời tin nhắn từ khách hàng gửi đến Zalo OA.
Xử lý khi nhận webhook: Bật tính năng để nhận ngay thông báo khi có tin nhắn mới hoặc khách hàng tương tác với OA.
Cấu hình đơn hàng: Gán kho và cửa hàng để cho phép tạo nhanh đơn hàng khi chat với khách trên Zalo.

Quản lý Token và Kết nối lại

Thời hạn Refresh Token: Zalo quy định Refresh Token có hiệu lực tối đa 3 tháng. Sau khoảng thời gian này hoặc khi người quản trị OA thay đổi quyền trên Zalo, phiên kết nối có thể cần được xác thực lại.
Nút Kết nối lại: Quản trị viên chỉ cần vào Tích hợp đa kênh, tìm dòng kênh Zalo OA và nhấn Kết nối lại để đăng nhập cấp lại quyền nhanh chóng mà không làm gián đoạn lịch sử tin nhắn đã lưu.

Lưu ý quan trọng

[!IMPORTANT]

Tài khoản Zalo thực hiện ủy quyền phải có vai trò Quản trị viên (Admin) của OA. Nếu là vai trò Soạn thảo hoặc Phân tích sẽ không đủ quyền cấp phép tích hợp API.

Zalo OA phải ở trạng thái Đã xác thực (có tích vàng hoặc gói tài khoản doanh nghiệp hoạt động) để được phép gửi/nhận tin nhắn qua API theo chính sách hiện hành của Zalo.