Hướng dẫn này trình bày cách kết nối Zalo Official Account (Zalo OA) với HexaSync để tạo Zalo OA Connector App trên HexaSync Automation Engine. Sau khi hoàn tất, bạn có thể kiểm tra dữ liệu người dùng và tin nhắn được lấy từ Zalo OA ngay trên HexaSync.
Thiết lập này cũng là bước chuẩn bị để sử dụng các giải pháp như tích hợp Zalo OA với Freshchat hoặc tích hợp Zalo OA với Zendesk.
Chuẩn bị trước khi bắt đầu
- Tài khoản Beehexa để truy cập HexaSync Automation Engine. Nếu chưa có tài khoản, hãy làm theo hướng dẫn đăng ký tài khoản Beehexa.
- Tài khoản Zalo có quyền quản trị Zalo OA cần kết nối. Nếu chưa có OA, hãy làm theo hướng dẫn khởi tạo Zalo Official Account.
- Zalo OA đã xác thực và đang sử dụng gói Tăng trưởng hoặc Toàn diện. Theo bảng quyền lợi gói dịch vụ Zalo OA, việc liên kết ứng dụng với OA qua API yêu cầu một trong hai gói này.
Lưu ý: Quyền truy cập và nhóm sự kiện phụ thuộc vào quyền mà Zalo hiển thị tại thời điểm cấp quyền. Hãy kiểm tra danh sách quyền trước khi xác nhận.
Phần 1: Cấp quyền kết nối Zalo OA trên HexaSync
Bước 1: Đăng nhập HexaSync
Truy cập HexaSync Automation Engine và đăng nhập bằng tài khoản Beehexa.
Bước 2: Bắt đầu kết nối Zalo OA
- Mở trang xác thực Zalo OA trên HexaSync.
- Chọn Zalo OA Connector App cần thiết lập.
- Trên màn hình Check connection details, kiểm tra trạng thái của Zalo OA.
- Khi trạng thái hiển thị Not connected, chọn Connect.
Bước 3: Chọn ngôn ngữ hướng dẫn
- Tại màn hình Choose your language, chọn Tiếng Việt hoặc English.
- Chọn Submit để tiếp tục.
- Các màn hình tiếp theo sẽ sử dụng ngôn ngữ bạn đã chọn.
Bước 4: Xác nhận ứng dụng dùng để kết nối
- Trên màn hình Choose an app to connect to Zalo OA, kiểm tra ứng dụng đang được chọn.
- Mặc định, HexaSync hiển thị [Zalo OA] HexaSync Connector do Beehexa cung cấp.
- Chọn Continue để sử dụng ứng dụng này.
- Nếu cần dùng ứng dụng khác, chọn Use a different app trước khi tiếp tục.
Trong hướng dẫn này, [Zalo OA] HexaSync Connector là ứng dụng được Zalo cấp quyền; Zalo OA Connector App là nơi bạn quản lý kết nối, task và dữ liệu trên HexaSync.
Bước 5: Cấp quyền truy cập Zalo OA
- Sau khi tiếp tục, bạn sẽ được chuyển sang màn hình cấp quyền của Zalo.
- Kiểm tra Zalo OA đang được chọn.
- Kiểm tra danh sách quyền sử dụng API và quyền nhận sự kiện mà ứng dụng yêu cầu.
- Đọc và đồng ý với các điều khoản được hiển thị trên màn hình Zalo.
- Chọn Cấp quyền để cho phép ứng dụng truy cập Zalo OA.
Zalo mô tả cơ chế này là việc cấp quyền cho một Zalo App để gọi API và nhận sự kiện. Xem thêm tài liệu khởi tạo ứng dụng và cấp quyền Zalo OA.
Bước 6: Kiểm tra trạng thái kết nối
- Sau khi cấp quyền thành công, bạn sẽ được đưa trở lại HexaSync.
- Kiểm tra trạng thái Zalo OA đã chuyển sang Connected.
- Kiểm tra credential vừa được tạo cho kết nối.
- Nếu cần cấp quyền lại, chọn Re-authorize.
- Chọn Create Zalo OA Connector để tiếp tục.
Bước 7: Đặt tên Zalo OA Connector App
- Ở bước tạo Zalo OA Connector App, giao diện hiển thị màn hình Enter Profile Name.
- Trong trường Name, nhập tên giúp bạn dễ nhận biết Zalo OA Connector App.
- Kiểm tra nội dung trong trường Description.
- Chọn Continue để hoàn tất quá trình tạo.
Tên nên giúp phân biệt rõ từng Connector App nếu bạn quản lý nhiều kết nối Zalo OA.
Bước 8: Hoàn tất Zalo OA Connector App
Mở Zalo OA Connector App vừa tạo và kiểm tra mục Tasks. Cấu hình trong hướng dẫn này có hai task:
- Messages dành cho dữ liệu tin nhắn Zalo OA.
- Users dành cho dữ liệu người dùng Zalo OA.
Phần 2: Kiểm tra dữ liệu Zalo OA trên HexaSync
Bước 1: Kiểm tra Metrics
- Mở mục Metrics trong Zalo OA Connector App.
- Trong nhóm Messages, kiểm tra Total Messages cùng số lượng Outbound và Inbound.
- Trong nhóm Users, kiểm tra Total Users.
Các số liệu này giúp bạn xác nhận dữ liệu Zalo OA đã được ghi nhận trên HexaSync.
Bước 2: Kiểm tra dữ liệu Messages
- Mở Tasks.
- Chọn task Messages.
- Mở mục Data.
- Kiểm tra các trường dữ liệu tin nhắn được hiển thị, ví dụ:
message_id
user_id
direction
type
message
time
sourceBước 3: Kiểm tra dữ liệu Users
- Quay lại Tasks.
- Chọn task Users.
- Mở mục Data.
- Kiểm tra các bản ghi người dùng Zalo OA, gồm
user_id, trạng thái dữ liệu và thời điểm Last Seen.
Phần 3: Câu hỏi thường gặp
Làm thế nào để kết nối Zalo OA trên HexaSync?
Quy trình gồm tám bước:
- Đăng nhập HexaSync.
- Mở trang xác thực Zalo OA và chọn Connect.
- Chọn ngôn ngữ hướng dẫn.
- Xác nhận ứng dụng [Zalo OA] HexaSync Connector.
- Cấp quyền truy cập Zalo OA trên màn hình Zalo.
- Kiểm tra trạng thái Connected và chọn Create Zalo OA Connector.
- Đặt tên Zalo OA Connector App.
- Mở Connector App và kiểm tra task, Metrics cùng dữ liệu.
HexaSync lấy những loại dữ liệu nào từ Zalo OA?
Trong cấu hình được mô tả ở hướng dẫn này, Zalo OA Connector App có hai task chính là Messages và Users. Bạn có thể kiểm tra bản ghi tin nhắn và user_id của người dùng trong từng task tương ứng.
HexaSync có gửi hoặc ghi dữ liệu trở lại Zalo OA không?
Không trong cấu hình được mô tả ở hướng dẫn này. Cấu hình mặc định là chỉ đọc để lấy dữ liệu phục vụ theo dõi và các quy trình phía HexaSync. Hãy luôn kiểm tra danh sách quyền trên màn hình Zalo trước khi cấp quyền.
Kết nối Zalo OA trên HexaSync để làm gì?
Sau khi hoàn tất, bạn có thể kiểm tra dữ liệu người dùng và tin nhắn được lấy từ Zalo OA trên HexaSync. Kết nối này cũng là bước chuẩn bị cho các giải pháp như Zalo OA với Freshchat và Zalo OA với Zendesk.
Zalo OA cần đáp ứng điều kiện gì để kết nối?
Zalo OA cần được xác thực và sử dụng gói Tăng trưởng hoặc Toàn diện để liên kết ứng dụng bên thứ ba qua OpenAPI. Chính sách và quyền lợi gói có thể thay đổi; hãy kiểm tra bảng giá dịch vụ Zalo OA hiện hành trước khi thiết lập.