Hướng dẫn tích hợp Zalo OA
Hướng dẫn kết nối Zalo Official Account với tổng đài ODS, điều kiện gói Zalo và quản lý tin nhắn khách hàng.
Tính năng Tích hợp Zalo Official Account (Zalo OA) giúp doanh nghiệp tiếp nhận, phản hồi tin nhắn và gọi thoại chăm sóc khách hàng trực tiếp trên hệ thống AI Contact Center ODS thông qua giao diện làm việc tập trung.
1. Cơ chế hoạt động & Điều kiện tiên quyết
Mục đích vận hành
- Hợp nhất kênh tương tác Zalo: Nhận tin nhắn chat hai chiều và cuộc gọi thoại từ khách hàng qua tài khoản Zalo OA chính thức của doanh nghiệp ngay trên Portal ODS.
- Tiết kiệm chi phí viễn thông: Tiếp nhận cuộc gọi thoại chất lượng cao từ người dùng Zalo hoàn toàn miễn phí cước viễn thông thông thường.
- Tự động hóa dữ liệu CRM: Đồng bộ lịch sử hội thoại, tin nhắn và thông tin người gửi vào hồ sơ khách hàng tập trung.
Điều kiện tiên quyết
- Đăng nhập bằng tài khoản có quyền Quản trị viên (Administrator) trong hệ thống ODS.
- Doanh nghiệp sở hữu tài khoản Zalo Official Account đã xác thực và tài khoản đăng nhập có quyền Quản trị viên (Admin) của trang OA đó.
- Đường dẫn cấu hình trên Portal: Thiết lập nâng cao → Thiết lập Zalo Token (URL:
https://app.ods.vn/advance-setting/zalo-token).
2. Điều kiện gói Zalo OA theo nhu cầu tích hợp
Tùy theo nhu cầu vận hành thực tế của doanh nghiệp, tài khoản Zalo OA cần đáp ứng điều kiện gói dịch vụ tương ứng:
| Nhu cầu tích hợp | Điều kiện xác thực | Gói dịch vụ Zalo OA tối thiểu | Phạm vi tính năng trên ODS |
|---|---|---|---|
| Chỉ sử dụng gọi thoại | OA đã xác thực | Gói Tiêu chuẩn trở lên | Nhận cuộc gọi đến và gọi ra cho khách hàng qua định danh Zalo OA trên tổng đài |
| Gọi thoại và đồng bộ tin nhắn qua API | OA đã xác thực | Gói Tăng trưởng trở lên | Tiếp nhận, phản hồi tin nhắn chat hai chiều và đồng bộ lịch sử hội thoại về ODS |
Chi tiết về quyền lợi và biểu phí mới nhất của các gói Zalo OA được công bố chính thức tại Bảng giá Zalo OA.
3. Bảng tham số và giao diện Quản lý Zalo Token
Màn hình Quản lý Zalo Token hiển thị danh sách các tài khoản Zalo OA đã liên kết, trạng thái kích hoạt dữ liệu CRM và công cụ quản trị:
| Vùng giao diện / Cột | Loại thành phần | Diễn giải & Chức năng |
|---|---|---|
| + THÊM MỚI ZALO | Nút hành động | Mở luồng ủy quyền đăng nhập tài khoản Zalo OA để cấp phép kết nối (nút màu xanh lá). |
| Nhập từ khóa tại đây... | Ô tìm kiếm | Tìm kiếm nhanh token theo tên gợi nhớ trong danh sách. |
| STT | Cột thông tin | Số thứ tự bản ghi liên kết token trong hệ thống. |
| TÊN GỢI NHỚ | Cột thông tin | Tên doanh nghiệp hoặc tên trang Zalo OA đã đăng ký xác thực. |
| CHỌN ZALO TOKEN CHO HỆ THỐNG CRM | Trạng thái | Biểu tượng tích xanh xác nhận token được chọn làm nguồn nhận diện dữ liệu chính cho CRM. |
| NGÀY TẠO | Cột thông tin | Thời điểm cấp phép ủy quyền token thành công. |
| THAO TÁC | Nút tác vụ | Nút xóa (thùng rác màu đỏ nhạt) để ngắt kết nối và gỡ bỏ token khỏi tổng đài. |
4. Hướng dẫn kết nối Zalo OA vào tổng đài ODS
ODS cung cấp ứng dụng ủy quyền được Zalo chứng thực, cho phép kết nối Zalo OA nhanh chóng mà không cần lập trình phức tạp:
Bước 1: Mở giao diện Thiết lập Zalo Token
- Từ thanh điều hướng bên trái của Portal, chọn Thiết lập nâng cao → Thiết lập Zalo Token.
- Bảng quản lý hiển thị các kết nối Zalo hiện có kèm nút thao tác thêm mới.
Bước 2: Mở luồng ủy quyền Zalo
- Tại góc trên bên phải màn hình, nhấp nút + THÊM MỚI ZALO màu xanh lá.
- Hệ thống tự động mở cửa sổ xác thực tài khoản của Zalo.
Bước 3: Đăng nhập và xác nhận cấp quyền
- Đăng nhập bằng tài khoản Quản trị viên của trang Zalo OA cần kết nối.
- Chọn trang Official Account tương ứng và nhấn Cho phép cấp các quyền truy cập cần thiết:
- Quản lý và gửi tin nhắn tư vấn khách hàng.
- Quản lý webhook nhận thông báo tin nhắn mới.
- Thực hiện và tiếp nhận cuộc gọi thoại qua Zalo OA.
Bước 4: Kích hoạt Zalo Token cho hệ thống CRM
- Sau khi ủy quyền thành công, dòng thông tin Zalo OA xuất hiện trong bảng danh sách.
- Nhấp chọn biểu tượng tích xanh tại cột CHỌN ZALO TOKEN CHO HỆ THỐNG CRM để kích hoạt luồng tiếp nhận tin nhắn và cuộc gọi cho doanh nghiệp.
Kết quả mong đợiTài khoản Zalo OA chuyển sang trạng thái sẵn sàng tiếp nhận tương tác đa kênh.
5. Kiểm tra kết quả
Doanh nghiệp xác nhận kết nối Zalo OA hoạt động chính xác qua các tiêu chí sau:
- Dòng token mới xuất hiện trong bảng danh sách tại
/advance-setting/zalo-tokenvới trạng thái tích xanh kích hoạt. - Dùng tài khoản cá nhân gửi một tin nhắn thử nghiệm đến trang Zalo OA của doanh nghiệp.
- Mở phân hệ Tin nhắn (
/chat) trên ODS Portal, xác nhận phiên chat mới xuất hiện tức thì với biểu tượng logo Zalo màu xanh. - Điện thoại viên gửi tin nhắn phản hồi thành công từ màn hình ODS và khách hàng nhận được nội dung trên ứng dụng Zalo cá nhân.
6. Xử lý sự cố thường gặp (Troubleshooting)
- Nguyên nhân: Mã truy cập (Access Token) của Zalo có thời hạn nhất định hoặc mật khẩu quản trị viên Zalo OA vừa bị thay đổi.
- Cách xử lý: Nhấp biểu tượng thùng rác màu đỏ tại cột THAO TÁC để xóa token cũ, sau đó nhấp + THÊM MỚI ZALO để thực hiện ủy quyền liên kết lại.
- Nguyên nhân: Tài khoản Zalo OA chưa đăng ký Gói Tăng trưởng trở lên hoặc tài khoản OA chưa hoàn tất xác thực doanh nghiệp.
- Cách xử lý: Kiểm tra trạng thái gói cước trên trang quản lý Zalo OA của doanh nghiệp. Nâng cấp lên từ Gói Tăng trưởng để mở khóa toàn bộ quyền tương tác tin nhắn qua API.
- Nguyên nhân: Chưa bật tích xanh tại cột CHỌN ZALO TOKEN CHO HỆ THỐNG CRM, hoặc tài khoản nhân viên chưa được phân quyền truy cập phân hệ Tin nhắn.
- Cách xử lý: Đảm bảo cột chọn token đã hiển thị tích xanh. Kiểm tra lại phân quyền tài khoản người dùng tại Người dùng → Danh sách người dùng.
7. Bài viết liên quan
Tổng quan tích hợp đa kênh
Tìm hiểu kiến trúc kết nối các kênh liên lạc vào tổng đài ODS.
Tích hợp Facebook Messenger
Hướng dẫn kết nối Fanpage Facebook với tổng đài ODS để quản lý tin nhắn tập trung.
Quản lý tin nhắn và cuộc gọi
Quy trình tiếp nhận và xử lý tương tác đa kênh của điện thoại viên.
Hợp nhất thông tin khách hàng
Cách liên kết hồ sơ khách hàng giữa Zalo, Facebook và số điện thoại.